Verwenden von Azure Application Insights im Daten-API-Generator

Azure Application Insights ist ein Überwachungsdienst, der Telemetrie erfasst, z. B. Anforderungsdetails, Leistungsindikatoren, Protokolle und Ausnahmen. Durch die Integration in den Daten-API-Generator (DATA API Builder, DAB) können Sie Probleme diagnostizieren und das Laufzeitverhalten in der Produktion überwachen.

Warnung Application Insights wird nicht unterstützt, wenn DAB mit Azure App Service-Web-Apps gehostet wird.

Konfiguration

So konfigurieren Sie Application Insights in Ihrer DAB-Konfiguration:

CLI-Beispiel

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

JSON-Beispiel

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

Dabei wird davon ausgegangen, dass app-insights-connection-string als Umgebungsvariable festgelegt ist. Sie können eine .env Datei verwenden, um sie zu definieren.

Was erfasst wird

Typ	BESCHREIBUNG
Telemetrie anfordern	URL, Statuscode, Antwortzeit
Ablaufverfolgungstelemetrie	Konsolenprotokolle von DAB
Ausnahme-Telemetrie	Fehler und Stack-Traces
Leistungsindikatoren	CPU, Arbeitsspeicher, Netzwerkmetriken

In Azure anzeigen

1. Wechseln Sie im Azure-Portal zu Ihrer Application Insights-Ressource: https://portal.azure.com
2. Überprüfen Sie Protokolle mithilfe dieser Abfrage:

traces
| order by timestamp

LogLevel-Zuordnung:

LogLevel	Schweregrad	Wert
Trace	Ausführlich	0
Fehlersuche	Ausführlich	0
Informationen	Informationen	1
Warnung	Warnung	2
Fehler	Fehler	3
Kritisch	Kritisch	4

3. Prüfen der Live-Metriken

4. Führen Sie diese Abfrage für Anfragen aus:

requests
| order by timestamp

5. Führen Sie diese Abfrage für Ausnahmen aus:

exceptions
| order by timestamp