Monitorare e raccogliere dati di diagnostica per i flussi di lavoro in App per la logica di Azure
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.
In Creazione dell'app per la logica di consumo abilitare Log Analytics e specificare l'area di lavoro Log Analytics.
-oppure-
Per un'app per la logica di consumo esistente, installare la soluzione Gestione app per la logica nell'area di lavoro Log Analytics. Questa soluzione fornisce informazioni aggregate per le esecuzioni dell'app per la logica e include dettagli specifici, ad esempio stato di esecuzione, tempo di esecuzione, stato di ripetizione e ID correlazione.
Aggiungere un'impostazione di diagnostica per abilitare la raccolta dati.
Inviare dati di diagnostica ad Archiviazione di Azure e Hub eventi di Azure.
Prerequisiti
Un account e una sottoscrizione di Azure. Se non si ha una sottoscrizione, è possibile iscriversi per creare un account Azure gratuito.
Per una risorsa dell'app per la logica di consumo, è necessario disporre delle autorizzazioni proprietario o collaboratore della sottoscrizione di Azure, in modo da poter installare la soluzione Gestione app per la logica dall'Azure Marketplace. Per altre informazioni, vedere la documentazione seguente:
Risorsa di destinazione per la quale si desidera inviare dati di diagnostica:
Risorsa e flusso di lavoro dell'app per la logica
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
Nel riquadroCrea app per la logica portale di Azure seguire questa procedura:
In Piano assicurarsi di selezionare Consumo in modo che vengano visualizzate solo le opzioni per i flussi di lavoro Consumo.
Per Abilitare l'analisi dei log selezionare Sì.
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.
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.
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:
Nella casella di ricerca portale di Azure immettere aree di lavoro log analytics e selezionare Aree di lavoro Log Analytics dai risultati.
In Aree di lavoro Log Analytics selezionare l'area di lavoro.
Nel riquadro Panoramica , in Introduzione a Log Analytics>Configurare soluzioni di monitoraggio selezionareVisualizza soluzioni.
In Panoramica selezionare Aggiungi, che aggiunge una nuova soluzione all'area di lavoro.
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.
Nel riquadro Gestione app per la logica selezionare Gestione app per la logica dall'elenco Crea.
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.
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.
Aggiungere un'impostazione di diagnostica
Nella portale di Azure aprire la risorsa dell'app per la logica di consumo.
Nel menu delle risorse dell'app per la logica selezionareImpostazioni di diagnostica. Nella pagina Impostazioni di diagnostica selezionare Aggiungi impostazione di diagnostica.
Per Nome impostazione diagnostica specificare il nome desiderato per l'impostazione.
InCategoriedi log> selezionare Eventi di diagnostica del runtime del flusso di lavoro. In Metriche selezionare AllMetrics.
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:
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.
Nella portale di Azure aprire l'area di lavoro Log Analytics.
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.
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.
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:
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.
Per filtrare i risultati, è possibile eseguire filtri lato client e lato server.
Filtro lato client: per ogni colonna selezionare i filtri desiderati, ad esempio:
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.
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:
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:
- Archiviare i log delle risorse di Azure nell'account di archiviazione
- Trasmettere i log della piattaforma Azure a Hub eventi di Azure
È 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:
- Trasmettere i dati da Hub eventi ad Analisi di flusso
- Analizzare i dati di streaming con Analisi di flusso e creare un dashboard di analisi in tempo reale in Power BI
Nota
I periodi di conservazione si applicano solo quando si usa un account di archiviazione.
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:
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.
Selezionare la riga per il flusso di lavoro da esaminare.
Nella tabella Esecuzioni della pagina Esecuzioni dell'app per la logica individuare la colonna ID rilevamento e la colonna Proprietà rilevate .
Per cercare le proprietà rilevate, usare il filtro di colonna. Per visualizzare le proprietà, selezionare Visualizza.