Usare Azure Application Insights in Data API Builder

Azure Application Insights è un servizio di monitoraggio che acquisisce dati di telemetria, ad esempio dettagli delle richieste, contatori delle prestazioni, log ed eccezioni. L'integrazione con Data API Builder (DAB) consente di diagnosticare i problemi e monitorare il comportamento di runtime nell'ambiente di produzione.

Avvertimento Application Insights non è supportato quando DAB è ospitato usando le app Web del servizio app di Azure.

Configurazione

Per configurare Application Insights nella configurazione DAB:

Esempio di CLI

dab add-telemetry \
  --app-insights-enabled true \
  --app-insights-conn-string "@env('app-insights-connection-string')"

Esempio di JSON

"runtime": {
  ...
  "telemetry": {
    "application-insights": {
      "enabled": true,
      "connection-string": "@env('app-insights-connection-string')"
    }
  }
  ...
}

Si presuppone che app-insights-connection-string sia impostato come variabile di ambiente. È possibile usare un .env file per definirlo.

Cosa viene acquisito

TIPO	Descrizione
Richiedere dati di telemetria	URL, codice di stato, tempo di risposta
Telemetria di traccia	Log della console da DAB
Telemetria delle eccezioni	Errori e tracce dello stack
Contatori delle prestazioni	CPU, memoria, metriche di rete

Visualizza in Azure

1. Passare alla risorsa di Application Insights nel portale di Azure: https://portal.azure.com
2. Esaminare i log usando questa query:

traces
| order by timestamp

Mappatura del livello di log:

LogLevel	Severità	Valore
Traccia	Verbose	0
Correzione errori di programma	Verbose	0
Informazione	Informazione	1
Avvertimento	Avvertimento	2
Errore	Errore	3
Critico	Critico	4

3. Controllare le metriche in tempo reale

4. Esegui questa query per le richieste:

requests
| order by timestamp

5. Eseguire questa query per le eccezioni:

exceptions
| order by timestamp