Monitorare e raccogliere dati di diagnostica per i flussi di lavoro in App per la logica di Azure

  • Articolo

Si applica a: App per la logica di Azure (consumo + Standard)

Per ottenere dati più avanzati per il debug e la diagnosi dei flussi di lavoro in App per la logica di Azure, è possibile registrare i dati e gli eventi di runtime del flusso di lavoro, ad esempio eventi di attivazione, esecuzione e eventi di azione, che è possibile inviare a un'area di lavoro Log Analytics, un account di archiviazione di Azure, un hub eventi di Azure, un'altra destinazione partner o tutte queste destinazioni quando si configurano e si usano i log di Monitoraggio di Azure.

Nota

I log delle risorse di Monitoraggio di Azure non sono 100% senza perdita. I log delle risorse si basano su un'architettura di archiviazione e inoltro progettata per spostare petabyte di dati in modo conveniente al giorno su larga scala. Questa funzionalità include ridondanza predefinita e tentativi in tutta la piattaforma, ma non fornisce garanzie transazionali. Il monitoraggio transazionale potrebbe ridurre l'affidabilità e le prestazioni del servizio monitorato. Inoltre, gli errori di registrazione temporanei devono arrestare il servizio upstream quando non è in grado di confermare il recapito del log. Ogni volta che il team di Monitoraggio di Azure può confermare un'origine persistente di perdita di dati, il team considera la risoluzione e la prevenzione della priorità più alta. Tuttavia, le piccole perdite di dati potrebbero comunque verificarsi a causa di problemi di servizio temporanei e non ripetuti distribuiti in Azure e non tutti possono essere rilevati.

Questa guida illustra come completare le attività seguenti, in base al fatto che si disponga di una risorsa dell'app per la logica Consumo o Standard.

Prerequisiti

Abilitare l'analisi dei log

Per un'app per la logica di consumo, è prima necessario abilitare Log Analytics.

Abilitare Log Analytics nella creazione dell'app per la logica

  1. Nel riquadroCrea app per la logica portale di Azure seguire questa procedura:

    1. In Piano assicurarsi di selezionare Consumo in modo che vengano visualizzate solo le opzioni per i flussi di lavoro Consumo.

    2. Per Abilitare l'analisi dei log selezionare Sì.

    3. Nell'elenco delle aree di lavoro Log Analytics selezionare l'area di lavoro in cui si desidera inviare i dati dall'esecuzione del flusso di lavoro.

      Screenshot che mostra la pagina di creazione dell'app per la logica di portale di Azure e consumo.

  2. Completare la creazione della risorsa dell'app per la logica.

    Al termine, l'app per la logica è associata all'area di lavoro Log Analytics. Questo passaggio installa automaticamente la soluzione Gestione app per la logica nell'area di lavoro.

  3. Dopo aver eseguito il flusso di lavoro, visualizzare lo stato dell'esecuzione del flusso di lavoro.

Installare la soluzione di gestione delle app per la logica

Se si è attivato Log Analytics quando è stata creata la risorsa dell'app per la logica, ignorare questa sezione. La soluzione Gestione app per la logica è già installata nell'area di lavoro Log Analytics. In caso contrario, continuare con la procedura seguente per un'app per la logica di consumo esistente:

  1. Nella casella di ricerca portale di Azure immettere aree di lavoro log analytics e selezionare Aree di lavoro Log Analytics dai risultati.

    Screenshot che mostra la casella di ricerca portale di Azure con aree di lavoro log analytics selezionate.

  2. In Aree di lavoro Log Analytics selezionare l'area di lavoro.

    Screenshot che mostra le portale di Azure, l'elenco aree di lavoro Log Analytics e un'area di lavoro specifica selezionata.

  3. Nel riquadro Panoramica , in Introduzione a Log Analytics>Configurare soluzioni di monitoraggio selezionareVisualizza soluzioni.

    Screenshot che mostra la portale di Azure, la pagina panoramica dell'area di lavoro e Visualizza soluzioni selezionate.

  4. In Panoramica selezionare Aggiungi, che aggiunge una nuova soluzione all'area di lavoro.

  5. Dopo aver aperto la pagina Marketplace , nella casella di ricerca immettere la gestione delle app per la logica e selezionare Gestione app per la logica.

    Screenshot che mostra la portale di Azure, la casella di ricerca della pagina Marketplace con

  6. Nel riquadro Gestione app per la logica selezionare Gestione app per la logica dall'elenco Crea.

    Screenshot che mostra la portale di Azure, la pagina Marketplace, il riquadro

  7. Nel riquadro Crea soluzione App per la logica (anteprima) selezionare l'area di lavoro Log Analytics in cui si vuole installare la soluzione. Selezionare Rivedi e crea, rivedere le informazioni e selezionare Crea.

    Screenshot che mostra l'portale di Azure, la pagina Crea soluzioni per la gestione delle app per la logica (anteprima) e le informazioni sull'area di lavoro.

    Dopo aver distribuito la soluzione al gruppo di risorse di Azure contenente l'area di lavoro Log Analytics, la soluzione viene visualizzata nel riquadro di riepilogo dell'area di lavoro in Panoramica.

    Screenshot che mostra la portale di Azure, il riquadro di riepilogo dell'area di lavoro con la soluzione Gestione app per la logica.

