Journal des traces du service de serveur de rapports
Les journaux de traces du serveur de rapports Reporting Services sont des fichiers texte ASCII qui contiennent des informations détaillées sur les opérations du service Report Server. Ce fichier contient des informations comme les opérations effectuées par le service web Report Server, le portail web et le traitement en arrière-plan. Le fichier de journal des traces comprend des informations redondantes qui sont consignées dans d’autres fichiers journaux, ainsi que des informations qui ne se trouvent nulle part ailleurs. Les informations du journal des traces sont utiles si vous déboguez une application qui inclut un serveur de rapports. Les informations sont également utiles si vous examinez un problème spécifique écrit dans le journal des événements ou le journal d’exécution. Par exemple, lors de la résolution des problèmes liés aux abonnements.
Où se trouvent les fichiers journaux de serveur de rapports ?
Les fichiers journaux des traces sont ReportServerService_<timestamp>.log et Microsoft.ReportingServices.Portal.WebHost_<timestamp>.log, et se trouvent dans le dossier suivant :
C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\LogFiles
Les journaux des traces sont créés quotidiennement, à partir de la première entrée ayant lieu après minuit (heure locale), et chaque fois que le service redémarre. L'horodateur est basé sur l'heure UTC (Coordinated Universal Time). Le fichier est au format EN-US. Par défaut, les journaux des traces sont limités à 32 mégaoctets et sont supprimés au bout de 14 jours.
Paramètres de configuration des traces
Le comportement du journal des traces est géré dans le fichier de configuration ReportingServicesService.exe.config. Le fichier de configuration se trouve dans le chemin d'accès de dossier suivant :
\Program Files\Microsoft SQL Server\MSRS13.<instance name>\Reporting Services\ReportServer\bin.
L’exemple suivant illustre la structure XML des paramètres RStrace . La valeur de DefaultTraceSwitch détermine le type d’information qui est ajouté au journal. À l’exception de l’attribut Components , les valeurs de RStrace sont identiques dans tous les fichiers de configuration.
\<system.diagnostics>
<switches>
<add name="DefaultTraceSwitch" value="3" />
</switches>
\</system.diagnostics>
<RStrace>
<add name="FileName" value="ReportServerService_" />
<add name="FileSizeLimitMb" value="32" />
<add name="KeepFilesForDays" value="14" />
<add name="Prefix" value="appdomain, tid, time" />
<add name="TraceListeners" value="file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all:3" />
</RStrace>
Le tableau suivant fournit des informations sur chaque paramètre.
| Paramètre | Description | Valeurs |
|---|---|---|
| RStrace | Spécifie les espaces de noms utilisés pour les erreurs et la trace. | |
| DefaultTraceSwitch | Spécifie le niveau des informations consignées dans le journal des traces ReportServerService. Chaque niveau comprend les informations signalées par tous les niveaux inférieurs. La désactivation des traces n’est pas recommandée. |
Les valeurs autorisées sont : 0 = Trace désactivée. Le fichier journal ReportServerService est activé par défaut. Pour le désactiver, définissez le niveau de trace à 0.1= Exceptions and restarts2= Exceptions, restarts, warnings3= Exceptions, restarts, warnings, status messages (valeur par défaut)4= Verbose mode |
| FileName | Spécifie la première partie du nom du fichier journal. La valeur spécifiée par Prefix complète le reste du nom. | |
| FileSizeLimitMb | Spécifie une taille maximale pour le journal de trace. La taille du fichier est exprimée en mégaoctets. Vous pouvez surveiller la taille du fichier en définissant des niveaux de trace (de 0 à 4) pour contrôler la quantité de contenu enregistrée. Vous pouvez également spécifier les composants faisant l'objet d'une trace. Si la taille maximale du fichier journal est atteinte avant le délai d’expiration de 14 jours, les entrées les plus anciennes sont remplacées par les nouvelles. |
Les valeurs valides vont de 0 à un entier maximal. La valeur par défaut est 32. Si vous spécifiez 0 ou un nombre négatif, le serveur de rapports considère que la valeur est égale à 1. |
| KeepFilesForDays | Spécifie le nombre de jours après lequel supprimer un journal des traces. | Les valeurs valides vont de 0 à un entier maximal. La valeur par défaut est 14. Si vous spécifiez 0 ou un nombre négatif, le serveur de rapports considère que la valeur est égale à 1. |
| Préfixe | Spécifie une valeur générée qui distingue une instance de journal d’une autre. | Par défaut, des valeurs d'horodatage sont ajoutées aux noms des journaux de trace. Cette valeur est définie sur appdomain, tid, time. Ne modifiez pas ce paramètre. |
| TraceListeners | Spécifie une cible de sortie du contenu du journal de trace. Vous pouvez spécifier plusieurs cibles ; dans ce cas, utilisez la virgule comme séparateur. | Les valeurs autorisées sont :DebugWindowFile (valeur par défaut)StdOut |
| TraceFileMode | Spécifie si les journaux de trace contiennent des données pour une période de 24 heures. Un seul journal de trace doit exister par composant et par jour. | Cette valeur est définie sur Unique (default). Ne modifiez pas cette valeur. |
| Catégorie de composant | Spécifie les composants pour lesquels les informations du journal des traces sont générées, ainsi que le niveau des traces, dans le format suivant :\<component category>:\<tracelevel>Vous pouvez spécifier l’ensemble ou une partie des composants (all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). Si vous ne voulez pas générer les informations relatives à un composant spécifique, désactivez les traces de ce composant (par exemple, « SemanticModelGenerator:0 »). Ne désactivez pas les traces pour tous. Vous pouvez définir « SemanticQueryEngine:4 » si vous voulez afficher les instructions Transact-SQL qui sont générées pour chaque requête sémantique. Les instructions Transact-SQL sont enregistrées dans le journal des traces. L'exemple suivant illustre le paramètre de configuration qui ajoute les instructions Transact-SQL au journal : <add name="Components" value="all,SemanticQueryEngine:4" /> |
Catégories de composants pouvant être définies : Le composant All est utilisé pour effectuer le suivi de l’activité générale du serveur de rapports pour tous les processus qui ne se retrouvent pas dans les catégories spécifiques. Le composantRunningJobs sert à effectuer le suivi d’une opération de rapport ou d’abonnement en cours. Le composant SemanticQueryEngine sert à effectuer le suivi d’une requête sémantique qui est traitée quand un utilisateur effectue une exploration de données ad hoc dans un rapport basé sur un modèle. Le composantSemanticModelGenerator est utilisé pour effectuer le suivi de la génération de modèle. Le composanthttp sert à activer le fichier journal HTTP Report Server. Pour plus d'informations, consultez Report Server HTTP Log. |
| Valeur trace level pour les catégories de composants | <catégorie de composant>:<niveau_trace> Si vous n’ajoutez pas de niveau de suivi au composant, la valeur spécifiée pour DefaultTraceSwitch est utilisée. Par exemple, si vous spécifiez all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator, tous les composants utilisent le niveau de trace par défaut. |
Valeurs valides pour le niveau de trace :0= Disables tracing1= Exceptions and restarts2= Exceptions, restarts, warnings3= Exceptions, restarts, warnings, status messages (valeur par défaut)4= Verbose modeLa valeur par défaut pour le serveur de rapports est : all:3. |
Ajouter un paramètre de configuration personnalisé destiné à spécifier l’emplacement des fichiers de vidage
Vous pouvez ajouter un paramètre personnalisé visant à définir l'emplacement que l’outil Dr Watson pour Windows utilise pour stocker les fichiers de vidage. Le paramètre personnalisé est Directory. L'exemple suivant illustre l'utilisation de ce paramètre de configuration dans la section RStrace :
<add name="Directory" value="U:\logs\" />
Pour plus d’informations, consultez l’article 913046 de la Base de connaissances sur le site Web de Microsoft.
Champs du fichier journal
Un journal des traces contient les champs suivants :
informations système, notamment le système d'exploitation, la version, le nombre de processeurs et la mémoire ;
Reporting Services ;
événements consignés dans le journal des applications ;
exceptions générées par le serveur de rapports ;
avertissements relatives aux ressources insuffisantes consignés par un serveur de rapports ;
enveloppes SOAP entrantes et enveloppes SOAP sortantes résumées ;
en-tête HTTP, trace de la pile et informations de suivi de débogage.
Vous pouvez consulter les informations du journal des traces pour déterminer si une remise de rapport s'est produite, qui a reçu le rapport et combien de tentatives de remises ont été effectuées. Les journaux de suivi enregistrent également l'activité d'exécution des rapports et les variables d'environnement qui sont en vigueur pendant le traitement des rapports. Les erreurs et les exceptions sont également consignées dans les journaux de suivi. Par exemple, vous pouvez trouver des erreurs de délai d’attente pour des rapports (indiquées par une entrée ThreadAbortExceptions).
Versions précédentes
Dans les versions antérieures de Reporting Services, il existait plusieurs fichiers journaux des traces, un pour chaque application. Les fichiers suivants sont obsolètes et ne sont plus créés dans SQL Server 2008 (10.0.x) et les versions ultérieures :
+ ReportServerWebApp_\<timestamp>.log
+ ReportServer_\<timestamp>.log
+ ReportServerService_main_\<timestamp>.log