Condividi tramite

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 (a consumo e 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, eventi di esecuzione ed 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 senza perdita del 100%. I log delle risorse si basano su un'architettura di archiviazione e inoltro progettata per spostare petabyte di dati a prezzi accessibili al giorno su larga scala. Questa funzionalità include ridondanza predefinita e nuovi tentativi in tutta la piattaforma, ma non offre garanzie transazionali. Il monitoraggio transazionale potrebbe ridurre l'affidabilità e le prestazioni del servizio monitorato. Inoltre, gli errori di registrazione temporanei devono interrompere il servizio upstream quando non è possibile confermare il recapito del log. Ogni volta che il team di Monitoraggio di Azure può confermare una fonte permanente di perdita di dati, il team considera la risoluzione e la prevenzione la priorità più alta. Tuttavia, potrebbero verificarsi piccole perdite di dati a causa di problemi temporanei e non ripetuti del servizio distribuiti in Azure e non tutti possono essere rilevati.

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

Prerequisiti

Abilitare l'analisi dei log

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

Abilitare Log Analytics alla creazione dell'app per la logica

  1. Nel portale di Azure, nel riquadro Creare un'app per la logica seguire questa procedura:

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

    2. Per Abilita Log Analytics, selezionare Sì.

    3. Nell'elenco dell'area di lavoro Log Analytics, selezionare l'area di lavoro in cui si vogliono inviare i dati dall'esecuzione del flusso di lavoro.

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

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

    Al termine, l'app per la logica è associata all'area di lavoro Log Analytics. Con questo passaggio, nell'area di lavoro viene anche installata automaticamente la soluzione di gestione delle App per la logica.

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

Installare la soluzione di gestione delle app per la logica

Se è stato 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 i passaggi seguenti per un'App per la logica a consumo esistente:

  1. Nella casella di ricerca del portale di Azure, immettere le aree di lavoro dell'analisi dei log e selezionare Aree di lavoro di Log Analytics nei risultati.

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

  2. IN aree di lavoro di Log Analytics, selezionare l'area di lavoro.

    Screenshot che mostra il portale di Azure, l'elenco delle 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, selezionare Visualizza soluzioni.

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

  4. In Panoramica, selezionare Aggiungi per aggiungere una nuova soluzione all'area di lavoro.

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

    Screenshot che mostra il portale di Azure, la casella di ricerca della pagina Marketplace con l'opzione

  6. Nel riquadro Gestione App per la logica, nell'elenco Crea, selezionare Gestione App per la logica.

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

  7. Nel riquadro Crea soluzione Gestione 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 il portale di Azure, la pagina Crea soluzione di Gestione App per la logica (anteprima) e le informazioni sull'area di lavoro.

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

    Screenshot che mostra il 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. Nel portale di Azure aprire la risorsa dell'app per la logica A consumo.

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

    Screenshot che mostra il portale di Azure, il menu delle risorse dell'app per la logica a consumo con l'opzione

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

  4. In Log>Categorie, selezionare Eventi di diagnostica di runtime di Workflow. In Metricheselezionare AllMetrics.

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

    Destinazione 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 e Integrazioni dei partner di Monitoraggio di Azure.
    Invia a soluzione partner Selezionare la sottoscrizione di Azure e la destinazione. Per altre informazioni, vedere Panoramica dei servizi di Azure Native ISV.

    L'esempio seguente seleziona un'area di lavoro Log Analytics come destinazione:

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

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

Visualizzare lo stato di 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. Nel portale di Azure, aprire l'area di lavoro Log Analytics.

  2. Nel menu dell'area di lavoro, in Versione classica, selezionare Riepilogo dell'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 il portale di Azure, l'area di lavoro Log Analytics con lo stato e il numero di esecuzioni dell'app per la logica a 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 a 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 a 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 a consumo.

  4. Per filtrare questi risultati, è possibile applicare un filtro sia sul lato client sia sul lato server.

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

      Screenshot che mostra l'esempio di filtro lato client usando i filtri di colonna.

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

      Screenshot che mostra un 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 dell'esecuzione del flusso di lavoro dell'app per la logica desiderata.

    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 a Hub eventi di Azure

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

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

Nota

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

Screenshot che mostra il portale di Azure, la risorsa dell'app per la logica a consumo, l'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 relativi valori vengano visualizzati insieme ai dati di telemetria generati nell'area di lavoro Log Analytics.

ID di traccia personalizzato

La maggior parte dei trigger dispone di una proprietà ID di traccia 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 tutti 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 dell'ID personalizzato nella richiesta del trigger. È possibile usare un trigger di richiesta, un trigger HTTP o un trigger basato su webhook.

Proprietà rilevate

Le azioni includono 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 di singoli input e output di azioni, ma è possibile usare le proprietà correlation degli eventi per correlare più azioni in un'esecuzione di 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 mostrano dove vengono visualizzate 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 rivedere.

  3. Nella tabella Esecuzioni, nella tabella Esecuzioni dell'app per la logica, individuare la colonna ID di traccia 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