Odczytywanie danych aplikacji w czasie rzeczywistym za pomocą pulpitu nawigacyjnego Aspire w usłudze Azure Container Apps

Panel Aspire wyświetla na żywo dane o tym, jak aplikacje i inne zasoby działają w środowisku.

Na poniższej ilustracji znajduje się zrzut ekranu wizualizacji śledzenia wygenerowanej przez Aspire Dashboard.

Zrzut ekranu okna śledzenia Aspire Dashboard.

Informacje wyświetlane na pulpicie nawigacyjnym pochodzą z dwóch źródeł:

  • OpenTelemetry (OTel), otwartoźródłowy framework obserwacji do zbierania śladów, metryk i logów z Twoich aplikacji.

    • Ślady śledzą cykl życia żądań — sposób odbierania i przetwarzania żądania w miarę przemieszczania się między różnymi częściami aplikacji. Te informacje są przydatne do identyfikowania wąskich gardeł i innych problemów.
    • Metryki to pomiary w czasie rzeczywistym ogólnej kondycji i wydajności infrastruktury — na przykład liczba wykorzystanych zasobów procesora CPU i liczba transakcji obsługiwanych przez aplikację na sekundę. Te informacje są przydatne do zrozumienia czasu odpowiedzi aplikacji lub zidentyfikowania wczesnych oznak ostrzegawczych problemów z wydajnością.
    • Dzienniki rejestrują wszystkie zdarzenia i błędy, które mają miejsce podczas uruchamiania aplikacji. Te informacje są przydatne do znajdowania, kiedy wystąpił problem i skorelowane zdarzenia.

  • Usługa zasobów Aspire dostarcza model zasobów aplikacji, status, punkty końcowe oraz logi konsolowe.

Więcej informacji znajdziesz w artykułach Telemetry in Aspire oraz Funkcje pulpitu nawigacyjnego.

Pulpit nawigacyjny jest zabezpieczony przed nieautoryzowanym dostępem i modyfikacją. Aby korzystać z pulpitu nawigacyjnego, użytkownik musi mieć uprawnienia ‘Zapis’ lub wyższe — innymi słowy, musi być współtwórcą albo właścicielem w obrębie środowiska.

Włączenie pulpitu nawigacyjnego

Napiwek

W środowiskach zarządzanych przez Aspire konfiguruj i wdrażaj pulpit za pomocą CLI Aspire. Jeśli masz problemy z korzystaniem z portalu, utwórz to w repozytorium Container Apps GitHub.

Możesz włączyć Aspire Dashboard w dowolnej istniejącej aplikacji kontenerowej, wykonując poniższe kroki.

  1. Przejdź do portalu Azure.

  2. Przejdź do aplikacji kontenera.

  3. Na stronie Przegląd znajdź etykietę Aspire Dashboard i wybierz Włącz. Ta czynność otwiera stronę ustawień dla pulpitu nawigacyjnego Aspire.

  4. Na stronie ustawień obok oznaczenia Aspire Dashboard zaznacz pole wyboru Włącz. Możesz zignorować inne ustawienia na tej stronie, ponieważ odnoszą się one do rejestrowania, a nie do pulpitu nawigacyjnego Aspiruj.

  5. Na stronie Przegląd swojej aplikacji kontenera znajdź etykietę Aspire Dashboard. Link włączania został zastąpiony linkiem Otwórz pulpit nawigacyjny . Wybierz ten link. Może być konieczne ponowne załadowanie strony Przegląd , aby pojawić się link.

Można również znaleźć ustawienia pulpitu nawigacyjnego Aspire, przechodząc do środowiska usługi Container Apps i wybierając Monitorowanie>Opcje rejestrowania.

Uwaga / Notatka

Domeny niestandardowe nie są obsługiwane w przypadku dostępu do pulpitu Aspire. Musisz użyć domyślnej nazwy domeny podanej przez Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Aspire Dashboard można włączyć w dowolnym istniejącym środowisku aplikacji kontenera za pomocą poniższych poleceń. Zastąp element <PLACEHOLDERS> swoimi wartościami.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --resource-group <RESOURCE_GROUP_NAME>

