Strumieniowe przesyłanie dzienników konsoli aplikacji Azure Spring Apps w czasie rzeczywistym

Uwaga

Plany Basic, Standardi Enterprise weszły w okres wycofywania 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Plan dotyczący zużycia standardowego oraz dedykowany plan zostały wycofane 30 września 2024 r., z całkowitym zamknięciem do końca marca 2025 r. Więcej informacji można znaleźć w Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy:✅ Java ✅ C#

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

W tym artykule opisano sposób włączania przesyłania strumieniowego dzienników w interfejsie wiersza polecenia platformy Azure w celu uzyskania dzienników konsoli aplikacji w czasie rzeczywistym na potrzeby rozwiązywania problemów. Możesz również użyć ustawień diagnostycznych do analizowania danych diagnostycznych w usłudze Azure Spring Apps. Aby uzyskać więcej informacji, zobacz Analizowanie dzienników i metryk przy użyciu ustawień diagnostycznych. Aby uzyskać więcej informacji na temat dzienników przesyłania strumieniowego, zobacz Stream Azure Spring Apps job logs in real time (Dzienniki zadań usługi Azure Spring Apps w czasie rzeczywistym) i Stream Azure Spring Apps managed component logs in real time (Dzienniki zarządzanych komponentów usługi Azure Spring Apps w czasie rzeczywistym).

Wymagania wstępne

• Interfejs wiersza polecenia platformy Azure z rozszerzeniem Azure Spring Apps w wersji 1.0.0 lub nowszej. Rozszerzenie można zainstalować za pomocą następującego polecenia: az extension add --name spring
• Wystąpienie usługi Azure Spring Apps z uruchomioną aplikacją. Aby uzyskać więcej informacji, zobacz Szybki start: wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps.

Przesyłanie dzienników strumieniowych

Azure portal

Wykonaj następujące kroki, aby przesyłać strumieniowo dzienniki w witrynie Azure Portal:

1. Przejdź do strony Przegląd dla wystąpienia usługi Azure Spring Apps, a następnie wybierz Aplikacje w panelu nawigacji.

2. Znajdź aplikację docelową i wybierz menu kontekstowe.

3. W wyskakującym menu kontekstowym wybierz Wyświetl strumień dziennika.

   

Domyślnie logi przesyłają strumieniowo dane dla losowo wybranego wystąpienia aplikacji. Następnie możesz wybrać swoje.

Dla wygody istnieje wiele punktów wejścia do przesyłania logów. Można je znaleźć w następujących okienkach:

• Okienko Listy aplikacji
• Okienko Lista wdrożeń
• Panel listy wystąpień aplikacji

Azure CLI

Ta sekcja zawiera przykłady użycia interfejsu wiersza polecenia platformy Azure do tworzenia dzienników końcowych. Aby uniknąć wielokrotnego określania nazwy grupy zasobów i wystąpienia usługi, użyj następujących poleceń, aby ustawić domyślną nazwę grupy zasobów i nazwę klastra:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

W poniższych przykładach pominięto grupę zasobów i nazwę usługi.

Wyświetl dziennik wyjściowy dla aplikacji z pojedynczym wystąpieniem

Jeśli aplikacja o nazwie auth-service ma tylko jedno wystąpienie, możesz wyświetlić dziennik wystąpienia aplikacji za pomocą następującego polecenia:

az spring app logs --name <application-name>

Polecenie zwraca dzienniki podobne do poniższych przykładów, gdzie auth-service jest nazwą aplikacji.

...
2020-01-15 01:54:40.481  INFO [auth-service,,,] 1 --- [main] o.apache.catalina.core.StandardService  : Starting service [Tomcat]
2020-01-15 01:54:40.482  INFO [auth-service,,,] 1 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.22]
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/uaa]  : Initializing Spring embedded WebApplicationContext
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.s.web.context.ContextLoader  : Root WebApplicationContext: initialization completed in 7203 ms

...

Wyświetlanie dziennika końcowego aplikacji z wieloma wystąpieniami