Aggiungere un'impostazione di diagnostica

  1. Nella portale di Azure aprire la risorsa dell'app per la logica di consumo.

  2. Nel menu delle risorse dell'app per la logica selezionareImpostazioni di diagnostica. Nella pagina Impostazioni di diagnostica selezionare Aggiungi impostazione di diagnostica.

    Screenshot che mostra portale di Azure, menu delle risorse dell'app per la logica di consumo con 'Impostazioni di diagnostica' selezionate e quindi 'Aggiungi impostazione di diagnostica' selezionata.

  3. Per Nome impostazione diagnostica specificare il nome desiderato per l'impostazione.

  4. InCategoriedi log> selezionare Eventi di diagnostica del runtime del flusso di lavoro. In Metriche selezionare AllMetrics.

  5. In Dettagli destinazione selezionare una o più destinazioni in base alla posizione in cui inviare i log.

    Destination Indicazioni
    Inviare all'area di lavoro Log Analytics Selezionare la sottoscrizione di Azure per l'area di lavoro Log Analytics e l'area di lavoro.
    Archivia in un account di archiviazione Selezionare la sottoscrizione di Azure per l'account di archiviazione di Azure e l'account di archiviazione. Per altre informazioni, vedere Inviare dati di diagnostica ad Archiviazione di Azure e Hub eventi di Azure.
    Streaming in un hub eventi Selezionare la sottoscrizione di Azure per lo spazio dei nomi dell'hub eventi, l'hub eventi e il nome dei criteri dell'hub eventi. Per altre informazioni, vedere Inviare dati di diagnostica ad Archiviazione di Azure e Hub eventi di Azure eintegrazioni dei partner di Monitoraggio di Azure.
    Inviare alla soluzione partner Selezionare la sottoscrizione di Azure e la destinazione. Per altre informazioni, vedere Panoramica di Azure Native ISV Services.

    Nell'esempio seguente viene selezionata un'area di lavoro Log Analytics come destinazione:

    Screenshot che mostra portale di Azure, area di lavoro Log Analytics e dati da raccogliere.

  6. Per completare l'aggiunta dell'impostazione di diagnostica, selezionare Salva.

Visualizzare lo stato dell'esecuzione del flusso di lavoro

Dopo l'esecuzione del flusso di lavoro, è possibile visualizzare i dati relativi a tali esecuzioni nell'area di lavoro Log Analytics.

  1. Nella portale di Azure aprire l'area di lavoro Log Analytics.

  2. Nel menu dell'area di lavoro selezionare Riepilogo area di lavoro. Nella pagina Panoramica selezionare Gestione app per la logica.

    Nota

    Se il riquadro Gestione app per la logica non mostra immediatamente i risultati dopo un'esecuzione, provare a selezionare Aggiorna o attendere un breve periodo di tempo prima di riprovare.

    Screenshot che mostra portale di Azure, area di lavoro Log Analytics con stato di esecuzione e conteggio dell'app per la logica di consumo.

    La pagina di riepilogo mostra i flussi di lavoro raggruppati per nome o per stato di esecuzione. La pagina mostra anche i dettagli sugli errori nelle azioni o nei trigger per le esecuzioni del flusso di lavoro.

    Screenshot che mostra il riepilogo dello stato per le esecuzioni del flusso di lavoro dell'app per la logica di consumo.

  3. Per visualizzare tutte le esecuzioni per un flusso di lavoro o uno stato specifico, selezionare la riga per tale flusso di lavoro o stato.

    Questo esempio mostra tutte le esecuzioni per un flusso di lavoro specifico:

    Screenshot che mostra le esecuzioni e lo stato per un flusso di lavoro specifico dell'app per la logica di consumo.

    Per le azioni in cui sono state aggiunte proprietà rilevate, è possibile cercare le proprietà rilevate usando il filtro di colonna. Per visualizzare le proprietà, nella colonna Proprietà rilevate selezionare Visualizza.

    Screenshot che mostra le proprietà rilevate per un flusso di lavoro specifico dell'app per la logica di consumo.

  4. Per filtrare i risultati, è possibile eseguire filtri lato client e lato server.

    • Filtro lato client: per ogni colonna selezionare i filtri desiderati, ad esempio:

      Screenshot che mostra il filtro lato client di esempio usando filtri di colonna.

    • Filtro lato server: per selezionare un intervallo di tempo specifico o per limitare il numero di esecuzioni visualizzate, usare il controllo ambito nella parte superiore della pagina. Per impostazione predefinita, vengono visualizzati contemporaneamente solo 1.000 record.

      Screenshot che mostra il filtro lato server di esempio che modifica l'intervallo di tempo.

  5. Per visualizzare tutte le azioni e i relativi dettagli per un'esecuzione specifica, selezionare la riga per l'esecuzione di un flusso di lavoro dell'app per la logica.

    L'esempio seguente mostra tutte le azioni e i trigger per un'esecuzione specifica del flusso di lavoro dell'app per la logica:

    Screenshot che mostra tutte le operazioni e i dettagli per un'esecuzione specifica del flusso di lavoro dell'app per la logica.

