Leggi dati di app in tempo reale con il dashboard Aspire in App contenitore di Azure

Il cruscotto di Aspire mostra dati in tempo reale su come le applicazioni e le altre risorse funzionano all'interno di un ambiente.

L'immagine seguente è uno screenshot di una visualizzazione di traccia generata dall'Aspire Dashboard.

Screenshot di una finestra di traccia di Aspire Dashboard.

Le informazioni visualizzate nel dashboard provengono da due origini:

  • OpenTelemetry (OTel), un framework open-source di osservabilità per raccogliere tracce, metriche e log dalle tue applicazioni.

    • Le tracce tengono 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.
    • Le metriche sono misurazioni in tempo reale dell'integrità generale e delle prestazioni dell'infrastruttura, ad esempio il numero di risorse 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.
    • I log registrano 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.

  • Il servizio di risorse Aspire fornisce il modello di risorsa dell'applicazione, lo stato, gli endpoint e i log della console.

Per maggiori informazioni, consulta Telemetria in Aspire ed Esplora le funzionalità del cruscotto.

Il dashboard è protetto da accessi e modifiche non autorizzati. Per usare il dashboard, un utente deve disporre delle autorizzazioni di scrittura o superiori. In altre parole, deve essere un Collaboratore o un Proprietario dell'ambiente.

Abilitare il dashboard

Suggerimento

Per gli ambienti gestiti da Aspire, configura e distribuisci il dashboard con la CLI di Aspire. Se hai problemi con il portale, crea un problema nel repository Container Apps GitHub.

È possibile abilitare l'Aspire Dashboard in qualsiasi app container esistente seguendo questi passaggi.

  1. Passare al portale Azure.

  2. Accedere all'app contenitore.

  3. Nella pagina Panoramica trovare l'etichetta Aspira dashboard e selezionare Abilita. Questa azione apre la pagina delle impostazioni del dashboard di Aspire.

  4. Nella pagina delle impostazioni, accanto all'etichetta Aspira dashboard , selezionare la casella di controllo Abilitato . È possibile ignorare le altre impostazioni in questa pagina, in quanto riguardano la registrazione anziché l'Aspire Dashboard.

  5. Nella pagina Panoramica dell'applicazione contenitore, trova l'etichetta Aspire Dashboard. Il collegamento di abilitazione è stato sostituito da un collegamento Apri dashboard . Selezionare il collegamento. Potrebbe essere necessario ricaricare la pagina Panoramica per visualizzare il collegamento.

È anche possibile trovare le impostazioni di Aspire Dashboard passando all'ambiente delle app dei contenitori e selezionando Monitoraggio>opzioni di log.

Annotazioni

I domini personalizzati non sono supportati per l'accesso alla Dashboard Aspire. È necessario usare il nome di dominio predefinito fornito da App contenitore di Azure, ad esempio: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

È possibile abilitare l'Aspire Dashboard in qualsiasi ambiente app container esistente utilizzando i comandi seguenti. Sostituisci il <PLACEHOLDERS> con i tuoi valori.

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name aspire-dashboard \
  --resource-group <RESOURCE_GROUP_NAME>

Il create comando restituisce l'URL del dashboard che è possibile aprire in un browser.

Annotazioni

I domini personalizzati non sono supportati per l'accesso alla Dashboard Aspire. È necessario usare il nome di dominio predefinito fornito da App contenitore di Azure, ad esempio: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

L'integrazione dell'ambiente App contenitore di Azure include di default la dashboard di Aspire. Per creare e distribuire un'app Aspire con la dashboard:

  1. Crea un'app starter di Aspire e aggiungi l'integrazione App contenitore di Azure:

    aspire new aspire-starter --name AspireApp --output AspireApp
cd AspireApp
aspire add Aspire.Hosting.Azure.AppContainers

  2. In AppHost.cs, aggiungi un ambiente App contenitore di Azure:

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Autentica e distribuisci:

    az login
aspire deploy

Il aspire deploy comando restituisce l'URL del dashboard che è possibile aprire in un browser. Per omettere la dashboard, concatenare .WithDashboard(false) alla risorsa dell'ambiente.

Per maggiori informazioni, vedi Deploy to App contenitore di Azure e WithDashboard.

Annotazioni

I domini personalizzati non sono supportati per l'accesso alla Dashboard Aspire. È necessario usare il nome di dominio predefinito fornito da App contenitore di Azure, ad esempio: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Risoluzione dei problemi

Se si verificano problemi nell'abilitazione del dashboard, riferirsi ai seguenti elementi:

  • L'attivazione del dashboard nel portale può richiedere fino a due minuti. Se si tenta di accedere al dashboard prima che sia pronto, il server restituisce un errore 404 o 421.

  • Se si verifica un 421 errore "Richiesta non indirizzata", 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".

    Questo problema si verifica perché le autorizzazioni del gruppo di sicurezza non vengono propagate nell'ambiente di Container App. Per risolvere questo problema, accertati di assegnarti esplicitamente un ruolo di Collaboratore o Proprietario nel tuo ambiente di Container Apps. A tale scopo, seguire questa procedura:

    • Passare alla risorsa:
      • Aprire il portale di Azure e cercare l'ambiente dell'app contenitore.
    • Pannello Controllo di accesso (IAM):
      • Fare clic su Controllo di accesso (IAM) per l'ambiente dell'app contenitore.
    • Verificare le assegnazioni di ruolo esistenti:
      • Verificare se all'utente (o all'account) sono assegnati ruoli. Si noti che le autorizzazioni non si propagano attualmente tramite gruppi di sicurezza.
      • Se non lo sei, segui i passaggi rimanenti per assegnare il ruolo.
    • Assegnazione di ruolo esplicita: - Fare clic su Aggiungi > assegnazione di ruolo. - Scegliere ruolo: Collaboratore o Proprietario, in base al livello di accesso richiesto. - Assegnare il ruolo in modo esplicito all'account utente , ad esempio youremail@domain.com.
    • Salvare e confermare:
      • Salvare le modifiche. Verificare che il ruolo sia visibile nella sezione Assegnazioni di ruolo.
    • Verificare l'accesso al dashboard:
      • Eseguire il test provando ad accedere al dashboard Aspira. Se si continua a ricevere l'errore, contattare il team.

  • I domini personalizzati non sono supportati per l'accesso alla Dashboard Aspire. È necessario usare il nome di dominio predefinito fornito da App contenitore di Azure, ad esempio: https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Contenuto correlato

Panoramica del dashboard Aspire

  • Ultimo aggiornamento: