Dashboard .NET.NET Aspire autonomo

Il dashboard .NET.NET Aspire offre un'interfaccia utente ottimale per la visualizzazione dei dati di telemetria. Il dashboard:

• Viene fornita come immagine contenitore che può essere usata con qualsiasi app abilitata per OpenTelemetry.
• Può essere usato autonomo, senza il rest di .NET Aspire.

Avviare il dashboard

Il dashboard viene avviato usando la riga di comando Docker.

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

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

Comando Docker precedente:

• Avvia un contenitore dall'immagine mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
• Il contenitore espone due porte:
  • Mapping della porta OTLP del dashboard 18889 alla porta dell'host 4317. La porta 4317 riceve i dati OpenTelemetry dalle app. Le app inviano dati usando OpenTelemetry Protocol (OTLP).
  • Mapping della porta del dashboard 18888 alla porta dell'host 18888. La porta 18888 ha l'interfaccia utente del dashboard. Passare a http://localhost:18888 nel browser per visualizzare il dashboard.

Accedere al dashboard

I dati visualizzati nel dashboard possono essere sensibili. Per impostazione predefinita, il dashboard è protetto con l'autenticazione che richiede un token per l'accesso.

Quando il dashboard viene eseguito da un contenitore autonomo, il token di accesso viene stampato nei log del contenitore. Dopo aver copiato il token evidenziato nella pagina di accesso, selezionare il pulsante di accesso .

Per altre informazioni sull'accesso al dashboard, vedere autenticazione del dashboard .

Esplorare il dashboard

Il dashboard offre un'interfaccia utente per la visualizzazione dei dati di telemetria. Fare riferimento alla documentazione per esplorare la funzionalità di telemetria:

• pagina Log strutturati
• pagina Tracce
• pagina Metriche

Anche se non esiste alcuna restrizione sulla posizione in cui viene eseguito il dashboard, il dashboard è progettato come strumento di diagnostica a breve termine e di sviluppo. Il dashboard rende persistenti i dati di telemetria in memoria, creando alcune limitazioni:

• La telemetria viene rimossa automaticamente se vengono superati limiti di telemetria.
• Al riavvio del dashboard non viene mantenuta alcuna telemetria.

Il dashboard include anche funzionalità per la visualizzazione delle risorse .NET.NET Aspire. Le funzionalità delle risorse del dashboard sono disabilitate quando vengono eseguite in modalità autonoma. Per abilitare l'interfaccia utente delle risorse, aggiungere la configurazione per un servizio risorse.

Inviare dati di telemetria al dashboard

Le app inviano dati di telemetria al dashboard usando OpenTelemetry Protocol (OTLP). Il dashboard deve esporre una porta per la ricezione di dati OpenTelemetry e le app sono configurate per l'invio di dati a tale indirizzo.

Un comando Docker è stato illustrato in precedenza per avviare il dashboard. Ha configurato il contenitore per ricevere dati OpenTelemetry sulla porta 4317. L'indirizzo completo dell'endpoint OTLP è http://localhost:4317.

Configurare OpenTelemetry SDK

Le app raccolgono e inviano dati di telemetria usando OpenTelemetry SDK.

Opzioni importanti OpenTelemetry SDK da configurare:

• Endpoint OTLP, che deve corrispondere alla configurazione del dashboard, ad esempio http://localhost:4317.
• Protocollo OTLP, con il dashboard che supporta attualmente solo il protocollo OTLP/gRPC. Configurare le applicazioni per l'uso del protocollo grpc.

Per configurare le applicazioni:

• Usare le API SDK di OpenTelemetry all'interno dell'applicazione o
• Avviare l'app con variabili di ambiente note:
  • OTEL_EXPORTER_OTLP_PROTOCOL con valore grpc.
  • OTEL_EXPORTER_OTLP_ENDPOINT con valore http://localhost:4317.

Campione

Per un esempio di uso del dashboard autonomo, vedere l'app di esempio di dashboard .NET.NET Aspireautonoma.

Passaggi successivi