Udostępnij za pośrednictwem

Autonomiczny pulpit nawigacyjny .NET.NET Aspire

  • Artykuł

Pulpit nawigacyjny .NET.NET Aspire zapewnia doskonały interfejs użytkownika do wyświetlania danych telemetrycznych. Pulpit nawigacyjny:

  • Dostarcza jako obraz kontenera, który może być używany z dowolną OpenTelemetry włączoną aplikacją.
  • Można używać autonomicznego bez rest.NET Aspire.

Zrzut ekranu przedstawiający pulpit nawigacyjny .NET.NET Aspire uruchomiony w trybie autonomicznym.

Uruchamianie pulpitu nawigacyjnego

Pulpit nawigacyjny jest uruchamiany przy użyciu wiersza polecenia Docker.

docker run --rm -it -d \
    -p 18888:18888 \
    -p 4317:18889 \
    --name aspire-dashboard \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

Poprzednie polecenie Docker:

  • Uruchamia kontener z obrazu mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
  • Kontener uwidacznia dwa porty:
    • Mapowanie portu OTLP pulpitu nawigacyjnego 18889 na port hosta 4317. Port 4317 odbiera dane OpenTelemetry z aplikacji. Aplikacje wysyłają dane przy użyciuprotokołu Protocol (OTLP).
    • Mapowanie portu pulpitu nawigacyjnego 18888 na port hosta 18888. Port 18888 ma interfejs użytkownika pulpitu nawigacyjnego. Przejdź do http://localhost:18888 w przeglądarce, aby wyświetlić pulpit nawigacyjny.

Zaloguj się do pulpitu nawigacyjnego

Dane wyświetlane na pulpicie nawigacyjnym mogą być poufne. Domyślnie pulpit nawigacyjny jest zabezpieczony przy użyciu uwierzytelniania, które wymaga tokenu do zalogowania.

Po uruchomieniu pulpitu nawigacyjnego z autonomicznego kontenera token logowania jest drukowany w dziennikach kontenera. Po skopiowaniu wyróżnionego tokenu na stronę logowania wybierz przycisk Zaloguj się.

Zrzut ekranu przedstawiający dzienniki kontenera pulpitu nawigacyjnego .NET.NET Aspire.

Napiwek

Aby uniknąć logowania, możesz wyłączyć wymaganie uwierzytelniania, ustawiając zmienną środowiskową DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS na true. Dostępna jest dodatkowa konfiguracja. Zobacz Konfiguracja pulpitu nawigacyjnego.

Aby uzyskać więcej informacji na temat logowania się do pulpitu nawigacyjnego, zobacz Pulpit nawigacyjny uwierzytelniania.

Eksplorowanie pulpitu nawigacyjnego

Pulpit nawigacyjny oferuje interfejs użytkownika do wyświetlania danych telemetrycznych. Zapoznaj się z dokumentacją, aby zapoznać się z funkcjami telemetrii:

Chociaż nie ma żadnych ograniczeń dotyczących uruchamiania pulpitu nawigacyjnego, pulpit nawigacyjny jest zaprojektowany jako narzędzie do programowania i diagnostyki krótkoterminowej. Pulpit nawigacyjny utrzymuje dane telemetryczne w pamięci, co powoduje pewne ograniczenia:

  • Dane telemetryczne są usuwane automatycznie, jeśli limity telemetrii zostaną przekroczone.
  • Żadne dane telemetryczne nie są utrwalane po ponownym uruchomieniu pulpitu nawigacyjnego.

Pulpit nawigacyjny ma również funkcje wyświetlania .NET.NET Aspire zasobów. Funkcje zasobów pulpitu nawigacyjnego są wyłączone po uruchomieniu w trybie autonomicznym. Aby włączyć interfejs użytkownika zasobów, dodać konfigurację dla usługi zasobów.

Wysyłanie danych telemetrycznych do pulpitu nawigacyjnego

Aplikacje wysyłają dane telemetryczne do pulpitu nawigacyjnego przy użyciu protokołu OpenTelemetry (OTLP). Pulpit nawigacyjny musi uwidocznić port do odbierania OpenTelemetry danych, a aplikacje są skonfigurowane do wysyłania danych do tego adresu.

Polecenie Docker zostało pokazane wcześniej, aby uruchomić pulpit nawigacyjny. Skonfigurowano kontener do odbierania OpenTelemetry danych na porcie 4317. Pełny adres punktu końcowego OTLP jest http://localhost:4317.

Konfigurowanie zestawu SDK OpenTelemetry

Aplikacje zbierają i wysyłają dane telemetryczne przy użyciu zestawu SDK OpenTelemetry języka.

Ważne OpenTelemetry opcje zestawu SDK do skonfigurowania:

  • Punkt końcowy OTLP, który powinien być zgodny z konfiguracją pulpitu nawigacyjnego, na przykład http://localhost:4317.
  • Protokół OTLP z pulpitem nawigacyjnym obsługuje obecnie tylko protokół OTLP/gRPC. Skonfiguruj aplikacje do korzystania z protokołu grpc.

Aby skonfigurować aplikacje:

  • Używanie interfejsów API zestawu SDK OpenTelemetry w aplikacji lub
  • Uruchom aplikację przy użyciu znanych zmiennych środowiskowych:
    • OTEL_EXPORTER_OTLP_PROTOCOL z wartością grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT z wartością http://localhost:4317.

Próbka

Przykład użycia autonomicznego pulpitu nawigacyjnego można znaleźć w przykładowej aplikacji pulpitu nawigacyjnego autonomicznejautonomicznego pulpitu nawigacyjnego.

Następne kroki

.NET pulpitu nawigacyjnego .NET Aspire