Rozwiązywanie problemów z bramą VMware Spring Cloud Gateway
Uwaga
Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.
Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu 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, zobacz Konfigurowanie bramy VMware Spring Cloud Gateway.
Wymagania wstępne
- Już aprowizowane wystąpienie 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
.
Sprawdzanie metryk bramy
Aby uzyskać więcej informacji na temat sprawdzania metryk w witrynie Azure Portal, zobacz sekcję Common metrics (Typowe metryki) w temacie Metrics for Azure Spring Apps (Metryki 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).
Sprawdzanie dzienników bramy
Usługa Spring Cloud Gateway składa się z następujących podskładników:
spring-cloud-gateway-operator
program 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ń interfejsu wiersza polecenia platformy Azure do ciągłego przesyłania strumieniowego nowych dzienników dla podskładników spring-cloud-gateway
i spring-cloud-gateway-operator
podskładników.
Użyj następującego polecenia, aby przesłać strumieniowo dzienniki dla spring-cloud-gateway
programu :
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 przesłać strumieniowo dzienniki dla spring-cloud-gateway-operator
programu :
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:
Otwórz wystąpienie usługi Azure Spring Apps.
W menu nawigacji wybierz pozycję Ustawienia diagnostyczne.
Wybierz pozycję Dodaj ustawienie diagnostyczne lub wybierz pozycję Edytuj ustawienie dla istniejącego ustawienia.
W sekcji Dzienniki wybierz kategorię Dzienniki systemowe.
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.
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żywać witryny Azure Portal, wykonaj następujące kroki:
Upewnij się, że włączono dzienniki systemowe. Aby uzyskać więcej informacji, zobacz sekcję Ustawienia diagnostyczne dla usługi Log Analytics .
Otwórz wystąpienie usługi Azure Spring Apps.
Wybierz pozycję Dzienniki w okienku nawigacji, a następnie wybierz pozycję Przegląd.
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
programu , 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
programu , 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.
Dostosowywanie poziomów dziennika
W tej sekcji opisano sposób dostosowywania poziomów dziennika dla bramy VMware Spring Cloud Gateway i oferuje jeden rejestrator jako przykład.
Ważne
Przed rozpoczęciem zapoznaj się ze szczegółami i wpływem dostosowywania poziomów dziennika, czytając sekcję Konfigurowanie poziomów dzienników w temacie Konfigurowanie bramy VMware Spring Cloud Gateway.
Aby dostosować poziomy dziennika, wykonaj następujące czynności:
- W wystąpieniu usługi Azure Spring Apps wybierz pozycję Spring Cloud Gateway w okienku nawigacji, a następnie wybierz pozycję Konfiguracja.
- W sekcjach Właściwości wypełnij parę
logging.level.org.springframework.cloud.gateway=DEBUG
klucz/wartość . - Wybierz Zapisz, aby zapisać zmiany.
- 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ącego metryk.
Wykonaj następujące kroki, aby bezpośrednio utworzyć reguły alertów w witrynie Azure Portal dla usługi Azure Spring Apps:
- Otwórz wystąpienie usługi Azure Spring Apps.
- Przejdź do pozycji Dzienniki lub Metryki.
- Napisz zapytanie dziennika w okienku Dzienniki lub dodaj wykres metryk.
- Wybierz przycisk Nowa reguła alertu. Ta akcja powoduje przejście do okienka Tworzenie reguły alertu, a zapytanie dziennika lub metryki są wypełniane 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 temacie Konfigurowanie bramy 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).