Configurare la diagnostica per Servizi cloud di Azure (supporto esteso) e macchine virtuali

Nota

Questo articolo si applica ad Azure Servizi cloud di Azure (supporto esteso). I servizi cloud (versione classica) sono stati ritirati a partire dal 31 agosto 2024. Per ulteriori informazioni, consultare il modello di distribuzione dei servizi cloud (versione classica) che sarà ritirato il 31 agosto 2024. Per un nuovo sviluppo, è consigliabile usare un tipo di servizio più recente progettato per scopi specifici, ad esempio servizio app di Azure, Funzioni di Azureo app contenitore di Azure. Per l'elenco più recente dei servizi disponibili, vedere Directory dei prodotti Azure.

Quando è necessario risolvere i problemi relativi a un servizio o a una macchina virtuale di Servizi cloud di Azure (supporto esteso), è possibile usare Visual Studio per configurare più facilmente Diagnostica di Azure. La diagnostica acquisisce i dati di sistema e i dati di registrazione nelle macchine virtuali e nelle istanze di macchine virtuali che eseguono il servizio cloud. I dati di diagnostica vengono trasferiti a un account di archiviazione scelto. Per altre informazioni sulla registrazione diagnostica in Azure, vedere Abilitare la registrazione diagnostica per le app Web nel servizio app di Azure.

In questo articolo viene illustrato come usare Visual Studio per attivare e configurare Diagnostica di Azure. Informazioni su come configurare La diagnostica in macchine virtuali di Azure, su come selezionare i tipi di informazioni di diagnostica da raccogliere e su come visualizzare le informazioni dopo la raccolta.

Per configurare Diagnostica di Azure, modificare le impostazioni nella finestra di dialogo di configurazione di diagnostica in Visual Studio. Le impostazioni vengono salvate in un file denominato diagnostics.wadcfgx. È anche possibile modificare direttamente il file di configurazione. Se si aggiorna manualmente il file, le modifiche alla configurazione diventano effettive alla successiva distribuzione del servizio cloud in Azure o all'esecuzione del servizio nell'emulatore.

Avvertimento

In Visual Studio 2022, l'emulatore di archiviazione di Azure deprecato è stato sostituito con l'emulatore Azurite durante il debug dei progetti del servizio cloud. Questo emulatore Azurite non funziona con il plug-in Diagnostica di Azure, che fornisce il supporto per Diagnostica di Azure durante l'esecuzione e il test in locale. Se è necessario il plug-in per scenari di esecuzione e test locali, è possibile aggiornare la stringa di connessione nella configurazione del servizio locale (.cscfg) in un account di archiviazione di Azure (vedere Gestire le stringhe di connessione per gli account di archiviazione) oppure scaricare il precedente emulatore di Archiviazione di Azure. Nella versione 17.10 di Visual Studio, il plug-in Diagnostica locale di Azure è deprecato e disabilitato per impostazione predefinita, ma è possibile abilitarlo in tale versione. Il plug-in è stato rimosso in Visual Studio 17.11. Questo plug-in è stato usato solo con l'emulatore di calcolo di Azure locale e la disabilitazione non influisce sui servizi cloud distribuiti che usano l'estensione Diagnostica di Azure in Azure. Per abilitare il plug-in di diagnostica in Visual Studio 17.10, aggiungere l'impostazione della proprietà seguente a qualsiasi PropertyGroup nel file di progetto: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Come Visual Studio determina l'account di archiviazione di diagnostica

• Se nel file di .cscfg viene specificata una stringa di connessione di diagnostica, Visual Studio lo usa per configurare l'estensione di diagnostica durante la pubblicazione e quando genera i file XML di configurazione pubblici durante la creazione del pacchetto.
• Se nel file di .cscfg non viene specificata una stringa di connessione di diagnostica, Visual Studio torna all'uso dell'account di archiviazione specificato nel file .wadcfgx per configurare l'estensione di diagnostica per la pubblicazione e per generare i file XML di configurazione pubblica durante la creazione del pacchetto.
• La stringa di connessione di diagnostica nel file di .cscfg ha la precedenza sull'account di archiviazione nel file .wadcfgx. Se nel file di .cscfg viene specificata una stringa di connessione di diagnostica, Visual Studio usa tale stringa di connessione e ignora l'account di archiviazione in .wadcfgx.