Polecenie create zwraca adres URL pulpitu nawigacyjnego, który można otworzyć w przeglądarce.

Uwaga / Notatka

Domeny niestandardowe nie są obsługiwane w przypadku dostępu do pulpitu Aspire. Musisz użyć domyślnej nazwy domeny podanej przez Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Integracja środowiska Azure Container Apps domyślnie zawiera pulpit Aspire. Aby stworzyć i wdrożyć aplikację Aspire z panelem nawigacyjnym:

  1. Stwórz aplikację startową Aspire i dodaj integrację Azure Container Apps:

    aspire new aspire-starter --name AspireApp --output AspireApp
cd AspireApp
aspire add Aspire.Hosting.Azure.AppContainers

  2. W AppHost.cs dodaj Azure Container Apps środowisko:

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Uwierzytelnij i wdroż:

    az login
aspire deploy

Polecenie aspire deploy zwraca adres URL pulpitu nawigacyjnego, który można otworzyć w przeglądarce. Aby pominąć dashboard, połącz .WithDashboard(false) się z zasobem środowiskowym.

Więcej informacji można znaleźć w Deploy to Azure Container Apps oraz WithDashboard.

Uwaga / Notatka

Domeny niestandardowe nie są obsługiwane w przypadku dostępu do pulpitu Aspire. Musisz użyć domyślnej nazwy domeny podanej przez Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Rozwiązywanie problemów

Jeśli masz problemy z włączaniem pulpitu nawigacyjnego, zapoznaj się z następującymi elementami:

  • Aktywacja pulpitu nawigacyjnego w portalu może potrwać do dwóch minut. Jeśli spróbujesz przejść do pulpitu nawigacyjnego, zanim będzie gotowy, serwer zwróci błąd 404 lub 421.

  • Jeśli wystąpi 421 błąd "Nieprawidłowe żądanie", zamknij okno przeglądarki, zaczekaj kilka minut i spróbuj ponownie.

  • Podczas próby uzyskania dostępu do pulpitu nawigacyjnego może wystąpić błąd uwierzytelniania z komunikatem: "Nie można uwierzytelnić użytkownika przy użyciu żądanego zasobu".

    Ten problem występuje, ponieważ uprawnienia grupy zabezpieczeń nie są propagowane do środowiska aplikacji kontenerowej. Aby rozwiązać ten problem, upewnij się, że jawnie nadasz sobie rolę Współautor lub Właściciel w środowisku usługi Container Apps. Można to zrobić, wykonując następujące czynności:

    • Przejdź do zasobu:
      • Otwórz portal Azure i wyszukaj środowisko aplikacji kontenera.
    • Otwórz panel Access Control (Zarządzanie dostępem i tożsamościami):
      • Kliknij Access Control (IAM) dla środowiska aplikacji kontenera.
    • Sprawdź istniejące przypisania ról:
      • Sprawdź, czy (lub twoje konto) masz przypisane jakiekolwiek role. Należy pamiętać, że uprawnienia nie są obecnie propagowane za pośrednictwem grup zabezpieczeń.
      • Jeśli tak nie jest, wykonaj pozostałe kroki, aby przypisać rolę.
    • Jawne przypisanie roli: — kliknij pozycję Dodaj > dodaj przypisanie roli. - Wybierz rolę: Współautor lub Właściciel, odpowiednio dla wymaganego poziomu dostępu. — Jawne przypisanie roli do konta użytkownika (np. youremail@domain.com).
    • Zapisz i potwierdź:
      • Zapisz zmiany. Upewnij się, że rola jest widoczna w sekcji Przypisania ról.
    • Weryfikowanie dostępu do pulpitu nawigacyjnego:
      • Przetestuj, próbując uzyskać dostęp do pulpitu nawigacyjnego Aspire. Jeśli nadal występuje błąd, skontaktuj się z naszym zespołem.

  • Domeny niestandardowe nie są obsługiwane w przypadku dostępu do pulpitu Aspire. Musisz użyć domyślnej nazwy domeny podanej przez Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Powiązana zawartość

Omówienie pulpitu nawigacyjnego Aspiruj

  • Last updated on