Log di traccia di Reporting Services
I log di traccia contengono informazioni molto dettagliate sulle operazioni del server di report. Contengono informazioni ridondanti, che vengono registrate in altri file di log, e informazioni aggiuntive, non disponibili altrove. I log di traccia sono utili se si esegue il debug di un'applicazione che include un server di report o se occorre risolvere un problema specifico che è stato registrato nel log eventi o nel log di esecuzione.
I log di traccia vengono creati quotidianamente, a partire dalla prima voce registrata dopo la mezzanotte (ora locale). Il nome di file del log di traccia viene derivato dall'ora locale del computer. Per impostazione predefinita, i log di traccia possono occupare uno spazio massimo di 32 MB e vengono eliminati dopo 14 giorni.
Posizione dei log di traccia
In SQL Server Reporting Services sono disponibili quattro log di traccia nel percorso \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles. Tali log sono descritti nella tabella seguente.
| Nome file di log | Descrizione |
|---|---|
ReportServerService_<timestamp>.log |
Log di traccia per i thread di lavoro del servizio Windows ReportServer. |
ReportServerService_main_<timestamp>.log |
Log di traccia per i thread di gestione del servizio Windows ReportServer. |
ReportServerWebApp_<timestamp>.log |
Log di traccia per Gestione report. |
ReportServer_<timestamp>.log |
Log di traccia per il servizio Web ReportServer. |
Visualizzazione delle informazioni dei log di traccia
I log di traccia sono file di testo e per visualizzarli è possibile utilizzare qualsiasi editor di testo. Nei log di traccia sono disponibili le informazioni seguenti:
- Informazioni sul sistema, quali il sistema operativo, la versione, il numero di processori e la memoria.
- Informazioni sui componenti di Reporting Services e sulla versione.
- Eventi registrati nel registro applicazioni.
- Eccezioni generate dal server di report.
- Avvisi di risorse insufficienti registrati da un server di report.
- Buste SOAP in ingresso e buste SOAP in uscita riepilogate.
- Informazioni sull'intestazione HTTP, sulla traccia dello stack e sulla traccia di debug.
Esaminando i log di traccia è possibile stabilire se ha avuto luogo un recapito di report, chi ha ricevuto il report e quanti tentativi di recapito sono stati eseguiti. Nei log di traccia vengono inoltre registrati l'attività di esecuzione del report e le variabili di ambiente attive durante l'elaborazione del report, nonché gli errori e le eccezioni. È possibile, ad esempio, trovare errori di timeout del report, segnalati dalla voce ThreadAbortExceptions.
Impostazione dei livelli di traccia
I livelli di traccia vengono specificati tramite le impostazioni DefaultTraceSwitch e RSTrace. Ogni componente archivia le impostazioni dei livelli di traccia in file di configurazione diversi. Per controllare la quantità di informazioni registrate in ogni file di log, è necessario modificare le impostazioni nel file di configurazione appropriato.
| Nome del file di log del componente | File di configurazione che contiene le impostazioni di traccia |
|---|---|
ReportServerService_<timestamp>.log e ReportServerService_main_<timestamp>.log |
File ReportingServicesService.config. Per ulteriori informazioni, vedere File di configurazione ReportingServicesService. Le modifiche apportate al file di configurazione vengono applicate al riavvio del servizio Windows. |
ReportServerWebApp_<timestamp>.log |
File Web.config per Gestione report, disponibile nella cartella Programmi\SQL Server\MSSQL.n\Reporting Services\ReportManager. Le modifiche apportate al file di configurazione vengono applicate immediatamente. |
ReportServer_<timestamp>.log |
File Web.config per il servizio Web ReportServer, disponibile nella cartella Programmi\SQL Server\MSSQL.n\Reporting Services\ReportServer. Le modifiche apportate al file di configurazione vengono applicate immediatamente. |
Impostazioni RStrace
Nell'esempio seguente viene illustrata la struttura XML delle impostazioni RStrace. Il valore di DefaultTraceSwitch determina il tipo di informazioni aggiunte al log. Con l'eccezione dell'attributo Components, i valori per RStrace sono uguali in tutti i file di configurazione. Per l'attributo Components esiste un set diverso di valori validi per il file Web.config del servizio ReportServer. La tabella in questa sezione illustra i valori validi per tale attributo.
<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>
Nella tabella seguente sono incluse informazioni su ogni impostazione.
| Impostazione | Descrizione |
|---|---|
RStrace |
Specifica gli spazi dei nomi utilizzati per errori e traccia. |
DefaultTraceSwitch |
Specifica il livello delle informazioni da includere nel log di traccia ReportServerService. Ogni livello include anche le informazioni raccolte da tutti i livelli inferiori. Non è consigliabile disattivare la funzionalità di traccia. I valori validi sono: 0= Disattiva la funzionalità di traccia 1= Eccezioni e riavvii 2= Eccezioni, riavvii, avvisi 3= Eccezioni, riavvii, avvisi, messaggi di stato (valore predefinito) 4= Modalità dettagliata |
FileName |
Specifica la prima parte del nome file di log. Il resto del nome viene completato con il valore specificato da Prefix. |
FileSizeLimitMb |
Specifica il limite massimo per le dimensioni del log di traccia. Il file è misurato in megabyte. I valori validi sono compresi tra 0 e il valore integer massimo. Il valore predefinito è 32. Se si specifica 0 o un numero negativo, il server di report lo considera come 1. |
KeepFilesForDays |
Specifica dopo quanti giorni un file di log di traccia viene eliminato. I valori validi sono compresi tra 0 e il valore integer massimo. Il valore predefinito è 14. Se si specifica 0 o un numero negativo, il server di report lo considera come 1. |
Prefix |
Specifica un valore generato che distingue ogni istanza del log dalle altre. Per impostazione predefinita, ai nomi di file dei log di traccia vengono aggiunti valori timestamp. Questo valore è impostato su "tid, time". Non modificare questa impostazione. |
TraceListeners |
Specifica una destinazione per l'output del contenuto del log di traccia. È possibile specificare più destinazioni, separandole con una virgola. I valori validi sono: DebugWindow (valore predefinito) File (valore predefinito) StdOut |
TraceFileMode |
Specifica se i log di traccia devono contenere dati per un periodo di 24 ore. È consigliabile utilizzare un solo log di traccia al giorno per ogni componente. Questo valore è impostato su "Unique" (valore predefinito). Non modificare questo valore. |
Components |
Specifica i componenti per i quali vengono generate informazioni nel log di traccia e il livello di traccia. I valori validi sono diversi per i vari file di configurazione: Nei file ReportServerService.exe.config e Web.config per Gestione report: Il valore predefinito è all. Anche i nomi dei componenti interni sono valori validi per questa impostazione. Non modificare questo valore in questi file di configurazione. Nel file Web.config per il servizio ReportServer: Il valore predefinito è "all,RunningJobs:3,SemanticQueryEngine:2,SemanticModelGenerator:2". I valori validi per Components in questo file Web.config includono un elenco delimitato da virgole di componenti e il livello di traccia per ogni componente, in cui 0=disattiva la funzionalità di traccia, 1=eccezioni e riavvii, 2=eccezioni, riavvii, avvisi, 3=eccezioni, riavvii, avvisi, messaggi di stato (valore predefinito), 4=modalità dettagliata.
È possibile specificare tutti i componenti o solo alcuni (all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). Se non si desidera generare informazioni per un componente specifico, è possibile disattivare la traccia per tale componente (ad esempio "SemanticModelGenerator:0"). Non disattivare la funzionalità di traccia per il componente all. Se non si aggiunge il livello di traccia dopo il nome del componente, verrà utilizzato il valore specificato per DefaultTraceSwitch. Ad esempio, se si specifica "all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator", per tutti i componenti verrà utilizzato il livello di traccia predefinito. È possibile impostare "SemanticQueryEngine:4" se si desidera visualizzare le istruzioni Transact-SQL che vengono generate per ogni query semantica. Le istruzioni Transact-SQL vengono registrate nel log di traccia. Nell'esempio seguente viene illustrata l'impostazione di configurazione per l'aggiunta delle istruzioni Transact-SQL al log: <add name="Components" value="all,SemanticQueryEngine:4" /> |
Aggiunta di un'impostazione di configurazione personalizzata per specificare il percorso del file di dump
È possibile aggiungere un'impostazione personalizzata per definire la directory di archiviazione utilizzata dallo strumento Dr. Watson per Windows per i file di dump. L'impostazione personalizzata è Directory. Nell'esempio seguente viene illustrato come specificare questa impostazione di configurazione nella sezione RStrace:
<add name="Directory" value="U:\logs\" />
Per ulteriori informazioni, vedere l'articolo della Knowledge Base 913046 nel sito Web Microsoft.
Vedere anche
Concetti
File di log di Reporting Services
Altre risorse
Errori ed eventi di Reporting Services
Risoluzione dei problemi relativi a Reporting Services