Cosa fa la casella di controllo "Aggiorna stringhe di connessione di archiviazione per lo sviluppo..."?

La casella di controllo Aggiornare le stringhe di connessione dell'archiviazione di sviluppo per diagnostica e memorizzazione nella cache con le credenziali dell'account di archiviazione di Microsoft Azure durante la pubblicazione in Microsoft Azure è un modo pratico per aggiornare le stringhe di connessione dell'account di archiviazione di sviluppo con l'account di archiviazione di Azure specificato durante la pubblicazione. Quando si pubblica il progetto in Azure, Visual Studio aggiorna automaticamente la stringa di connessione di diagnostica con l'account di archiviazione specificato nella procedura guidata di pubblicazione. Tuttavia, se un account di archiviazione reale è stato specificato come stringa di connessione di diagnostica, tale account viene invece usato.

Configurare le fonti dati di diagnostica

Dopo aver abilitato la raccolta dati di diagnostica, è possibile scegliere esattamente quali origini dati raccogliere e quali informazioni vengono raccolte. Le sezioni successive descrivono le schede nella finestra di dialogo di configurazione diagnostica e il significato di ogni opzione di configurazione.

Log delle applicazioni

I log applicazioni dispongono di informazioni di diagnostica prodotte da un'applicazione Web. Per acquisire i log dell'applicazione, selezionare la casella di controllo Abilita trasferimento dei log dell'applicazione. Per aumentare o ridurre l'intervallo tra il trasferimento dei log delle applicazioni nell'account di archiviazione, cambiare il valore periodo di trasferimento (min). È anche possibile modificare la quantità di informazioni acquisite nel registro impostando il valore del livello di . Ad esempio, selezionare Verboso per ottenere più informazioni oppure selezionare Critico per acquisire solo errori critici. Se si dispone di un provider di diagnostica specifico che genera i log dell'applicazione, è possibile acquisire i log aggiungendo l'identificatore univoco globale (GUID) del provider nella casella GUID provider.

Per ulteriori informazioni sui log delle applicazioni, vedere Abilitare la registrazione diagnostica per le app Web in Azure App Service.

Registri eventi di Windows

Per acquisire i registri eventi di Windows, selezionare la casella di controllo Abilita trasferimento dei registri eventi di Windows. Per aumentare o ridurre l'intervallo tra il trasferimento dei registri eventi sul tuo account di archiviazione, modificare il valore periodo di trasferimento (min). Selezionare le caselle di controllo per i tipi di eventi da tenere traccia.

Se si desidera specificare un'origine dati personalizzata, immetterla nella casella di testo <Nome origine dati> e quindi selezionare Aggiungi. L'origine dati viene aggiunta al file diagnostics.cfcfg.

Contatori delle prestazioni

Le informazioni sul contatore delle prestazioni consentono di identificare i colli di bottiglia del sistema e ottimizzare le prestazioni del sistema e delle applicazioni. Per altre informazioni, vedere Creare e usare contatori delle prestazioni in un'applicazione azure. Per acquisire i contatori delle prestazioni, selezionare la casella di controllo Abilita trasferimento dei contatori delle prestazioni. Per aumentare o ridurre l'intervallo tra il trasferimento dei registri eventi nell'account di archiviazione, modificare il valore Periodo di Trasferimento (min). Selezionare le caselle di controllo per i contatori delle prestazioni da tenere traccia.

Per tenere traccia di un contatore delle prestazioni non elencato, immettere il contatore delle prestazioni usando la sintassi suggerita. quindi selezionare Aggiungi. Il sistema operativo nella macchina virtuale determina quali contatori delle prestazioni è possibile tenere traccia. Per altre informazioni sulla sintassi, vedere Specificare un percorso contatore.

Log dell'infrastruttura

