Udostępnij przez

Odczytaj dane aplikacji w czasie rzeczywistym za pomocą Aspire Dashboard w Azure Container Apps

Dashboard Aspire wyświetla dane na żywo dotyczące działania aplikacji i innych zasobów w danym środowisku.

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

Zrzut ekranu przedstawiający okno śledzenia Aspire Dashboard.

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

  • OpenTelemetry (OTel), biblioteka typu open source do śledzenia śladów, metryk i dzienników dla aplikacji. Ta dokumentacja zawiera więcej informacji na temat integracji panelu sterowania Aspire z OTel.

    • Ś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.

  • Interfejs API platformy Kubernetes zawiera informacje o źródłowych zasobnikach Kubernetes, na których działa aplikacja, oraz ich dziennikach.

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

Jeśli masz portal jako jedną z opcji, zalecanym podejściem do włączenia pulpitu nawigacyjnego jest użycie azd. Jeśli wystąpią problemy podczas korzystania z portalu, utwórz problem w repozytorium GitHub usługi Container Apps.

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

  1. Przejdź do portalu Azure Portal.

  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 etykiety Aspire Dashboard, zaznacz pole wyboru Włączone. 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 dla 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żesz również znaleźć ustawienia Aspirowego pulpitu nawigacyjnego, przechodząc do środowiska aplikacji kontenerowych i wybierając opcję Monitorowanie>Opcje rejestrowania.

Uwaga / Notatka

Domeny niestandardowe nie są obsługiwane w przypadku uzyskiwania dostępu do pulpitu nawigacyjnego Aspirującego. Musisz użyć domyślnej nazwy domeny udostępnianej przez usługę 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 uzyskiwania dostępu do pulpitu nawigacyjnego Aspirującego. Musisz użyć domyślnej nazwy domeny udostępnianej przez usługę Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

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

dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up

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

Uwaga / Notatka

Domeny niestandardowe nie są obsługiwane w przypadku uzyskiwania dostępu do pulpitu nawigacyjnego Aspirującego. Musisz użyć domyślnej nazwy domeny udostępnianej przez usługę 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 typu 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 witrynę Azure Portal i wyszukaj środowisko aplikacji kontenera.
    • Otwórz panel Kontrola dostępu (IAM):
      • Kliknij pozycję Kontrola dostępu (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 > 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 uzyskiwania dostępu do pulpitu nawigacyjnego Aspirującego. Musisz użyć domyślnej nazwy domeny udostępnianej przez usługę Azure Container Apps, na przykład: https://<DOTNET_COMPONENT_NAMNE>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Powiązana zawartość

Omówienie pulpitu nawigacyjnego Aspiruj

  • Last updated on