Connettersi a Log Analytics o Application Insights dai flussi di lavoro in App per la logica di Azure
Si applica a: App per la logica di Azure (a consumo e standard)
Nota
Il connettore Log di Monitoraggio di Azure sostituisce il connettore di Azure Log Analytics e il connettore di Azure Application Insights. Questo connettore offre la stessa funzionalità degli altri connettori ed è il metodo preferito per l'esecuzione di una query su un'area di lavoro Log Analytics o su una risorsa di Application Insights. Ad esempio, quando ci si connette alla risorsa di Application Insights, non è necessario creare o fornire un ID applicazione e una chiave API. L'autenticazione è integrata con Microsoft Entra ID.
Per creare flussi di lavoro in App per la logica di Azure che recuperano dati da un'area di lavoro Log Analytics o da una risorsa di Application Insights in Monitoraggio di Azure, è possibile usare il connettore Log di Monitoraggio di Azure.
Ad esempio, è possibile creare un flusso di lavoro dell'app per la logica che invia i dati di log di Monitoraggio di Azure in un messaggio di posta elettronica dall'account Outlook di Office 365, creare un bug in Azure DevOps o pubblicare un messaggio Slack. Questo connettore fornisce solo azioni, quindi per avviare un flusso di lavoro, è possibile usare un trigger di ricorrenza per specificare una pianificazione semplice o qualsiasi trigger da un altro servizio.
Questa guida descrive come creare un flusso di lavoro dell'app per la logica che invia i risultati di una query di log di Monitoraggio di Azure tramite posta elettronica.
Informazioni tecniche sul connettore
Per informazioni tecniche sulle operazioni di questo connettore, vedere la documentazione di riferimento del connettore.
Entrambe le azioni seguenti possono eseguire una query di log su un'area di lavoro Log Analytics o una risorsa di Application Insights. La differenza sussiste nel modo in cui vengono restituiti i dati.
| Azione | Descrizione |
|---|---|
| Eseguire la query ed elencare i risultati | Restituisce ogni riga come oggetto specifico. Usare questa azione per operare separatamente con ogni riga nel resto del flusso di lavoro. L'azione è in genere seguita da un'azione For each. |
| Eseguire la query e visualizzare i risultati | Restituisce un file JPG che illustra il set di risultati della query. Questa azione consente di usare il set di risultati nel resto del flusso di lavoro inviando, ad esempio, i risultati in un messaggio di posta elettronica. L'azione restituisce solo un file JPG se la query restituisce risultati. |
Limiti
Il connettore ha i limiti seguenti, che il flusso di lavoro potrebbe raggiungere, in base alla query usata e alle dimensioni dei risultati:
Limite Valore Note Dimensioni massime della risposta alle query Circa 16,7 MB o 16 MiB L'infrastruttura del connettore determina che il limite delle dimensioni è impostato come inferiore per l'API di query. Numero massimo di record 500.000 record Timeout massimo connettore 110 secondi Timeout massimo query 100 secondi Per evitare di raggiungere questi limiti, provare ad aggregare i dati per ridurre le dimensioni dei risultati o modificare la ricorrenza del flusso di lavoro in modo che l'esecuzione sia più frequente in un intervallo di tempo inferiore. Tuttavia, a causa della memorizzazione nella cache, le query frequenti con intervalli inferiori a 120 secondi non sono consigliate.
Le visualizzazioni nella pagina Log e il connettore usano librerie di grafici diverse. Quindi, attualmente il connettore non include alcuna funzionalità.
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
L'area di lavoro Log Analytics o la risorsa Application Insights che si vuole connettere.
Il flusso di lavoro dell'app per la logica Standard o a consumo da cui si vuole accedere all'area di lavoro Log Analytics o alla risorsa Application Insights. Per usare un'azione Log di Monitoraggio di Azure, avviare il flusso di lavoro con un trigger qualsiasi. Questa guida usa il triggerdi ricorrenza.
Un account di Office 365 Outlook per completare l'esempio in questa guida. In caso contrario, è possibile usare qualsiasi provider di posta elettronica con un connettore disponibile in App per la logica di Azure.
Aggiungere un'azione Log di Monitoraggio di Azure
Nel portale di Azure, aprire l'app per la logica e il flusso di lavoro Standard nella finestra di progettazione.
Nel flusso di lavoro in cui si vuole aggiungere l'azione Log di Monitoraggio di Azure, seguire questa procedura generale per aggiungere un'azione Log di Monitoraggio di Azure.
Questo esempio continua con l'azione denominata Eseguire query e visualizzare i risultati.
Nella casella di connessione, specificare le informazioni seguenti:
Proprietà Descrizione Nome connessione Nome per la connessione Tipo di autenticazione Tipo di autenticazione da usare per la connessione. Per altre informazioni, vedere Aggiungere l'autenticazione alle chiamate in uscita. ID tenant Tenant di Microsoft Entra. Nota: l'account associato alla connessione corrente viene usato in un secondo momento per inviare il messaggio di posta elettronica. Al termine, selezionare Accedi o Crea nuovo in base al tipo di autenticazione selezionato.
Nella casella di azione Eseguire query e visualizzare i risultati specificare le informazioni seguenti:
Proprietà Richiesto Valore Descrizione Abbonamento Sì <Sottoscrizione di Azure> La sottoscrizione di Azure per l'area di lavoro Log Analytics o l'applicazione Application Insights. Gruppo di risorse Sì <Azure-resource-group> Il gruppo di risorse di Azure per l'area di lavoro Log Analytics o l'applicazione Application Insights. Tipo di risorsa Sì Area di lavoro Log Analytics o Application Insights Tipo di risorsa da connettere dal flusso di lavoro. Questo esempio continua selezionando Area di lavoro Log Analytics. Nome della risorsa Sì <Azure-resource-name> Nome dell'area di lavoro Log Analytics o della risorsa Application Insights. Nella casella Query immettere la query Kusto seguente per recuperare i dati di log specificati dalle origini seguenti:
Nota
Quando si creano query personalizzate, assicurarsi che funzionino correttamente in Log Analytics prima di aggiungerle all'azione Log di Monitoraggio di Azure.
area di lavoro Log Analytics
La query di esempio seguente seleziona gli errori che si sono verificati nell'ultimo giorno, ne segnala il numero totale e li ordina in ordine crescente.
Event | where EventLevelName == "Error" | where TimeGenerated > ago(1day) | summarize TotalErrors=count() by Computer | sort by Computer ascUna risorsa di Application Insights
La query di esempio seguente seleziona le richieste non riuscite entro l'ultimo giorno e le correla alle eccezioni che si sono verificate durante l'operazione, in base all'identificatore
operation_Id. La query segmenta quindi i risultati usando l'algoritmoautocluster().requests | where timestamp > ago(1d) | where success == "False" | project name, operation_Id | join ( exceptions | project problemId, outerMessage, operation_Id ) on operation_Id | evaluate autocluster()
Per Intervallo di tempo, selezionare Imposta nella query.
La tabella seguente illustra le opzioni di Intervallo di tempo:
Intervallo di ore Descrizione Exact Fornire dinamicamente l'ora di inizio e l'ora di fine. Relativo Impostare il valore relativo, ad esempio l'ultima ora, le ultime 12 ore e così via. Query impostata Si applica quando il filtro TimeGenerated viene incluso nella query. Per Tipo di grafico, selezionare Tabella HTML.
Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Aggiungere un'azione di posta elettronica
Nel flusso di lavoro in cui si vuole aggiungere l'azione di Outlook di Office 365, seguire questa procedura generale per aggiungere l'azione di Outlook di Office 365 denominata Invia un messaggio di posta elettronica (V2)
Nella casella A immettere l'indirizzo di posta elettronica del destinatario. Per questo esempio, usare il proprio indirizzo di posta elettronica.
Nella casella Oggetto, immettere un oggetto per il messaggio di posta elettronica, ad esempio Principali errori giornalieri.
Fare clic all'interno della casella Corpo e quindi selezionare l'opzione Contenuto dinamico (icona a forma di fulmine), in modo da poter selezionare gli output dei passaggi precedenti nel flusso di lavoro.
Nell'elenco di contenuto dinamico, in Eseguire query e visualizzare i risultati, selezionare Corpo, che rappresenta i risultati della query immessa in precedenza nell'azione Log Analytics.
Nell'elenco Parametri avanzati, selezionare Allegati.
L'azione Invia un messaggio di posta elettronica include ora la sezione Allegati con le proprietà Nome allegato e Contenuto dell'allegato.
Per le proprietà aggiunte, seguire questa procedura:
Nella casella Nome allegato aprire l'elenco di contenuto dinamico. In Eseguire query e visualizzare i risultati, selezionare Nome allegato.
Nella casella Contenuto dell'allegato, aprire l'elenco di contenuto dinamico. In Eseguire query e visualizzare i risultati, selezionare Contenuto dell'allegato.
Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Testare il flusso di lavoro
Nel menu del flusso di lavoro, selezionare Panoramica.
Nella barra degli strumenti Panoramica, selezionare Esegui>Esegui.
Al termine del flusso di lavoro, controllare la propria e-mail.
Nota
Il flusso di lavoro genera un messaggio di posta elettronica con un file JPG che mostra il set di risultati della query. Se la query non restituisce risultati, il flusso di lavoro non crea un file JPG.
Per l'esempio dell'area di lavoro Log Analytics, il messaggio di posta elettronica ricevuto ha un corpo simile all'esempio seguente:
Per una risorsa Application Insights, il messaggio di posta elettronica ricevuto ha un corpo simile all'esempio seguente:
Passaggi successivi
- Vedere altre informazioni sulle query di log in Monitoraggio di Azure
- Altre informazioni sulle query per Log Analytics