I log dell'infrastruttura contengono informazioni sull'infrastruttura di diagnostica di Azure, sul modulo RemoteAccess e sul modulo RemoteForwarder. Per raccogliere informazioni sui log dell'infrastruttura, selezionare la casella di controllo Abilita trasferimento dei log dell'infrastruttura. Per aumentare o ridurre l'intervallo tra il trasferimento dei log dell'infrastruttura nel tuo account di archiviazione, modificare il valore Periodo di trasferimento (min).

Per ulteriori informazioni, vedere Raccogliere i dati di registro usando Diagnostica di Azure.

Directory di log

Le directory di log includono dati raccolti dalle directory di log per le richieste di Internet Information Services (IIS), le richieste non riuscite o le cartelle scelte dall'utente. Per acquisire le directory di log, selezionare la casella di controllo Abilita trasferimento delle directory di log. Per aumentare o diminuire l'intervallo tra il trasferimento dei log nell'account di archiviazione, modificare il valore Periodo di trasferimento (min).

Selezionare le caselle di controllo dei log da raccogliere, ad esempio log IIS e log di richiesta non riuscita. Vengono forniti i nomi dei contenitori di archiviazione predefiniti, ma è possibile modificare i nomi.

È possibile acquisire i log da qualsiasi cartella. Specificare il percorso nella sezione Log from Absolute Directory e quindi selezionare Aggiungi Directory. I log vengono acquisiti nei contenitori specificati.

Log ETW

Se si usa Event Tracing for Windows (ETW) (ETW) e si desidera acquisire i log ETW, selezionare la casella di controllo Abilita trasferimento dei log ETW. Per aumentare o diminuire l'intervallo tra il trasferimento dei log nell'account di archiviazione, modificare il valore periodo di trasferimento (min).

Gli eventi vengono acquisiti da fonti di eventi e da definizioni di eventi che specifichi. Per specificare un'origine evento, nella sezione Origini Evento, immettere un nome e quindi selezionare Aggiungi Origine Evento. Analogamente, è possibile specificare un manifesto dell'evento nella sezione manifesti eventi e quindi selezionare Aggiungi manifesto evento.

Il framework ETW è supportato in ASP.NET tramite classi nello spazio dei nomi System.Diagnostics.aspx. Lo spazio dei nomi Microsoft.WindowsAzure.Diagnostics, che eredita da ed estende le classi System.Diagnostics.aspx standard, consente l'uso di System.Diagnostics.aspx come framework di registrazione nell'ambiente Azure. Per altre informazioni, vedere Assumere il controllo della registrazione e della traccia in Microsoft Azure e Abilitare la diagnostica in Servizi cloud di Azure (supporto esteso) e macchine virtuali.

Dump di arresto anomalo del sistema

Per acquisire informazioni su quando un'istanza del ruolo si arresta in modo anomalo, selezionare la casella di controllo Abilita trasferimento di crash dumps. Poiché ASP.NET gestisce la maggior parte delle eccezioni, questa operazione è in genere utile solo per i ruoli di lavoro. Per aumentare o ridurre la percentuale di spazio di archiviazione dedicato ai dump di crash, modificare il valore della quota della directory (%). È possibile modificare il contenitore di archiviazione in cui sono archiviati i dump di arresto anomalo del sistema e selezionare se si vuole acquisire un full o mini dump.

I processi attualmente monitorati sono elencati nello screenshot successivo. Selezionare le caselle di controllo per i processi da acquisire. Per aggiungere un altro processo all'elenco, immettere il nome del processo e quindi selezionare Aggiungi processo.

Per altre informazioni, vedere Assumere il controllo della registrazione e della traccia in Microsoft Azure.

Risolvere i problemi di Servizi cloud di Azure (supporto esteso)

Se si verificano problemi con i progetti di servizio cloud, ad esempio un ruolo che si blocca in uno stato "occupato", ricicla ripetutamente o genera un errore interno del server, sono disponibili strumenti e tecniche che è possibile usare per diagnosticare e risolvere il problema. Per esempi specifici di problemi e soluzioni comuni e per una panoramica dei concetti e degli strumenti che è possibile usare per diagnosticare e correggere questi errori, vedere i dati di diagnostica di calcolo paaS (Platform as a Service) di Azure.

