Lisez les données d’applications en temps réel avec le tableau de bord Aspire dans Azure Container Apps

Le tableau de bord Aspire affiche des données en temps réel sur le fonctionnement des applications et autres ressources dans un environnement.

L’image suivante est une capture d’écran d’une visualisation de trace générée par le tableau de bord Aspire.

Capture d’écran d’une fenêtre de trace de tableau de bord Aspire.

Les informations affichées sur le tableau de bord proviennent de deux sources :

  • OpenTelemetry (OTel), un cadre d’observabilité open source pour collecter des traces, des métriques et des journaux à partir de vos applications.

    • Trace le cycle de vie des demandes : comment une demande est reçue et traitée à mesure qu’elle se déplace entre différentes parties de l’application. Ces informations sont utiles pour identifier les goulots d’étranglement et d’autres problèmes.
    • Les métriques sont des mesures en temps réel de l’intégrité et des performances générales de l’infrastructure , par exemple, le nombre de ressources processeur consommées et le nombre de transactions gérées par l’application par seconde. Ces informations sont utiles pour comprendre la réactivité de votre application ou identifier les signes d’avertissement précoces des problèmes de performances.
    • Enregistre tous les événements et erreurs qui se produisent pendant l’exécution de l’application. Ces informations sont utiles pour rechercher quand un problème est survenu et les événements corrélés.

  • Le service de ressources d’Aspire fournit le modèle de ressources de l’application, l’état, les points de terminaison et les journaux de la console.

Pour plus d’informations, consultez les fonctionnalités du tableau de bord Télémétrie dans Aspire et Explorer.

Le tableau de bord est sécurisé contre l’accès et la modification non autorisés. Pour utiliser le tableau de bord, un utilisateur doit disposer d’autorisations d’écriture ou d’une autorisation supérieure ; en d’autres termes, il doit s’agir d’un Contributeur ou d’un Propriétaire sur l’environnement.

Activer le tableau de bord

Conseil

Pour les environnements gérés par Aspire, configurez et déployez le tableau de bord avec la CLI Aspire. Si vous avez des problèmes avec le portail, créez un problème dans le dépôt GitHub des applications conteneures.

Vous pouvez activer le tableau de bord Aspire sur n’importe quelle application conteneur existante en procédant comme suit.

  1. Accédez au portail Azure.

  2. Naviguez vers votre application conteneur.

  3. Dans la page Vue d’ensemble , recherchez l’étiquette Du tableau de bord Aspire , puis sélectionnez Activer. Cette action ouvre la page des paramètres du tableau de bord Aspire.

  4. Dans la page paramètres, en regard de l’étiquette Du tableau de bord Aspire , cochez la case Activée . Vous pouvez ignorer les autres paramètres de cette page, car ils se rapportent à la journalisation plutôt qu’au tableau de bord Aspire.

  5. Dans la page Vue d’ensemble de votre application conteneur, recherchez l’étiquette Du tableau de bord Aspire . Le lien d’activation a été remplacé par un lien Ouvrir un tableau de bord . Sélectionnez ce lien. Vous devrez peut-être recharger la page Vue d’ensemble pour que le lien apparaisse.

Vous pouvez également trouver les paramètres du tableau de bord Aspire en accédant à votre environnement Container Apps et en sélectionnant Surveillance>options de journalisation.

Remarque

Les domaines personnalisés ne sont pas pris en charge pour accéder au tableau de bord Aspire. Vous devez utiliser le nom de domaine par défaut fourni par Azure Container Apps, par exemple : https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Vous pouvez activer le tableau de bord Aspire sur n’importe quel environnement d’application conteneur existant à l’aide des commandes suivantes. Remplacez les <PLACEHOLDERS> par vos valeurs.

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

La create commande retourne l’URL du tableau de bord que vous pouvez ouvrir dans un navigateur.

Remarque

Les domaines personnalisés ne sont pas pris en charge pour accéder au tableau de bord Aspire. Vous devez utiliser le nom de domaine par défaut fourni par Azure Container Apps, par exemple : https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

L’intégration de l’environnement Azure Container Apps inclut par défaut le tableau de bord Aspire. Pour créer et déployer une application Aspire avec le tableau de bord :

  1. Créez une application de démarrage Aspire et ajoutez l’intégration Azure Container Apps :

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

  2. En AppHost.cs, ajoutez un environnement Azure Container Apps :

    builder.AddAzureContainerAppEnvironment("aca-env");

  3. Authentifier et déployer :

    az login
aspire deploy

La aspire deploy commande retourne l’URL du tableau de bord que vous pouvez ouvrir dans un navigateur. Pour omettre le tableau de bord, enchaînez .WithDashboard(false) sur la ressource environnement.

Pour plus d’informations, voir Déployer vers Azure Container Apps et WithDashboard.

Remarque

Les domaines personnalisés ne sont pas pris en charge pour accéder au tableau de bord Aspire. Vous devez utiliser le nom de domaine par défaut fourni par Azure Container Apps, par exemple : https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Dépannage

Reportez-vous aux éléments suivants si vous rencontrez des problèmes lors de l’activation de votre tableau de bord :

  • Le portail peut prendre jusqu’à deux minutes pour activer le tableau de bord. Si vous essayez d’accéder au tableau de bord avant qu’il ne soit prêt, le serveur retourne une erreur 404 ou une erreur 421.

  • Si vous rencontrez une 421 erreur « Demande mal redirigée », fermez la fenêtre du navigateur, attendez quelques minutes, puis réessayez.

  • Vous risquez de recevoir une erreur d’authentification lorsque vous accédez au tableau de bord qui indique : « Impossible d’authentifier l’utilisateur avec la ressource demandée ».

    Ce problème se produit parce que les autorisations de groupe de sécurité ne se propagent pas à l’environnement Container Apps. Pour résoudre ce problème, veillez à vous donner explicitement un rôle Contributeur ou Propriétaire dans votre environnement Container Apps. Pour ce faire, procédez comme suit :

    • Accédez à la ressource :
      • Ouvrez le portail Azure et recherchez votre environnement d’application conteneur.
    • Accédez à la lame du contrôle d'accès (IAM) :
      • Cliquez sur Access Control (IAM) pour l’environnement d’application conteneur.
    • Vérifiez les attributions de rôles existantes :
      • Vérifiez si des rôles vous ont été attribués (ou à votre compte). Notez que les autorisations ne se propagent pas actuellement via des groupes de sécurité.
      • Si ce n’est pas le cas, suivez les étapes restantes pour attribuer le rôle.
    • Attribution de rôle explicite : - Cliquez sur Ajouter une > attribution de rôle. - Choisissez le rôle : Contributeur ou Propriétaire, selon les besoins de votre niveau d’accès requis. - Attribuez explicitement le rôle à votre compte d’utilisateur (par exemple). youremail@domain.com
    • Enregistrer et confirmer :
      • Enregistrez les modifications. Vérifiez que le rôle est visible dans la section Attributions de rôles.
    • Vérifier l’accès au tableau de bord :
      • Testez en essayant d’accéder au tableau de bord Aspire. Si vous continuez à obtenir l’erreur, veuillez contacter notre équipe.

  • Les domaines personnalisés ne sont pas pris en charge pour accéder au tableau de bord Aspire. Vous devez utiliser le nom de domaine par défaut fourni par Azure Container Apps, par exemple : https://<DOTNET_COMPONENT_NAME>.ext.<CLUSTER_NAME>.<REGION>.azurecontainerapps.io

Contenu connexe

Vue d’ensemble du tableau de bord Aspire

  • Dernière mise à jour :