Log HTTP del server di report

  • Articolo

Nel file di log HTTP del server di report viene mantenuto un record per ogni richiesta HTTP e relativa risposta gestite dal server di report. Poiché gli errori di overflow e di timeout relativi alle richiesta ed errori non raggiungono il server di report, non vengono registrati nel file di log.

Per impostazione predefinita, la registrazione HTTP non è abilitata. Per utilizzare questa caratteristica nella propria installazione, è necessario modificare il file di configurazione ReportingServicesService.exe.

Visualizzare informazioni sul log

Il log è un file di testo ASCII, che può essere visualizzato mediante qualsiasi editor di testo. Il file di log HTTP del server di report è equivalente al file di log esteso W3C presente in IIS e utilizza campi simili ed è pertanto possibile utilizzare visualizzatori del file di log di IIS esistenti per leggerlo. Nella tabella seguente vengono fornite informazioni aggiuntive sul file di log HTTP:

Informazioni sul file di log Descrizione
File name Per impostazione predefinita, il nome file è ReportServerService_HTTP_\<timestamp>.log: È possibile personalizzare il prefisso del nome file modificando l'attributo HttpTraceFileName nel file ReportingServicesService.exe.config. Il timestamp si basa su l'ora UTC (Coordinated Universal Time).
Percorso del file Il file si trova in \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles.
Formato di file Il file è in formato en-US È un file di testo ASCII.
Creazione e memorizzazione del file Per creare un log HTTP, è necessario innanzitutto riabilitarlo nel file di configurazione e riavviare il servizio. Il file viene quindi creato quando il server di report gestisce una richiesta HTTP. Se le impostazioni sono state configurate ma il file di log non viene visualizzato, aprire un report o avviare un'applicazione del server di report ad esempio il portale Web. Questa azione genera una richiesta HTTP per creare il file.

Una nuova istanza del file di log viene creata dopo ogni riavvio del servizio e ogni successiva richiesta HTTP al server di report.

Per impostazione predefinita, i log di traccia possono occupare uno spazio massimo di 32 MB e vengono eliminati dopo 14 giorni.

Impostazioni di configurazione per il log HTTP del server di report

Per configurare il log HTTP del server di report, utilizzare Blocco note per modificare il file ReportingServicesService.exe.config. Il percorso del file di configurazione è \Programmi\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin.

Per abilitare il server HTTP, è necessario aggiungere http:4 alla sezione del RStrace file config ReportingServicesService.exe. Tutte le altre voci del file di log HTTP sono facoltative. Nell'esempio seguente sono incluse tutte le impostazioni in modo che sia possibile incollare la sezione intera sulla sezione RStrace e successivamente eliminare le impostazioni non necessarie.

   <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="HttpTraceFileName" value="ReportServerService_HTTP_" />  
         <add name="HttpTraceSwitches" value="date,time,clientip,username,serverip,serverport,host,method,uristem,uriquery,protocolstatus,bytesreceived,timetaken,protocolversion,useragent,cookiereceived,cookiesent,referrer" />  
         <add name="Components" value="all:3,http:4" />  
   </RStrace>

Campi del file di log

Nella tabella seguente vengono descritti i campi procedure disponibili nel log. L'elenco di campi è configurabile ed è possibile specificare i campi da includere tramite l'impostazione di configurazione HTTPTraceSwitches . La colonna Default specifica se il campo viene incluso automaticamente nel file di log se non si specifica HTTPTraceSwitches.

Campo Descrizione Default
HttpTraceFileName Questo valore è facoltativo. Il valore predefinito è ReportServerServiceHTTP_. È possibile specificare un valore diverso se si vuole usare una convenzione di denominazione dei file diversa. Ad esempio, è possibile scegliere di includere il nome del server se si salvano i file di log in una posizione centrale. Sì
HTTPTraceSwitches Questo valore è facoltativo. Se lo si specifica, è possibile configurare i campi utilizzati nel file di log in formato delimitato da virgole. No
Data Data di esecuzione dell'attività. No
Tempistica Ora di esecuzione dell'attività. No
ClientIp Indirizzo IP del client che ha eseguito l'accesso al server di report. Sì
UserName Nome dell'utente che ha eseguito l'accesso al server di report. No
ServerIp Indirizzo IP utilizzato per la connessione. No
ServerPort Numero della porta utilizzata per la connessione. No
Host Contenuto dell'intestazione host. No
metodo Azione o metodo SOAP chiamato dal client. Sì
UriStem Risorsa cui è stato eseguito l'accesso. Sì
UriQuery Query utilizzata per accedere alla risorsa. No
ProtocolStatus Codice di stato HTTP. Sì
BytesReceived Numero di byte ricevuti dal server. No
TimeTaken Tempo (in millisecondi) dall'istante in cui HTTP.SYS restituisce i dati della richiesta fino al momento in cui il server completa l'ultimo invio, ad eccezione del tempo di trasmissione della rete. No
ProtocolVersion Versione del protocollo utilizzata dal client. No
UserAgent Tipo di browser utilizzato dal client. No
CookieReceived Contenuto del cookie ricevuto dal server. No
CookieSent Contenuto del cookie inviato dal server. No
Referrer Sito precedente visitato dal client. No

Contenuto correlato