Risolvere i problemi di Analisi di flusso di Azure usando i log delle risorse

In alcuni casi un processo di Analisi di flusso di Azure arresta l'elaborazione in modo imprevisto. Gli errori potrebbero essere causati da un risultato imprevisto della query, dalla connettività ai dispositivi o da un'interruzione imprevista del servizio. I log delle risorse in Analisi di flusso di Azure consentono di identificare la causa di questi errori e ridurre il tempo di ripristino.

Abilitare i log delle risorse per tutti i processi di Analisi di flusso per facilitare il debug e il monitoraggio.

Tipi di log di Stream Analytics

Analisi di flusso offre due tipi di log:

• Log attività (sempre attivi), che forniscono informazioni sulle operazioni eseguite sui processi.

• I registri delle risorse (configurabili) forniscono informazioni più dettagliate su tutto ciò che accade in un processo. I log delle risorse vengono avviati quando viene creato il processo e terminati quando il processo viene eliminato. Coprono gli eventi relativi a quando il processo viene aggiornato e mentre è in esecuzione.

Eseguire il debug dei processi di Stream Analytics tramite i log delle attività

I log attività sono attivati per impostazione predefinita e forniscono informazioni dettagliate sulle operazioni eseguite dal processo di Analisi di flusso. Le informazioni presenti nei registri delle attività potrebbero aiutare a individuare la causa principale dei problemi che influiscono sul processo. Per usare i log attività in Analisi di flusso, seguire questa procedura:

1. Accedi al portale di Azure e seleziona Log attività in Panoramica.

   

2. È possibile visualizzare un elenco delle operazioni che sono state eseguite. Qualsiasi operazione che ha causato l'esito negativo del processo viene contrassegnata da una bolla rossa.

3. Selezionare un'operazione per visualizzare il riepilogo. Le informazioni qui sono spesso limitate. Per informazioni dettagliate sull'operazione, selezionare JSON.

   

4. Scorrere verso il basso fino alla sezione pannello Proprietà di JSON, che fornisce i dettagli dell'errore che ha causato il fallimento dell'operazione. In questo esempio, l'errore era dovuto a un errore di runtime causato da valori di latitudine fuori intervallo. Una discrepanza nei dati elaborati da un processo di Analisi di flusso causa un errore di dati. È possibile ottenere informazioni sui diversi errori di dati di input e output e sul motivo per cui si verificano.

   

5. Eseguire azioni correttive in base al messaggio di errore in JSON. In questo esempio aggiungere controlli per assicurarsi che il valore della latitudine sia compreso tra -90 gradi e 90 gradi.

6. Se il messaggio di errore nei log attività non è utile per identificare la causa radice, abilitare i log delle risorse e usare i log Monitoraggio di Azure.

Inviare i dati di diagnostica di Stream Analytics ai log di Monitoraggio di Azure

Attivare i log delle risorse e inviarli ai log di Monitoraggio di Azure. I log delle risorse sono disattivati per impostazione predefinita.

1. Creare un'area di lavoro Log Analytics se non ne è già disponibile una. Posizionare l'area di lavoro Log Analytics nella stessa area del processo di Analisi di flusso.

2. Accedere al portale di Azure e andare al processo di Analisi di flusso. In Monitoraggioselezionare Log di diagnostica. Quindi selezionare Attiva la diagnostica.

   

3. Specificare un Nome in Nome impostazione diagnostica e selezionare le caselle per Esecuzione e Creazione in log e AllMetrics in metrica. Dopodiché, selezionare Invia a Log Analytics e scegliere l'area di lavoro. Seleziona Salva.

   

4. Quando viene avviato il processo di Azure Stream Analytics, i log delle risorse vengono inviati all'area di lavoro Log Analytics. Per visualizzare i log delle risorse del processo, selezionare Log nella sezione Monitoraggio.

   

5. Analisi di flusso offre query predefinite che consentono di cercare facilmente i log a cui si è interessati. È possibile selezionare tutte le query predefinite nel riquadro sinistro e quindi selezionare Esegui. I risultati della query verranno visualizzati nel riquadro inferiore.

   

Categorie di log delle risorse di Analisi di flusso

Analisi di flusso di Azure acquisisce due categorie di log delle risorse:

• Creazione: acquisisce eventi di log relativi alle operazioni di creazione dei processi, tra cui creazione di processi, aggiunta ed eliminazione di input e output, aggiunta e aggiornamento della query, e avvio o arresto del processo.

• Esecuzione: acquisisce gli eventi che si verificano durante l'esecuzione del processo.

  • Errori di connettività
  • Errori di elaborazione dei dati, fra cui:
    • Eventi non conformi alla definizione della query (valori e tipi di campo non corrispondenti, campi mancanti e così via)
    • Errori di valutazione delle espressioni
  • Altri eventi ed errori

Tutti i log vengono archiviati in formato JSON. Per informazioni sullo schema per i log delle risorse, vedere Schema dei log delle risorse.

Passaggi successivi

• Errori dei dati di Stream Analytics
• Informazioni di riferimento sul linguaggio di query di Analisi di flusso