Attivazione dell'analisi a livello di applicazione

  • Articolo

È possibile attivare la funzione di analisi per un'intera applicazione nel file Web.config della directory principale dell'applicazione. Per impostazione predefinita, l'analisi a livello di applicazione può essere visualizzata solo sul computer server Web locale. Per rendere l'analisi a livello di applicazione visibile su computer remoti, è necessario impostare l'attributo localOnly su false nel file Web.config.

Attenzione   Per ragioni di protezione, utilizzare la funzionalità di analisi remota solo durante lo sviluppo o la distribuzione di un'applicazione Web. Accertarsi di disattivarla prima di trasferire l'applicazione su server Web di produzione. Per disattivare l'analisi remota, impostare l'attributo localOnly su true nel file Web.config.

Nell'esempio che segue viene mostrata una configurazione di analisi di un'applicazione che consente di raccogliere informazioni per un massimo di 40 richieste e consente ai browser di computer diversi dal server di origine di visualizzare le informazioni raccolte.

<configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

Quando si attiva la funzione di analisi per un'applicazione, vengono raccolte informazioni di analisi per ogni richiesta all'applicazione, fino al numero massimo di richieste specificato. Il numero predefinito di richieste è 10. Quando il visualizzatore di analisi raggiunge il limite di richieste, l'archiviazione delle richieste di analisi viene interrotta.

Nota   Quando si attiva la funzione di analisi per un'intera applicazione nel file Web.config, verranno raccolte ed elaborate le informazioni di analisi per ogni pagina dell'applicazione. Per disattivare la funzione di analisi per una pagina specifica, impostare l'attributo Trace su false nella direttiva @ Page di quella pagina. Qualsiasi istruzione TraceContext.Write o TraceContext.Warn inserita nel codice di una pagina verrà archiviata e restituita esclusivamente al visualizzatore di analisi.

Se si desidera che le informazioni di analisi vengano visualizzate alla fine della pagina a cui sono associate, impostare l'attributo pageOutput su true nella sezione di configurazione dell'analisi, nel file Web.config. Se si desidera che le informazioni di analisi vengano visualizzate esclusivamente nel visualizzatore di analisi, impostare questo attributo su false. Se si attiva l'analisi a livello di applicazione ma si desidera che non vengano visualizzate informazioni di analisi per alcune pagine dell'applicazione, utilizzare la direttiva @ Page per impostare l'attributo Trace su false per le pagine in cui non si desidera visualizzare le informazioni.

Per ulteriori informazioni sulla configurazione dell'applicazione ASP.NET, vedere Configurazione di ASP.NET.

Qui di seguito sono elencati gli attributi che è possibile utilizzare per modificare il funzionamento dell'analisi a livello di applicazione.

Attributo Descrizione
enabled true se è attivata la funzione di analisi per l'applicazione, false in caso contrario. Il valore predefinito è false.
pageOutput true se le informazioni di analisi vengono visualizzate sia nelle pagine dell'applicazione che nell'utilità di analisi axd, false in caso contrario. Il valore predefinito è false.
Nota   Questa impostazione non ha effetto sulle pagine per cui è attiva la funzione di analisi.
requestLimit Numero di richieste di analisi da archiviare nel server. Il valore predefinito è 10.
traceMode Indica se le informazioni di analisi vengono visualizzate nell'ordine in cui vengono elaborate (SortByTime) oppure in ordine alfabetico in base a una categoria definita dall'utente (SortByCategory). Il valore predefinito è SortByTime.
localOnly true se il visualizzatore di analisi Trace.axd è disponibile solo nel server Web host, false in caso contrario. L'impostazione predefinita è true.

