Sdílet prostřednictvím

Samostatný řídicí panel .NET.NET Aspire

  • Článek

Řídicí panel .NET.NET Aspire poskytuje skvělé uživatelské rozhraní pro zobrazení telemetrie. Řídicí panel:

  • Dodává se jako image kontejneru, kterou lze použít s libovolnou OpenTelemetry povolenou aplikací.
  • Lze použít samostatně, bez rest.NET Aspire.

snímek obrazovky řídicího panelu .NET.NET Aspire spuštěného v samostatném režimu

Spuštění řídicího panelu

Řídicí panel se spustí pomocí příkazového řádku Docker.

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

Předchozí příkaz Docker:

  • Spustí kontejner z image mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
  • Kontejner zveřejňuje dva porty:
    • Mapování portu OTLP řídicího panelu 18889 na port hostitele 4317. Port 4317 přijímá OpenTelemetry data z aplikací. Aplikace odesílají data pomocíprotokolu (OTLP).
    • Mapování portu řídicího panelu 18888 na port hostitele 18888. Port 18888 má uživatelské rozhraní řídicího panelu. Přejděte do http://localhost:18888 v prohlížeči a zobrazte řídicí panel.

Přihlášení k řídicímu panelu

Data zobrazená na řídicím panelu můžou být citlivá. Řídicí panel je ve výchozím nastavení zabezpečený pomocí ověřování, které vyžaduje token pro přihlášení.

Při spuštění řídicího panelu ze samostatného kontejneru se přihlašovací token vytiskne do protokolů kontejneru. Po zkopírování zvýrazněného tokenu na přihlašovací stránku vyberte tlačítko Přihlášení.

snímek obrazovky s protokoly kontejneru řídicího panelu .NET.NET Aspire

Spropitné

Pokud se chcete přihlášení vyhnout, můžete požadavek na ověření zakázat nastavením proměnné prostředí DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS na true. K dispozici je další konfigurace, viz konfigurace řídicího panelu.

Další informace o přihlášení k řídicímu panelu najdete v tématu ověřování řídicího panelu.

Prozkoumání řídicího panelu

Řídicí panel nabízí uživatelské rozhraní pro zobrazení telemetrie. Informace o funkcích telemetrie najdete v dokumentaci:

I když neexistuje žádné omezení, kde se řídicí panel spouští, je řídicí panel navržený jako vývojový a krátkodobý diagnostický nástroj. Řídicí panel zachovává telemetrii v paměti, což vytváří určitá omezení:

  • Telemetrie se automaticky odebere, pokud dojde k překročení limitů telemetrie.
  • Při restartování řídicího panelu se neuchová žádná telemetrie.

Řídicí panel má také funkce pro zobrazení .NET.NET Aspire prostředků. Funkce prostředků řídicího panelu jsou při spuštění v samostatném režimu zakázané. Pokud chcete povolit uživatelské rozhraní prostředků, přidat konfiguraci proslužby prostředků .

Odeslání telemetrie na řídicí panel

Aplikace odesílají telemetrii na řídicí panel pomocíprotokolu Protocol (OTLP). Řídicí panel musí vystavit port pro příjem dat OpenTelemetry a aplikace jsou nakonfigurované tak, aby do této adresy odesílaly data.

Dříve se zobrazil příkaz Docker, který spuštění řídicího panelu. Nakonfiguroval kontejner tak, aby přijímal OpenTelemetry data na portu 4317. Úplná adresa koncového bodu OTLP je http://localhost:4317.

Konfigurace sady OpenTelemetry SDK

Aplikace shromažďují a odesílají telemetrii pomocí OpenTelemetrysady SDK jazyka.

Důležité OpenTelemetry možnosti sady SDK ke konfiguraci:

  • Koncový bod OTLP, který by měl odpovídat konfiguraci řídicího panelu, například http://localhost:4317.
  • Protokol OTLP s řídicím panelem aktuálně podporuje pouze protokol OTLP/gRPC. Nakonfigurujte aplikace tak, aby používaly protokol grpc.

Konfigurace aplikací:

  • Použití rozhraní API sady OpenTelemetry SDK v aplikaci nebo
  • Spusťte aplikaci s známými proměnnými prostředí:
    • OTEL_EXPORTER_OTLP_PROTOCOL s hodnotou grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT s hodnotou http://localhost:4317.

Ukázka

Ukázku použití samostatného řídicího panelu najdete v samostatné .NET.NET Aspire ukázkové aplikaci řídicího panelu.

Další kroky

.NET řídicího panelu .NET Aspire