Udostępnij za pośrednictwem


Rejestrowanie, metryki i alerty na platformie Azure

Aby zrozumieć, jak działa usługa platformy Azure, musisz zrozumieć, które rejestrowanie, metryki i alerty są dostępne oraz jak z nich korzystać.

Pytania dotyczące zasobów

Skorzystaj z poniższej tabeli, aby dowiedzieć się, jakie informacje można uzyskać na temat zasobów platformy Azure i dlaczego należy używać rejestrowania, metryk i alertów.

Type

Przykładowe pytania

Hosting platformy Azure

Usługi hostingowe, takie jak usługa aplikacja systemu Azure i usługa Azure Functions, udostępniają kilka form opinii, aby odpowiedzieć na pytania, takie jak:

  • Czy moja aplikacja (lub kontener) została pomyślnie wdrożona?
  • Czy moja aplikacja (lub kontener) została pomyślnie uruchomiona?
  • Czy moja aplikacja (lub kontener) działa pomyślnie?

Usługa platformy Azure

Platforma Azure oferuje metryki dla usług, dzięki czemu możesz uzyskać odpowiedzi na pytania, takie jak:

  • Jak zajęta jest usługa?
  • Jakie błędy generuje usługa?
  • Czy moja usługa jest tak zajęta, że nie może nadążyć za zapotrzebowaniem?
  • Czy osiągnięto limit przydziału transakcji dla mojej warstwy cenowej?

Zestaw Azure SDK

Zestawy SDK platformy Azure zapewniają dostęp do platformy Azure z wielu języków programowania. Zestawy SDK udostępniają rejestrowanie, aby można było zadawać pytania, takie jak:

  • Co robi sam zestaw SDK?
  • Co robi mój kod?

Kod lub kontener

Aby dowiedzieć się, jak działa twój własny kod lub kontener, zintegruj usługę Application Insights z usługi Azure Monitor. Usługa Application Insights umożliwia przechwytywanie dzienników między usługami dla pojedynczej aplikacji w celu zadawania pytań, takich jak:

  • Jakie wyjątki zgłasza mój kod?
  • Jakie zdarzenia wyzwala mój kod?
  • Jak mój kod wchodzi w interakcję z zależnościami?

Funkcje rejestrowania, metryk i alertów

Typ Dostępność opis
Metryki Podane bez konfiguracji Zacznij od metryk, ponieważ każda usługa platformy Azure ma pewne metryki, które ułatwiają ocenę jej wydajności.
Alerty Konfigurowalny Skonfiguruj alerty, aby otrzymywać powiadomienia, gdy występują zachowania ujemne lub wygasające limity przydziału.
Rejestrowanie Konfigurowalny Niektóre usługi, takie jak usługi hostingowe, mają rejestrowanie, aby ułatwić zrozumienie sposobu działania kodu lub kontenera. Przed otwarciem plików dziennika może być konieczne skonfigurowanie rejestrowania.
Rejestrowanie niestandardowe Możliwość konfigurowania za pomocą kodu Z poziomu własnego kodu możesz zalogować się do usługi Azure Monitor przy użyciu zestawu SDK usługi Application Insights dla aplikacji serwerowych i klienckich . Kod nie musi być hostowany na platformie Azure, aby zalogować się do usługi Azure Monitor.

Wyświetlanie metryk w witrynie Azure Portal

Aby wyświetlić metryki zasobu zgodnie z harmonogramem, otwórz witrynę Azure Portal i przejdź do pozycji Metryki monitorowania>.

Zrzut ekranu przedstawiający opcje wyświetlania metryk dla usług Azure Cognitive Services w witrynie Azure Portal.

Wyświetlanie alertów w witrynie Azure Portal

Ustaw alerty dotyczące zasobów w witrynie Azure Portal. Alerty mogą obejmować określone metryki, strumienie komunikacji (takie jak poczta e-mail) i częstotliwość. Typowe alerty do ustawienia to suma:

  • Żądania
  • Czas odpowiedzi
  • Błędy serwera HTTP (w środowiskach hostingu)

Zrzut ekranu witryny Azure Portal przedstawiający okienko konfigurowania logiki sygnału pod kątem błędów serwera HTTP.

Wyświetlanie dzienników usługi hostowanej w witrynie Azure Portal

Możesz skonfigurować hostowane aplikacje i kontenery, aby rejestrować informacje o:

  • Wdrożenie
  • Uruchamianie
  • Środowisko uruchomieniowe

Włącz te dzienniki, aby dowiedzieć się, jak działa hostowana aplikacja. Te dzienniki są prawdopodobnie pierwszym miejscem, w którym dowiesz się, że wdrożenie nie powiodło się lub że konfiguracja uruchamiania jest niepoprawnie skonfigurowana lub brakuje zależności.

Zaloguj się do stdout i stderr

Aplikacje internetowe platformy Azure i funkcje platformy Azure automatycznie udostępniają rejestrowanie niestandardowe w systemach stdout i stderr, jeśli używasz poprawnych funkcji rejestrowania:

  • Aplikacje internetowe używają polecenia console.log('your message here').
  • Aplikacje funkcji używają polecenia context.log('your message here').

