Journaux de suivi de Reporting Services
Les journaux des traces contiennent des informations extrêmement détaillées sur les opérations de serveur de rapports. Ils comprennent des informations redondantes, également consignées dans d'autres fichiers journaux, ainsi que des informations qui ne se trouvent nulle part ailleurs. Les journaux de suivi sont utiles si vous déboguez une application qui contient un serveur de rapports ou si vous essayez de déterminer l'origine d'un problème consigné dans le journal des événements ou d'exécution.
Les journaux de suivi sont créés quotidiennement, en commençant par la première entrée qui se produit après minuit (heure locale). Le nom du fichier des traces est dérivé de l'heure locale de l'ordinateur. Par défaut, les journaux des traces sont limités à 32 mégaoctets et sont supprimés après 14 jours.
Emplacement des journaux de suivi
SQL Server Reporting Services fournit quatre fichiers journaux situés dans \Microsoft SQL Server\<Instance SQL Server>\Reporting Services\LogFiles. Ils sont décrits dans le tableau ci-dessous.
| Nom du fichier journal | Description |
|---|---|
ReportServerService_<horodatage>.log |
Journal des traces des threads de travail du service Report Server Windows. |
ReportServerService_main_<horodatage>.log |
Journal des traces des threads de gestion du service Report Server Windows. |
ReportServerWebApp_<horodatage>.log |
Journal de suivi du Gestionnaire de rapports. |
ReportServer_<horodatage>.log |
Journal des traces du service Web Report Server. |
Affichage des informations des journaux
Les journaux de suivi sont des fichiers texte. Vous pouvez les afficher dans n'importe quel éditeur de texte. Un journal de suivi contient les informations suivantes :
- informations système, notamment le système d'exploitation, la version, le nombre de processeurs et la mémoire ;
- informations sur la version et les composants de Reporting Services ;
- événements consignés dans le journal d'application ;
- 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 journaux de suivi 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 des rapports (indiquées comme entrée ThreadAbortExceptions).
Définition des niveaux de trace
Les niveaux des traces sont spécifiés à l'aide des paramètres DefaultTraceSwitch et RSTrace. Chaque composant stocke les paramètres de niveau des traces dans des fichiers de configuration différents. Pour contrôler la quantité des informations enregistrées dans chaque fichier journal, vous devez modifier les paramètres dans le fichier de configuration approprié.
| Nom du fichier journal du composant | Fichier de configuration contenant les paramètres des traces |
|---|---|
ReportServerService_<horodatage>.log et ReportServerService_main_<horodatage>.log |
Fichier ReportingServicesService.config. Pour plus d'informations, consultez Fichier de configuration ReportingServicesService. Les modifications apportées au fichier de configuration ne prennent effet qu'au redémarrage du service Windows. |
ReportServerWebApp_<horodatage>.log |
Fichier Web.config du Gestionnaire de rapports, situé dans le dossier Program Files\SQL Server\MSSQL.n\Reporting Services\ReportManager. Les modifications apportées au fichier de configuration prennent effet immédiatement. |
ReportServer_<horodatage>.log |
Fichier Web.config du service Web Report Server, situé dans le dossier Program Files\SQL Server\MSSQL.n\Reporting Services\ReportServer. Les modifications apportées au fichier de configuration prennent effet immédiatement. |
Paramètres RStrace
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. L'attribut Components possède un ensemble différent de valeurs valides pour le fichier Web.config de Report Server. Le tableau de cette section indique les valeurs valides de cet attribut.
<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="tid, time" />
<add name="TraceListeners" value="debugwindow, file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all" />
</RStrace>
Le tableau suivant fournit des informations sur chaque paramètre.
| Paramètre | Description |
|---|---|
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 de trace de ReportServerService. Chaque niveau comprend les informations signalées par tous les niveaux inférieurs. La désactivation de la trace n'est pas recommandée. Les valeurs valides sont : 0= Trace désactivée 1= Exceptions et redémarrages 2= Exceptions, redémarrages, avertissements 3= Exceptions, redémarrages, avertissements, messages d'état (par défaut) 4= Mode commenté |
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. 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 de trace. 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. |
Prefix |
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 des traces. Cette valeur est définie sur « tid, time ». Ne modifiez pas ce paramètre. |
TraceListeners |
Spécifie une cible de sortie du contenu du journal des traces. Vous pouvez spécifier plusieurs cibles ; dans ce cas, utilisez la virgule comme séparateur. Les valeurs valides sont : DebugWindow (par défaut) File (par défaut) StdOut |
TraceFileMode |
Spécifie si les journaux des traces contiennent des données pour une période de 24 heures. Un seul journal des traces doit exister par composant et par jour. Cette valeur est définie sur « Unique » (par défaut). Ne modifiez pas cette valeur. |
Components |
Spécifie les composants pour lesquels les informations des journaux des traces sont générées ainsi que le niveau des traces. Les valeurs valides varient d'un fichier de configuration à l'autre : Dans les fichiers ReportServerService.exe.config et Web.config du Gestionnaire de rapports : La valeur par défaut est all. Ce paramètre accepte aussi comme valeur les noms de composants internes. Ne modifiez pas cette valeur dans ces fichiers de configuration. Dans le fichier Web.config de Report Server : La valeur par défaut est « all,RunningJobs:3,SemanticQueryEngine:2,SemanticModelGenerator:2 ». Les valeurs valides de Components dans le fichier Web.config incluent une liste séparée par des virgules des composants et du niveau des traces de chaque composant, où 0= Trace désactivée, 1= Exceptions et redémarrages, 2= Exceptions, redémarrages, avertissements, 3= Exceptions, redémarrages, avertissements, messages d'état (par défaut), 4= Mode commenté.
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 du composant all. Si vous n'ajoutez pas de niveau des traces 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 des traces par défaut. 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" /> |
Ajout d'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. Ce 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 (KB) Microsoft sur le site Web Microsoft.
Voir aussi
Concepts
Fichiers journaux de Reporting Services
Autres ressources
Erreurs et événements de Reporting Services
Dépannage de Reporting Services