Leggere i dati delle app in tempo reale con .NET Aspire Dashboard in App Contenitore di Azure (anteprima)
Il dashboard .NET Aspire visualizza i dati in tempo reale sul modo in cui le applicazioni e altre risorse vengono eseguite all'interno di un ambiente.
L'immagine seguente è uno screenshot di una visualizzazione di traccia generata da .NET Aspire Dashboard.
Le informazioni visualizzate nel dashboard provengono da due origini:
OpenTelemetry (OTel), una libreria open source per tenere traccia delle tracce, metrichee log per le applicazioni. Questa documentazione fornisce altre informazioni sul modo in cui il dashboard Aspira si integra con OTel.
- Tracce tiene traccia del ciclo di vita delle richieste: modalità di ricezione ed elaborazione di una richiesta durante lo spostamento tra diverse parti dell'applicazione. Queste informazioni sono utili per identificare i colli di bottiglia e altri problemi.
- Metriche include misurazioni in tempo reale dell'integrità generale e delle prestazioni dell'infrastruttura, ad esempio il numero di risorse della CPU utilizzate e il numero di transazioni gestite dall'applicazione al secondo. Queste informazioni sono utili per comprendere la velocità di risposta dell'app o identificare i segnali di avviso anticipato dei problemi di prestazioni.
- Log registra tutti gli eventi e gli errori che si verificano durante l'esecuzione dell'applicazione. Queste informazioni sono utili per individuare quando si è verificato un problema e gli eventi correlati.
L'API Kubernetes fornisce informazioni sui pod Kubernetes sottostanti in cui l'applicazione è in esecuzione e sui relativi log.
Il dashboard è protetto da accessi e modifiche non autorizzati. Per usare il dashboard, un utente deve disporre delle autorizzazioni di scrittura o versione successiva. In altre parole, deve essere un collaboratore o un proprietario nell'ambiente.
Abilitare il dashboard
Suggerimento
Anche se è disponibile il portale come opzione, l'approccio consigliato per abilitare il dashboard è con azd. Se si verificano problemi con il portale, creare un problema nel repository GitHub di App contenitore.
È possibile abilitare .NET Aspire Dashboard in qualsiasi app contenitore esistente seguendo questa procedura.
Vai al portale di Azure.
Aprire la finestra Panoramica dell'app contenitore.
Trovare l'etichetta .NET Aspire Dashboard e selezionare il collegamento Abilita.
Questa azione apre la finestra delle impostazioni di .NET Aspire Dashboard.
Accanto all'etichetta .NET Aspire Dashboard selezionare la casella di controllo Abilitato.
Ora viene visualizzato l'URL di .NET Aspire Dashboard.
Selezionare l'URL del dashboard.
È possibile abilitare .NET Aspire Dashboard in qualsiasi ambiente di app contenitore esistente usando i comandi seguenti.
az containerapp env dotnet-component create \
--environment <ENVIRONMENT_NAME> \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
Il comando create restituisce l'URL del dashboard che è possibile aprire in un browser.
È possibile abilitare .NET Aspire Dashboard in qualsiasi app contenitore esistente seguendo questa procedura.
dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up
Il comando up restituisce l'URL del dashboard che è possibile aprire in un browser.
Risoluzione dei problemi
Se si verificano problemi durante l'abilitazione del dashboard, vedere gli elementi seguenti:
L'attivazione del dashboard nel portale può richiedere fino a due minuti. Se si prova a passare al dashboard prima che sia pronto, il server restituisce un errore
404o421.Se si verifica un errore
421"Richiesta non indirizzata correttamente", chiudere la finestra del browser, attendere alcuni minuti e riprovare.È possibile che venga visualizzato un errore di autenticazione quando si accede al dashboard con testo analogo a "Non è possibile autenticare l'utente con la risorsa richiesta".
Per risolvere questo problema, assicurarsi di concedere i ruoli Microsoft.App/managedEnvironments/write, Collaboratore o Proprietario per l'ambiente dell'app contenitore.