Delen via

Zelfstandig .NET.NET Aspire dashboard

  • Artikel

Het .NET.NET Aspire dashboard biedt een uitstekende gebruikersinterface voor het weergeven van telemetriegegevens. Het dashboard:

  • Wordt geleverd als een containerinstallatiekopieën die kunnen worden gebruikt met elke OpenTelemetry ingeschakelde app.
  • Kan zelfstandig worden gebruikt, zonder de rest van .NET Aspire.

Een schermopname van het .NET.NET Aspire dashboard dat wordt uitgevoerd in de zelfstandige modus.

Het dashboard starten

Het dashboard wordt gestart met behulp van de Docker opdrachtregel.

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

De voorgaande Docker opdracht:

  • Start een container vanuit de mcr.microsoft.com/dotnet/aspire-dashboard:9.0-installatiekopieën.
  • De container maakt twee poorten beschikbaar:
    • De OTLP-poort van het dashboard toewijzen 18889 aan de poort van de host 4317. Poort 4317 ontvangt OpenTelemetry gegevens van apps. Apps verzenden gegevens met behulp van OpenTelemetry Protocol (OTLP).
    • De poort van het dashboard toewijzen 18888 aan de poort van de host 18888. Poort 18888 heeft de gebruikersinterface van het dashboard. Navigeer naar http://localhost:18888 in de browser om het dashboard weer te geven.

Aanmelden bij het dashboard

Gegevens die in het dashboard worden weergegeven, kunnen gevoelig zijn. Het dashboard is standaard beveiligd met verificatie waarvoor een token is vereist om zich aan te melden.

Wanneer het dashboard wordt uitgevoerd vanuit een zelfstandige container, wordt het aanmeldingstoken afgedrukt naar de containerlogboeken. Nadat u het gemarkeerde token naar de aanmeldingspagina hebt gekopieerd, selecteert u de knop Aanmelden.

Schermopname van de .NET.NET Aspire dashboardcontainerlogboeken.

Fooi

Als u de aanmelding wilt voorkomen, kunt u de verificatievereiste uitschakelen door de DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS omgevingsvariabele in te stellen op true. Aanvullende configuratie is beschikbaar. Zie dashboardconfiguratie.

Zie Dashboard-verificatievoor meer informatie over het aanmelden bij het dashboard.

Het dashboard verkennen

Het dashboard biedt een gebruikersinterface voor het weergeven van telemetrie. Raadpleeg de documentatie om de telemetriefunctionaliteit te verkennen:

Hoewel er geen beperking is voor de locatie waarop het dashboard wordt uitgevoerd, is het dashboard ontworpen als een hulpprogramma voor ontwikkeling en diagnostische gegevens op korte termijn. Het dashboard blijft telemetrie in het geheugen behouden, waardoor enkele beperkingen ontstaan:

  • Telemetrie wordt automatisch verwijderd als telemetrielimieten worden overschreden.
  • Er wordt geen telemetrie behouden wanneer het dashboard opnieuw wordt opgestart.

Het dashboard heeft ook functionaliteit voor het weergeven van .NET.NET Aspire resources. De dashboardresourcefuncties worden uitgeschakeld wanneer deze worden uitgevoerd in de zelfstandige modus. Als u de gebruikersinterface van resources wilt inschakelen, configuratie voor een resourceservice toevoegen.

Telemetrie verzenden naar het dashboard

Apps verzenden telemetrie naar het dashboard met behulp van OpenTelemetry Protocol (OTLP). Het dashboard moet een poort beschikbaar maken voor het ontvangen van OpenTelemetry gegevens en apps zijn geconfigureerd om gegevens naar dat adres te verzenden.

Er is eerder een opdracht weergegeven om het dashboardte starten. De container is geconfigureerd voor het ontvangen van OpenTelemetry gegevens op poort 4317. Het volledige adres van het OTLP-eindpunt is http://localhost:4317.

OpenTelemetry SDK configureren

Apps verzamelen en verzenden telemetrie met behulp van de OpenTelemetry SDK-van hun taal.

Belangrijke OpenTelemetry SDK-opties voor het configureren:

  • OTLP-eindpunt, dat moet overeenkomen met de configuratie van het dashboard, bijvoorbeeld http://localhost:4317.
  • OTLP-protocol, waarbij het dashboard momenteel alleen het OTLP/gRPC-protocol ondersteunt. Configureer toepassingen voor het gebruik van het grpc-protocol.

Toepassingen configureren:

  • Gebruik de OpenTelemetry SDK-API's in de toepassing of
  • Start de app met bekende omgevingsvariabelen:
    • OTEL_EXPORTER_OTLP_PROTOCOL met een waarde van grpc.
    • OTEL_EXPORTER_OTLP_ENDPOINT met een waarde van http://localhost:4317.

Monster

Zie de voorbeeld-app Standalone .NET.NET Aspire dashboardvoor een voorbeeld van het gebruik van het zelfstandige dashboard.

Volgende stappen

het .NET.NET Aspire-dashboard configureren