Inviare dati di diagnostica ad Archiviazione di Azure e Hub eventi di Azure

Insieme ai log di Monitoraggio di Azure, è possibile inviare i dati raccolti ad altre destinazioni, ad esempio:

È quindi possibile ottenere il monitoraggio in tempo reale usando dati di telemetria e analisi da altri servizi, ad esempio Analisi di flusso di Azure e Power BI:

Nota

I periodi di conservazione si applicano solo quando si usa un account di archiviazione.

Screenshot che mostra portale di Azure, risorsa app per la logica di consumo, impostazione di diagnostica con l'account di archiviazione e le opzioni dell'hub eventi.

Includere proprietà personalizzate nei dati di telemetria

Nel flusso di lavoro, i trigger e le azioni hanno la possibilità di aggiungere le proprietà personalizzate seguenti in modo che i valori vengano visualizzati insieme ai dati di telemetria generati nell'area di lavoro Log Analytics.

ID di rilevamento personalizzato

La maggior parte dei trigger ha una proprietà ID rilevamento personalizzato in cui è possibile specificare un ID di rilevamento usando un'espressione. È possibile usare questa espressione per ottenere dati dal payload del messaggio ricevuto o per generare valori univoci, ad esempio:

Se non si specifica questo ID di rilevamento personalizzato, Azure genera automaticamente questo ID e correla gli eventi in un'esecuzione del flusso di lavoro, inclusi i flussi di lavoro annidati chiamati dal flusso di lavoro padre. È possibile specificare manualmente questo ID in un trigger passando un'intestazione x-ms-client-tracking-id con il valore ID personalizzato nella richiesta di trigger. È possibile usare un trigger request, un trigger HTTP o un trigger basato su webhook.

Proprietà rilevate

Le azioni hanno una sezione Proprietà rilevate in cui è possibile specificare un nome e un valore di proprietà personalizzati immettendo un'espressione o un valore hardcoded per tenere traccia di input o output specifici, ad esempio:

Le proprietà rilevate possono tenere traccia solo degli input e degli output di una singola azione, ma è possibile usare le correlation proprietà degli eventi per correlare tra le azioni in un'esecuzione del flusso di lavoro.

Le proprietà rilevate possono fare riferimento solo ai parametri, agli input e agli output per il proprio trigger o azione.

Le proprietà rilevate non sono consentite in un trigger o in un'azione con input sicuri, output sicuri o entrambi. Non è inoltre consentito fare riferimento a un altro trigger o azione con input sicuri, output sicuri o entrambi.

Gli esempi seguenti illustrano dove vengono visualizzate le proprietà personalizzate nell'area di lavoro Log Analytics:

  1. Nel menu dell'area di lavoro Log Analytics, in Versione classica selezionare Riepilogo dell'area di lavoro. Nella pagina Panoramica selezionare Gestione app per la logica.

  2. Selezionare la riga per il flusso di lavoro da esaminare.

  3. Nella tabella Esecuzioni della pagina Esecuzioni dell'app per la logica individuare la colonna ID rilevamento e la colonna Proprietà rilevate .

    Screenshot che mostra le esecuzioni e lo stato per un flusso di lavoro a consumo specifico.

  4. Per cercare le proprietà rilevate, usare il filtro di colonna. Per visualizzare le proprietà, selezionare Visualizza.

    Screenshot che mostra le proprietà rilevate di esempio per un flusso di lavoro a consumo specifico.

Passaggi successivi