Connessione a Log Analytics o Application Insights dai flussi di lavoro in App per la logica di Azure

Articolo
02/21/2024

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

Nota

Il connettore Log di Monitoraggio di Azure sostituisce il connettore Azure Log Analytics e il connettore app Azure lication 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 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.

Riferimento tecnico Connessione or

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 esiste nel modo in cui vengono restituiti i dati.

Azione	Descrizione
Eseguire query ed elencare i risultati	Restituisce ogni riga come proprio oggetto. Usare questa azione quando si desidera utilizzare ogni riga separatamente nel resto del flusso di lavoro. L'azione è in genere seguita da un'azione For each.
Eseguire 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	~16,7 MB o 16 MiB	L'infrastruttura del connettore determina che il limite di dimensioni è impostato inferiore al limite dell'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 per l'esecuzione più frequente in un intervallo di tempo più piccolo. 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 nel connettore usano librerie di grafici diverse. Il connettore attualmente non include alcune funzionalità.

Prerequisiti

Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Area di lavoro Log Analytics o risorsa di Application Insights da connettere.
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 di Application Insights. Per usare un'azione Log di Monitoraggio di Azure, avviare il flusso di lavoro con qualsiasi trigger. Questa guida usa il trigger 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

Standard
Consumo

Nella portale di Azure aprire l'app per la logica Standard e il flusso di lavoro 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 Esegui query e visualizza i risultati.

Nella casella di connessione specificare le informazioni seguenti:

Proprietà	Descrizione
Nome connessione	Nome della 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 Esegui query e visualizza i risultati specificare le informazioni seguenti:

Proprietà	Richiesto	Valore	Descrizione
Abbonamento	Sì	<Sottoscrizione di Azure>	Sottoscrizione di Azure per l'area di lavoro Log Analytics o l'applicazione Application Insights.
Gruppo di risorse	Sì	<Azure-resource-group>	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 di 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 asc
```
- Risorsa di Application Insights
  
  La query di esempio seguente seleziona le richieste non riuscite nell'ultimo giorno e le correla con le eccezioni che si sono verificate durante l'operazione, in base all'identificatore operation_Id . La query segmenta quindi i risultati usando l'algoritmo autocluster() .
```
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.

Nella tabella seguente vengono descritte le opzioni per 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.

Nella portale di Azure aprire l'app per la logica a consumo e il flusso di lavoro 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 Esegui query e visualizza i risultati.