Per attivare l'analisi per un'applicazione

  1. Se non è già stato fatto, creare un file di testo, denominarlo Web.config e salvarlo nella directory principale dell'applicazione.

  2. Tra i tag di apertura e di chiusura dell'elemento <configuration>, aggiungere i tag di apertura e di chiusura di un elemento <system.web>.

  3. Tra i tag dell'elemento <system.web> aggiungere un elemento <trace> che si chiude autonomamente.

  4. Nell'elemento <trace> dichiarare l'attributo enabled e impostarlo su true.

  5. Dichiarare altri attributi facoltativi per modificare il funzionamento dell'analisi dell'applicazione secondo le proprie esigenze.

    Nell'esempio che segue viene mostrata una configurazione di analisi di un'applicazione che consente di raccogliere informazioni di analisi per un massimo di 40 richieste e consente ai browser di computer diversi dal server di origine di visualizzare le informazioni raccolte.

    <configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

    Nota   Per il sistema di configurazione di ASP.NET la distinzione tra maiuscole e minuscole è rilevante. Tutte le sezioni di configurazione composte da un'unica parola sono in lettere minuscole, mentre le sezioni o gli attributi composti da concatenazioni di due parole devono includere lettere maiuscole all'interno delle parole. Il nome di attributo requestLimit, ad esempio, è corretto, mentre requestlimit genera un errore di analisi.

Visualizzazione delle informazioni di analisi con il visualizzatore di analisi

Dopo aver attivato la funzione di analisi per l'applicazione, quando verrà richiesta una pagina dell'applicazione verranno eseguite le istruzioni di analisi in essa contenute. È possibile visualizzare tali istruzioni e le ulteriori informazioni di analisi nel visualizzatore di analisi richiedendo Trace.axd dalla directory principale dell'applicazione.

Nota   Quando si attiva la funzione di analisi per un'applicazione, se si imposta l'attributo pageOutput su true nel file Web.config, sarà possibile visualizzare le informazioni e le istruzioni di analisi relative a tutte le pagine dell'applicazione.

Il visualizzatore di analisi consente di scegliere una richiesta specifica dalle pagine che sono state richieste dall'applicazione. Nella schermata che segue viene mostrato un visualizzatore di analisi che ha rilevato sette richieste per la propria applicazione da quando è stata attivata la funzione di analisi.

Visualizzatore di analisi

Se a un'applicazione per la quale è stata attivata la funzione di analisi pervengono più richieste, nel visualizzatore di analisi le richieste verranno elencate nell'ordine in cui sono state elaborate. Le informazioni sulla pagina di apertura del visualizzatore di analisi includono l'ora della richiesta, il file richiesto, il codice di stato della richiesta, il verbo HTTP associato alla richiesta e un collegamento Visualizza dettagli che consente di visualizzare informazioni più dettagliate sulla richiesta. Il numero di richieste visualizzate non sarà maggiore dell'impostazione di requestLimit specificata nel file Web.config.

Per visualizzare dettagli di analisi per una richiesta specifica

  1. Passare al visualizzatore di analisi associato alla propria applicazione.

    Se, ad esempio, l'URL di un'applicazione è https://localhost/miaapplicazione/ per visualizzare le relative statistiche di analisi, passare a https://localhost/miaapplicazione/trace.axd.

  2. Selezionare il collegamento Visualizza dettagli della richiesta che si desidera analizzare.

    Una volta selezionato Visualizza dettagli, verranno visualizzate le stesse informazioni aggiunte alla pagina per cui era stata attivata la funzione di analisi.

Talvolta è consigliabile rimuovere tutte le richieste archiviate nel visualizzatore di analisi. È possibile infatti che si desideri tenere traccia delle modifiche apportate ai file nell'applicazione oppure semplicemente visualizzare le informazioni in file non associati alle richieste attualmente visualizzate.

Per eliminare le richieste dal visualizzatore di analisi

  1. Passare al visualizzatore di analisi associato all'applicazione.

  2. Fare clic sul collegamento cancella analisi corrente per rimuovere tutte le richieste archiviate nel visualizzatore di analisi.

    Nota   Il visualizzatore di analisi riporterà informazioni relative alle sole richieste eseguite dopo la cancellazione del log. Non è possibile visualizzare le richieste eseguite dopo che è stato raggiunto il numero limite e prima della cancellazione del log.

Vedere anche

Enumerazione TraceModeEnum | Analisi di ASP.NET| Schema delle impostazioni ASP.NET | Attivazione dell'analisi per una pagina