Jeśli istnieje wiele wystąpień aplikacji o nazwie auth-service, możesz wyświetlić dziennik wystąpień przy użyciu -i/--instance opcji .

Najpierw uruchom następujące polecenie, aby uzyskać nazwy wystąpień aplikacji:

az spring app show --name auth-service --query properties.activeDeployment.properties.instances --output table

Polecenie generuje wyniki podobne do następujących danych wyjściowych:

Name                                         Status    DiscoveryStatus
-------------------------------------------  --------  -----------------
auth-service-default-12-75cc4577fc-pw7hb  Running   UP
auth-service-default-12-75cc4577fc-8nt4m  Running   UP
auth-service-default-12-75cc4577fc-n25mh  Running   UP

Następnie możesz przesyłać strumieniowo dzienniki wystąpienia aplikacji w następujący sposób, przy użyciu -i/--instance opcji:

az spring app logs --name auth-service --instance auth-service-default-12-75cc4577fc-pw7hb

Możesz również uzyskać szczegółowe informacje o wystąpieniach aplikacji w witrynie Azure Portal. Po wybraniu Aplikacje w lewym okienku nawigacji usługi Azure Spring Apps, wybierz Wystąpienia aplikacji.

Ciągłe przesyłanie nowych zapisów

Domyślnie az spring app logs drukuje tylko istniejące dzienniki przesyłane strumieniowo do konsoli aplikacji, a następnie kończy działanie. Jeśli chcesz przesyłać strumieniowo nowe dzienniki, dodaj argument -f/--follow, jak pokazano w poniższym przykładzie:

az spring app logs --name auth-service --follow

Gdy używasz argumentu --follow do tworzenia natychmiastowych dzienników, usługa przesyłania strumieniowego dzienników usługi Azure Spring Apps wysyła dzienniki pulsu do klienta co minutę, chyba że aplikacja stale zapisuje dzienniki. Komunikaty dziennika pulsu używają następującego formatu: 2020-01-15 04:27:13.473: No log from server.

Użyj następującego polecenia, aby sprawdzić wszystkie obsługiwane opcje rejestrowania:

az spring app logs --help

Formatowanie dzienników strukturalnych JSON

Uwaga

Formatowanie dzienników strukturalnych JSON wymaga rozszerzenia spring w wersji 2.4.0 lub nowszej.

Ustrukturyzowane dzienniki aplikacji są wyświetlane w formacie JSON, co może być trudne do odczytania. Argumentu --format-json można użyć do formatowania dzienników w formacie JSON na bardziej czytelny format. Aby uzyskać więcej informacji, zobacz Ustrukturyzowany dziennik aplikacji dla usługi Azure Spring Apps.

W poniższym przykładzie pokazano, jak użyć argumentu --format-json :

# Raw JSON log
$ az spring app logs --name auth-service
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Disable delta property : false"}
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Single vip registry refresh property : null"}

# Formatted JSON log
$ az spring app logs --name auth-service --format-json
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Disable delta property : false
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Single vip registry refresh property : null

Argument --format-json akceptuje również opcjonalny dostosowany format przy użyciu składni ciągu formatu. Aby uzyskać więcej informacji, zobacz Składnia Łańcucha Formatu.

W poniższym przykładzie pokazano, jak używać składni formatującego ciągu znaków.

# Custom format
$ az spring app logs --name auth-service --format-json="{message}{n}"
Disable delta property : false
Single vip registry refresh property : null

Używany format domyślny to:

{timestamp} {level:>5} [{thread:>15.15}] {logger{39}:<40.40}: {message}{n}{stackTrace}

Wyświetlanie dzienników aplikacji Azure Spring Apps w instancji wstrzyknięcia do sieci wirtualnej

W przypadku wystąpienia usługi Azure Spring Apps wdrożonego w niestandardowej sieci wirtualnej, można domyślnie uzyskiwać dostęp do strumieniowania dzienników z dedykowanej sieci prywatnej. Aby uzyskać więcej informacji, zobacz Wdrażanie usługi Azure Spring Apps w sieci wirtualnej

