Korzystanie z usługi Azure Application Insights w narzędziu Data API Builder

Azure Application Insights to usługa monitorowania, która przechwytuje dane telemetryczne, takie jak szczegóły żądania, liczniki wydajności, dzienniki i wyjątki. Zintegrowanie go z narzędziem Data API Builder (DAB) ułatwia diagnozowanie problemów i monitorowanie zachowania środowiska uruchomieniowego w środowisku produkcyjnym.

Ostrzeżenie Usługa Application Insights nie jest obsługiwana, gdy język DAB jest hostowany przy użyciu aplikacji internetowych usługi Azure App Service.

Konfiguracja

Aby skonfigurować usługę Application Insights w konfiguracji DAB:

Przykład interfejsu wiersza polecenia

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

Przykład JSON

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

Przyjęto założenie, że app-insights-connection-string jest ustawiona jako zmienna środowiskowa. Możesz użyć .env pliku, aby go zdefiniować.

Co jest przechwytywane

Typ	Opis
Żądanie telemetrii	Adres URL, kod stanu, czas odpowiedzi
Telemetria śledzenia	Dzienniki konsoli z DAB
Telemetria wyjątku	Błędy i ślady stosu
Liczniki wydajności	Procesor CPU, pamięć, metryki sieci

Wyświetlanie na platformie Azure

1. Przejdź do zasobu usługi Application Insights w witrynie Azure Portal: https://portal.azure.com
2. Przejrzyj dzienniki przy użyciu tego zapytania:

traces
| order by timestamp

Mapowanie LogLevel

Poziom Logowania	Ciężkość	Wartość
Ślad	Pełne informacje	0
Debugowanie	Pełne informacje	0
Informacja	Informacja	1
Ostrzeżenie	Ostrzeżenie	2
Błąd	Błąd	3
Krytyczny	Krytyczny	4

3. Sprawdzanie metryk na żywo

4. Uruchom to zapytanie dla żądań:

requests
| order by timestamp

5. Uruchom to zapytanie pod kątem wyjątków:

exceptions
| order by timestamp