Dodawanie rejestrowania niestandardowego

Możesz dodać bogatsze rejestrowanie niestandardowe przy użyciu usługi Application Insights w usłudze Azure Monitor. Usługa Application Insights oferuje scenariusze serwera (Node.js) i klienta (przeglądarki):

  • Dodaj zestaw SDK usługi Application Insights do kodu źródłowego.
  • Zaloguj się z Node.js przy użyciu pakietu npm.
    • Pamiętaj, aby skonfigurować zestaw SDK enableAutoCollectConsole: true Node.js za pomocą polecenia w celu zbierania dzienników konsoli niestandardowej.
  • Zaloguj się z kodu klienta przy użyciu pakietu npm.
  • Zaloguj się z klastra Kubernetes lub maszyny wirtualnej platformy Azure.

Włączanie rejestrowania aplikacji przy użyciu usługi Application Insights

W przypadku rejestrowania aplikacji usługa Application Insights może zapewnić następujące możliwości:

  • Standardowe rejestrowanie w usłudze platformy Azure i w kodzie źródłowym w zależności od inicjowania.
  • Rejestrowanie niestandardowe z potoku wdrażania i w kodzie źródłowym.

Włączanie rejestrowania aplikacji dla usługi App Service

Aby włączyć rejestrowanie hosta aplikacji w witrynie Azure Portal:

  1. Przejdź do pozycji Monitorowanie>dzienników usługi App Service, a następnie włącz rejestrowanie aplikacji dla systemu plików.
  2. Skonfiguruj wartość Limit przydziału (MB). Wartość domyślna to 35.
  3. Ustaw wartość okresu przechowywania (dni) na wartość domyślną, taką jak 3 lub 7.
  4. Wybierz pozycję Zapisz , aby rozpocząć przechwytywanie dzienników hostów.

Wyświetlanie dzienników aplikacji dla usługi App Service

Po włączeniu dzienników aplikacji dzienniki są przechowywane w folderze Logs hosta aplikacji internetowej. Wyświetl dzienniki z witryny Azure Portal lub rozszerzenia programu Visual Studio Code dla usługi App Service.

Formaty nazw plików dziennika to:

  • Wdrażania: {DATE-TIME}_{RANDOM-CHARS}_{docker}.log
  • Uruchamianie i środowisko uruchomieniowe: {DATE-TIME}_{RANDOM-CHARS}_default_docker.log

Przesyłanie strumieniowe dzienników dla usługi App Service

W przypadku usługi App Service skorzystaj z poniższej tabeli, aby dowiedzieć się więcej na temat przesyłania strumieniowego dzienników.

Metoda opis
Interfejs wiersza polecenia platformy Azure Uruchom polecenie az webapp log tail.
Rozszerzenie usługi App Service w programie Visual Studio Code Kliknij prawym przyciskiem myszy zasób, a następnie wybierz polecenie Uruchom dzienniki przesyłania strumieniowego.

Włączanie rejestrowania aplikacji dla usługi Azure Functions (plan)

Zapoznaj się z wcześniejszymi krokami, aby włączyć rejestrowanie hosta dla usługi App Service.

Włączanie rejestrowania aplikacji dla usługi Azure Functions (zużycie)

W przypadku korzystania z aplikacji funkcji opartej na użyciu, jeśli używasz rejestrowania, które udostępnia obiekt kontekstu w kodzie źródłowym, te dzienniki są wyświetlane w sekcji Monitorowanie każdej funkcji. Witryna Azure Portal udostępnia również opcję przesyłania strumieniowego dzienników w miarę przesyłania żądań do funkcji.

Wykonywanie zapytań dotyczących dzienników usługi Application Insights przy użyciu język zapytań Kusto

Jeśli używasz context.log w aplikacji funkcji lub console.log w aplikacji internetowej, a usługa Application Insights jest włączona, te dzienniki niestandardowe są dodawane do zasobu usługi Application Insights w tabeli Trace . Jeśli prefiksu dziennika niestandardowego z określonym ciągiem, takim jak JavaScript, możesz użyć język zapytań Kusto do przeszukania tabeli Trace pod kątem wszelkich komunikatów zawierających ten prefiks, gdy chcesz zmniejszyć dziennik do tylko tych wpisów niestandardowych.

traces
| where message contains "JavaScript"

Zrzut ekranu przedstawiający dziennik niestandardowy z ciągiem prefiksu.

Programowanie lokalne za pomocą usługi Application Insights

Jeśli próbujesz uruchomić usługę Application Insights lokalnie, a kod używa jednego z pakietów npm usługi Application Insights, pamiętaj, aby wywołać metodę flush() , aby rejestrowanie zostało natychmiast wysłane do usługi Application Insights. Podczas wyświetlania dzienników pamiętaj, że nadal może upłynąć kilka minut, zanim dzienniki niestandardowe będą dostępne w usłudze Application Insights.

Wyświetlanie danych niepowodzenia aplikacji w usłudze Application Insights

Aby wyświetlić błędy zasobów monitorujących w usłudze Application Insights, użyj okienka Błędy .

Zrzut ekranu przedstawiający okienko wyświetlania niepowodzeń monitorowanych zasobów usługi Application Insights.