Q & A

Quali sono le dimensioni del buffer e quanto deve essere grande?

In ogni istanza della macchina virtuale, le quote limitano la quantità di dati di diagnostica che possono essere archiviati nel file system locale. È anche possibile specificare una dimensione del buffer per ogni tipo di dati di diagnostica disponibili. Questa dimensione del buffer funge da quota singola per quel tipo di dati. Per determinare la quota complessiva e la quantità di memoria rimanente, vedere la parte inferiore della finestra di dialogo per il tipo di dati di diagnostica. Se si specificano buffer più grandi o più tipi di dati, si avvicina la quota complessiva. È possibile modificare la quota complessiva modificando il file di configurazione diagnostics.wadcfgx. I dati di diagnostica vengono archiviati nello stesso file system dei dati dell'applicazione. Se l'applicazione usa una grande quantità di spazio su disco, non è consigliabile aumentare la quota di diagnostica complessiva.

Qual è il periodo di trasferimento e quanto tempo deve essere?

Il periodo di trasferimento è la quantità di tempo trascorso tra le acquisizioni di dati. Dopo ogni periodo di trasferimento, i dati vengono spostati dal file system locale in una macchina virtuale alle tabelle nell'account di archiviazione. Se la quantità di dati raccolti supera la quota prima della fine di un periodo di trasferimento, i dati meno recenti vengono eliminati. Se si stanno perdendo dati perché i dati superano le dimensioni del buffer o la quota complessiva, è possibile ridurre il periodo di trasferimento.

In quale fuso orario si trovano i timestamp?

I timestamp si trovano nel fuso orario locale del data center che ospita il servizio cloud. Vengono usate le tre colonne timestamp seguenti nelle tabelle di log:

• PreciseTimeStamp: Il timestamp ETW dell'evento. Ovvero, l'ora in cui l'evento viene registrato dal client.
• TIMESTAMP: Valore per PreciseTimeStamp arrotondato per difetto per adeguarsi al limite della frequenza di caricamento. Ad esempio, se la frequenza di caricamento è di 5 minuti e l'ora dell'evento 00:17:12, TIMESTAMP è 00:15:00.
• Timestamp: Timestamp in corrispondenza del quale è stata creata l'entità nella tabella di Azure.

Come si gestiscono i costi durante la raccolta di informazioni di diagnostica?

Le impostazioni predefinite (livello di log impostate su Erroree periodo di trasferimento impostato su 1 minuto) sono progettate per ridurre al minimo i costi. I costi di calcolo aumentano quando si raccolgono più dati di diagnostica o si riduce il periodo di trasferimento. Non raccogliere più dati di quanto necessario e non dimenticare di disabilitare la raccolta dati quando non è più necessaria. È sempre possibile abilitarla di nuovo, anche in fase di esecuzione, come descritto in precedenza in questo articolo.

Come si raccolgono i log delle richieste non riuscite da IIS?

Per impostazione predefinita, IIS non raccoglie i log delle richieste non riuscite. È possibile configurare IIS per raccogliere i log delle richieste non riuscite modificando il file web.config per il ruolo Web.

Non sto ricevendo informazioni di traccia dai metodi RoleEntryPoint come OnStart. Cosa c'è che non va?

I metodi di RoleEntryPoint vengono chiamati nel contesto di WAIISHost.exe, non in IIS. Le informazioni di configurazione in web.config che in genere abilitano la traccia non si applicano. Per risolvere questo problema, aggiungere un file di .config al progetto del ruolo Web e assegnare al file il nome corrispondente all'assembly di output contenente il codice RoleEntryPoint. Nel progetto ruolo Web predefinito il nome del file di .config deve essere WAIISHost.exe.config. Aggiungere le righe seguenti al file:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

Nella finestra Proprietà impostare la proprietà Copia nella directory di output su Copia sempre.

Contenuto correlato

Per altre informazioni sulla registrazione diagnostica in Azure, vedere Abilitare la diagnostica in Servizi cloud di Azure (supporto esteso) e macchine virtuali e Abilitare la registrazione diagnostica per le app Web nel servizio app di Azure.