Monitorare e risolvere problemi relativi alla raccolta dati DCR in Monitoraggio di Azure

Questo articolo fornisce metriche e log dettagliati che è possibile usare per monitorare le prestazioni e risolvere eventuali problemi relativi alla raccolta dati in Monitoraggio di Azure. Questi dati di telemetria sono attualmente disponibili per gli scenari di raccolta dati definiti da regole di raccolta dati (DCR) ad esempio l'agente di Monitoraggio di Azure e l'API di inserimento di log.

Le funzionalità di diagnostica DCR includono metriche e log degli errori generati durante l'elaborazione dei log. Le metriche DCR forniscono informazioni sul volume di dati inseriti, sul numero e sulla natura di eventuali errori di elaborazione e statistiche correlate alla trasformazione dei dati. I log degli errori DCR vengono generati ogni volta che l'elaborazione dei dati non riesce e ogni volta che i dati non raggiungono la destinazione.

Log degli errori DCR

I log degli errori vengono generati quando i dati raggiungono la pipeline di inserimento di Monitoraggio di Azure ma non raggiungono la destinazione. Esempi di condizioni di errore includono:

• Errori di recapito dei log
• Errori di trasformazione in cui la struttura dei log rende la trasformazione KQL non valida
• Chiamate API di inserimento log:
  • con qualsiasi risposta HTTP diversa da 200/202
  • con payload contenente dati in formato non valido
  • con payload oltre i limiti di inserimento
  • limitazione a causa dell'eccedenza dei limiti delle chiamate API

Per evitare una registrazione eccessiva di errori persistenti correlati allo stesso flusso di dati, ogni ora alcuni errori verranno registrati solo un numero limitato di volte accompagnati da un messaggio di errore di riepilogo. L'errore viene quindi disattivato fino alla fine dell'ora. Il numero di volte in cui viene registrato un determinato errore può variare a seconda dell'area in cui viene distribuita la DCR.

Alcuni errori di inserimento dei log non verranno registrati perché non possono essere associati a una DCR. Potrebbero non essere registrati gli errori seguenti:

• Errori causati da un URI di chiamata in formato non valido (codice di risposta HTTP 404)
• Alcuni errori interni del server (codice di risposta HTTP 500)

Abilitare i log degli errori DCR

I log degli errori DCR vengono implementati come log delle risorse in Monitoraggio di Azure. Abilitare la raccolta di log creando un'impostazione di diagnostica per la DCR. Per ogni DCR è necessaria una propria impostazione di diagnostica. Per informazioni dettagliate, vedere Creare impostazioni di diagnostica in Monitoraggio di Azure. Selezionare la categoria Errori di log e Invia all'area di lavoro Log Analytics. È possibile selezionare la stessa area di lavoro usata dal Registro Azure Container oppure consolidare tutti i log degli errori in una singola area di lavoro.

Recuperare i log degli errori DCR

I log degli errori vengono scritti nella tabella DCRLogErrors nell'area di lavoro Log Analytics specificata nell'impostazione di diagnostica. Di seguito sono riportate le query di esempio che è possibile usare in Log Analytics per recuperare questi log.

Recuperare tutti i log degli errori per una DCR specifica

DCRLogErrors
| where _ResourceId == "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"

Recuperare tutti i log degli errori per un flusso di input specifico in una determinata DCR

DCRLogErrors
| where _ResourceId == "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
| where InputStreamId == "Custom-MyTable_CL"

Metriche DCR

Le metriche DCR vengono raccolte automaticamente per tutti i DCR ed è possibile analizzarle usando Esplora metriche, ad esempio le metriche della piattaforma per altre risorse di Azure. Il flusso di input è incluso come una dimensione, quindi, se si dispone di una DCR con più flussi di input, è possibile analizzarli filtrandoli o suddividendoli. Alcune metriche includono altre dimensioni, come illustrato nella tabella seguente.

Risoluzione dei problemi comuni

Se mancano i dati previsti nell'area di lavoro Log Analytics, seguire questa procedura di base per risolvere il problema. Ciò presuppone che sia stata abilitata la registrazione DCR come descritto in precedenza.

• Controllare le metriche quali Logs Ingestion Bytes per Min e Logs Rows Received per Min per assicurarsi che i dati raggiungano Monitoraggio di Azure. In caso contrario, controllare l'origine dati per assicurarsi che invii dati come previsto.
• Verificare Logs Rows Dropped per Min per controllare se vengono eliminate righe. Ciò potrebbe non indicare un errore perché le righe potrebbero essere eliminate da una trasformazione. Se le righe eliminate sono le stesse di Logs Rows Dropped per Min, nell'area di lavoro non verranno inseriti dati. Esaminare Logs Transformation Errors per Min per verificare se sono presenti errori di trasformazione.
• Controllare Logs Transformation Errors per Min per verificare se sono presenti errori dalle trasformazioni applicate ai dati in ingresso. Ciò potrebbe essere dovuto a modifiche apportate alla struttura dei dati o alla trasformazione stessa.
• Controllare DCRLogErrors per verificare la presenza di eventuali errori di inserimento che potrebbero essere stati registrati. Questo può fornire dettagli aggiuntivi per identificare la causa radice del problema.

Monitoraggio dell'inserimento dei log

I segnali seguenti possono essere utili per monitorare l'integrità della raccolta di log con le DCR. Creare regole di avviso per identificare queste condizioni.

Avvisi

Anziché risolvere i problemi in modo reattivo, creare regole di avviso per ricevere una notifica proattiva quando si verifica una potenziale condizione di errore. La tabella seguente fornisce esempi di regole di avviso che è possibile creare per monitorare l'inserimento dei log.

Passaggi successivi

• Altre informazioni sulle regole di raccolta dati.
• Altre informazioni sulle trasformazioni in fase di inserimento.