Rozwiązywanie problemów z bramą VMware Spring Cloud Gateway

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. Aby uzyskać więcej informacji, zobacz Migrowanie planu zużycia Azure Spring Apps Standard i planu dedykowanego do usługi Azure Container Apps.

Ten artykuł dotyczy: ❎ Podstawowa/Standardowa ✅ Enterprise

W tym artykule pokazano, jak rozwiązywać problemy z usługą Spring Cloud Gateway for VMware Tanzu przy użyciu planu Usługi Azure Spring Apps Enterprise. Aby dowiedzieć się więcej na temat usługi VMware Spring Cloud Gateway, zapoznaj się z Konfigurowanie VMware Spring Cloud Gateway.

Wymagania wstępne

• Już uprzednio skonfigurowane wystąpienie planu usługi Azure Spring Apps Enterprise z włączoną usługą VMware Spring Cloud Gateway. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie i wdrażanie aplikacji w usłudze Azure Spring Apps przy użyciu planu Enterprise.
• Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej. Użyj następującego polecenia, aby zainstalować rozszerzenie Azure Spring Apps: az extension add --name spring.

Sprawdź metryki bramy

Aby uzyskać więcej informacji na temat sprawdzania metryk w portalu Azure, zobacz sekcję Common metrics w Metrykach dla usługi Azure Spring Apps.

Aby uzyskać więcej informacji na temat każdej obsługiwanej metryki, zobacz sekcję Gateway ( Metryki dla usługi Azure Spring Apps).

Sprawdź dzienniki bramy

Usługa Spring Cloud Gateway składa się z następujących podskładników:

• spring-cloud-gateway-operator służy do zarządzania Bramą.
• spring-cloud-gateway spełnia te funkcje.

Dostępne są dzienniki obu podskładników. W poniższych sekcjach opisano sposób sprawdzania tych dzienników.

Używanie przesyłania strumieniowego dzienników w czasie rzeczywistym

Dzienniki można przesyłać strumieniowo w czasie rzeczywistym za pomocą interfejsu wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz Stream Azure Spring Apps managed component logs in real time (Dzienniki składników zarządzanych usługi Azure Spring Apps w czasie rzeczywistym). W poniższych przykładach pokazano, jak używać poleceń Azure CLI do przesyłania strumieniowego nowych dzienników dla podskładników spring-cloud-gateway i spring-cloud-gateway-operator.

Użyj następującego polecenia, aby streamować dzienniki dla spring-cloud-gateway.

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway \
    --all-instances \
    --follow

Użyj następującego polecenia, aby streamować dzienniki dla spring-cloud-gateway-operator:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway-operator \
    --all-instances \
    --follow

Korzystanie z usługi Log Analytics

W poniższych sekcjach pokazano, jak wyświetlić dzienniki systemowe przy użyciu usługi Log Analytics.

Ustawienia diagnostyczne usługi Log Analytics

Przed wykonaniem zapytania dotyczącego dzienników usługi VMware Spring Cloud Gateway należy włączyć dzienniki systemowe i wysłać je do usługi Log Analytics. Aby włączyć dzienniki systemowe w witrynie Azure Portal, wykonaj następujące czynności:

1. Otwórz instancję Azure Spring Apps.

2. W menu nawigacji wybierz pozycję Ustawienia diagnostyczne.

3. Wybierz pozycję Dodaj ustawienie diagnostyczne lub wybierz pozycję Edytuj ustawienie dla istniejącego ustawienia.

4. W sekcji Dzienniki wybierz kategorię Dzienniki systemowe.

5. W sekcji Szczegóły miejsca docelowego wybierz pozycję Wyślij do obszaru roboczego usługi Log Analytics, a następnie wybierz swój obszar roboczy.

6. Wybierz pozycję Zapisz , aby zaktualizować ustawienie.

Sprawdzanie dzienników w usłudze Log Analytics

Aby sprawdzić dzienniki spring-cloud-gateway i spring-cloud-gateway-operator używając portalu Azure, wykonaj następujące kroki:

