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

Diagram sekwencji przewodnika wdrażania, w tym tych lokalizacji, w kolejności: Przegląd, Planowanie, Przygotowywanie, Publikowanie, Monitorowanie i Optymalizacja. Lokalizacja "Monitor" jest obecnie wyróżniona.

Azure Application Insights to usługa zapewniana przez platformę Microsoft Azure, która umożliwia deweloperom monitorowanie i uzyskiwanie wglądu w wydajność i użycie aplikacji. W przewodniku pokazano, jak włączyć usługę Application Insights dla konstruktora interfejsu API danych (DAB). Usługa Application Insights umożliwia śledzenie dostępności aplikacji, czasów odpowiedzi, metryk wydajności, zachowania użytkownika i innych przydatnych metryk.

Warunki wstępne

Ostrzeżenie

Konstruktor interfejsu API usługi Application Insights dla danych nie jest obsługiwany podczas hostowania konstruktora interfejsu API danych w aplikacjach internetowych usługi Azure App Service.

• Uruchomione rozwiązanie przy użyciu konstruktora interfejsu API danych

Aktualizowanie pliku konfiguracji

Najpierw należy dodać sekcję application-insights do istniejącego pliku konfiguracji. Ta sekcja zawiera poświadczenia niezbędne do połączenia systemu DAB z usługą Application Insights.

1. Znajdź i otwórz istniejący plik konfiguracji rozwiązania DAB.

2. W sekcji runtime pliku konfiguracji dodaj sekcję telemetry z następującymi właściwościami.

   	Opis
   enabled	Włącza lub wyłącza usługę Application Insights
   connection-string	Parametry połączenia dla wystąpienia usługi Application Insights

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

   Napiwek

   Alternatywnie możesz użyć interfejsu wiersza polecenia języka DAB, aby dodać dane telemetryczne:

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

   Notatka

   W tym przykładzie przyjęto założenie, że host ma zmienną środowiskową nazywaną app-insights-connection-string z ciągiem połączenia. Aby uzyskać więcej informacji na temat pobierania parametrów połączenia, zobacz parametry połączenia usługi Azure Monitor.

3. Zapisz plik konfiguracji i ponownie wdróż rozwiązanie.

Przeglądanie metryk

Po włączeniu usługi Application Insights w aplikacji natychmiast rozpocznie ona wysyłanie danych do usługi Application Insights.

1. Przejdź do zasobu usługi Application Insights w witrynie Azure Portal (https://portal.azure.com).

2. Przejrzyj następujące typy danych przechwyconych przez usługę Application Insights dotyczące rozwiązania DAB.

   	Opis
   Zażądaj telemetrii	Informacje o każdym żądaniu przychodzącym do języka DAB, takie jak adres URL, czas odpowiedzi i kod stanu
   telemetria śledzenia	Dzienniki generowane przez daB
   Telemetria wyjątków	Informacje o wszelkich wyjątkach lub błędach występujących w języku DAB
   liczniki wydajności	Metryki związane z wydajnością języka DAB, takie jak użycie procesora CPU, użycie pamięci i ruch sieciowy

   Notatka

   Dzienniki wysyłane do usługi Application Insights są takie same jak dzienniki drukowane przez Data API Builder w konsoli.

3. Przejdź do sekcji dzienników na stronie usługi Application Insights. Przejrzyj dzienniki przy użyciu tego zapytania.

   traces
   | order by timestamp
   

4. Przejrzyj wyniki zapytania. LogLevel jest mapowane na poziomy ważności za pomocą tej tabeli.

   LogLevel	Poziom ważności	Wartość poziomu ważności
   Ślad	Gadatliwy	0
   Debugowanie	Gadatliwy	0
   Informacja	Informacja	1
   Ostrzeżenie	Ostrzeżenie	2
   Błąd	Błąd	3
   Krytyczny	Krytyczny	4

   Napiwek

   Ustaw bieżący poziom rejestrowania przy użyciu opcji --LogLevel dla interfejsu wiersza polecenia (CLI) DAB. W przeciwnym razie tryb hosta w pliku konfiguracji określa minimalny poziom logowania. Jeśli tryb hosta jest ustawiony na Production, minimalny poziom dziennika wynosi Error. W przypadku trybu hosta Development minimalny poziom dziennika wynosi Debug.

5. Przejdź do strony Metryki na żywo.

   

6. Sprawdź żądania aplikacji przy użyciu tego zapytania.

   requests
   | order by timestamp
   

   

7. Wyliczanie wyjątków przy użyciu strony wyjątków aplikacji.

   exceptions
   | order by timestamp
   

   

Następny krok

najlepsze rozwiązania dotyczące konfiguracji