Usługa Azure Spring Apps umożliwia również dostęp do dzienników aplikacji w czasie rzeczywistym z sieci publicznej przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Uwaga

Włączenie punktu końcowego przesyłania strumieniowego dziennika w sieci publicznej powoduje dodanie publicznego przychodzącego adresu IP do sieci wirtualnej. Pamiętaj, aby zachować ostrożność, jeśli jest to dla Ciebie problemem.

Portal Azure

Aby włączyć punkt końcowy strumieniowego przesyłania dziennika w sieci publicznej, wykonaj następujące kroki:

1. Wybierz wystąpienie usługi Azure Spring Apps wdrożone w sieci wirtualnej, a następnie wybierz pozycję Sieć w menu nawigacji.

2. Wybierz kartę Wstrzykiwanie Vnet.

3. Przełącz status zasobów płaszczyzny danych w sieci publicznej na włączony, aby umożliwić działanie punktu końcowego przesyłania strumieniowego dziennika w sieci publicznej. Ten proces trwa kilka minut.

   

Azure CLI

Użyj następującego polecenia, aby aktywować publiczny punkt końcowy dla strumienia logów:

az spring update \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --enable-dataplane-public-endpoint true

Po włączeniu publicznego punktu końcowego strumienia logów możesz uzyskać dostęp do logu aplikacji z sieci publicznej, tak jak do normalnej instancji.

Zabezpiecz ruch do publicznego punktu końcowego przesyłania strumieniowego logów

Przesyłanie strumieniowe dzienników używa tego samego klucza co testowy punkt końcowy opisany w sekcji Konfigurowanie środowiska przejściowego w usłudze Azure Spring Apps, aby uwierzytelnić połączenia z wdrożeniami. W związku z tym tylko użytkownicy, którzy mają dostęp do odczytu kluczy testowych, mogą uzyskiwać dostęp do strumieniowego przesyłania dzienników.

Aby zapewnić bezpieczeństwo aplikacji, gdy udostępniasz dla nich publiczny punkt końcowy, zabezpiecz ten punkt poprzez filtrowanie ruchu sieciowego do usługi za pomocą grupy zabezpieczeń sieciowych. Aby uzyskać więcej informacji, zobacz Samouczek: filtrowanie ruchu sieciowego za pomocą sieciowej grupy zabezpieczeń przy użyciu witryny Azure Portal. Sieciowa grupa zabezpieczeń zawiera reguły zabezpieczeń, które zezwalają na lub blokują przychodzący ruch sieciowy lub wychodzący ruch sieciowy dla kilku typów zasobów platformy Azure. Dla każdej reguły można określić źródło i obiekt docelowy, port i protokół.

Uwaga

Jeśli po włączeniu publicznego punktu końcowego strumienia dzienników nie możesz uzyskać dostępu do dzienników aplikacji w instancji wtrysku sieci wirtualnej z Internetu, sprawdź grupę zabezpieczeń sieci, aby upewnić się, że dozwolony jest taki ruch przychodzący.

W poniższej tabeli przedstawiono przykład podstawowej reguły, którą zalecamy. Aby uzyskać docelowy adres IP usługi, możesz użyć poleceń, takich jak nslookup w przypadku punktu końcowego <service-name>.private.azuremicroservices.io .

Priorytet	Nazwa	Port	Protokół	Element źródłowy	Destynacja	Akcja
100	Nazwa reguły	80	TCP	Internet	Adres IP usługi	Zezwalaj
110	Nazwa reguły	443	TCP	Internet	Adres IP usługi	Zezwól

Następne kroki

• Szybki start: monitorowanie aplikacji Platformy Azure Spring Apps przy użyciu dzienników, metryk i śledzenia
• Analizowanie dzienników i metryk przy użyciu ustawień diagnostycznych
• Wyświetlanie dzienników zadań Azure Spring Apps w czasie rzeczywistym
• Przesyłaj strumieniowo dzienniki zarządzanych składników usługi Azure Spring Apps w czasie rzeczywistym