1. Upewnij się, że włączono dzienniki systemowe. Aby uzyskać więcej informacji, zobacz sekcję Ustawienia diagnostyczne dla usługi Log Analytics .

2. Otwórz instancję usługi Azure Spring Apps.

3. Wybierz pozycję Dzienniki w okienku nawigacji, a następnie wybierz pozycję Przegląd.

4. Użyj następujących przykładowych zapytań w okienku edycji zapytania. Dostosuj zakres czasu, a następnie wybierz pozycję Uruchom , aby wyszukać dzienniki.

   • Aby wyświetlić dzienniki dla spring-cloud-gateway, użyj następującego zapytania:

     AppPlatformSystemLogs
     | where LogType in ("SpringCloudGateway")
     | project TimeGenerated , ServiceName , LogType, Log , _ResourceId
     | limit 100
     

     

   • Aby wyświetlić dzienniki dla spring-cloud-gateway-operator, użyj następującego zapytania:

     AppPlatformSystemLogs
     | where LogType in ("SpringCloudGatewayOperator")
     | project TimeGenerated , ServiceName , LogType, Log , _ResourceId
     | limit 100
     

     

Uwaga

Może upłynąć kilka minut, zanim dzienniki będą dostępne w usłudze Log Analytics.

Dostosuj poziomy dziennika

W tej sekcji opisano, jak dostosować poziomy logowania dla VMware Spring Cloud Gateway, i przedstawia jeden logger jako przykład.

Ważne

Przed rozpoczęciem zapoznaj się ze szczegółami i wpływem dostosowywania poziomów dzienników, czytając sekcję Konfigurowanie poziomów dzienników w Konfigurowanie VMware Spring Cloud Gateway.

Aby dostosować poziomy dziennika, wykonaj poniższe kroki:

1. W wystąpieniu usługi Azure Spring Apps wybierz pozycję Spring Cloud Gateway w okienku nawigacji, a następnie wybierz pozycję Konfiguracja.
2. W sekcjach Właściwości wypełnij parę logging.level.org.springframework.cloud.gateway=DEBUGklucz/wartość .
3. Wybierz Zapisz, aby zapisać zmiany.
4. Po pomyślnym zakończeniu zmiany można znaleźć bardziej szczegółowe dzienniki rozwiązywania problemów, takie jak informacje o sposobie kierowania żądań.

Konfigurowanie reguł alertów

Reguły alertów można tworzyć na podstawie dzienników i metryk. Aby uzyskać więcej informacji, zobacz Tworzenie lub edytowanie reguły alertu dotyczącej metryk.

Wykonaj następujące kroki, aby bezpośrednio utworzyć reguły alertów w witrynie Azure Portal dla usługi Azure Spring Apps:

1. Otwórz swoją instancję usługi Azure Spring Apps.
2. Przejdź do Dzienniki lub Metryki.
3. Napisz zapytanie dziennika w okienku Dzienniki lub dodaj wykres metryk.
4. Wybierz przycisk Nowa reguła alertu. Ta akcja powoduje przejście do okienka tworzenia reguły alertu, a zapytanie dziennika lub metryka jest wypełniana automatycznie.

Teraz możesz skonfigurować szczegóły reguły alertu.

Monitorowanie bramy za pomocą monitora wydajności aplikacji

Aby uzyskać więcej informacji na temat obsługiwanych monitorów wydajności aplikacji i sposobu ich konfigurowania, zobacz sekcję Konfigurowanie monitorowania wydajności aplikacji w dokumencie Konfigurowanie VMware Spring Cloud Gateway.

Ponowne uruchamianie bramy

W przypadku niektórych błędów ponowne uruchomienie może pomóc rozwiązać problem. Aby uzyskać więcej informacji, zobacz sekcję Restart Spring Cloud Gateway (Ponowne uruchamianie usługi Spring Cloud Gateway) w temacie Configure VMware Spring Cloud Gateway (Konfigurowanie bramy VMware Spring Cloud Gateway).

Następne kroki

• Jak skonfigurować Spring Cloud Gateway
• Przesyłanie strumieniowe dzienników składników zarządzanych usługi Azure Spring Apps w czasie rzeczywistym