Partager via

Lisez les données de l’application en temps réel avec .NET Aspire Dashboard dans Azure Container Apps (préversion)

  • Article

Le tableau de bord Aspire .NET affiche des données dynamiques sur la façon dont les applications et autres ressources s’exécutent 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 .NET.

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

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

  • OpenTelemetry (OTel), une bibliothèque open source pour le suivi des traces, des métriques et des journaux pour vos applications. Cette documentation fournit plus d’informations sur la façon dont le tableau de bord Aspire s’intègre à OTel.

    • Les Traces suivent le cycle de vie des demandes : la façon dont 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.
    • Les journaux enregistrent la totalité des é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.

  • L’API Kubernetes fournit des informations sur les pods Kubernetes sous-jacents sur lesquels votre application s’exécute et leurs journaux.

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

Même si vous avez la possibilité d’utiliser le portail, l’approche recommandée pour activer votre tableau de bord est d’utiliser azd. Si vous rencontrez des problèmes en utilisant le portail, créez un problème dans le dépôt GitHub Container Apps.

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

  1. Accédez au portail Azure.

  2. Ouvrez la fenêtre vue d’ensemble de votre application conteneur.

  3. Recherchez l’étiquette Tableau de bord .NET Aspire, puis sélectionnez Activer le lien.

    Cette action ouvre la fenêtre des paramètres du tableau de bord Aspire .NET.

  4. À côté de l’étiquette Tableau de bord .NET Aspire, cochez la case Activé.

    À présent, l’URL du tableau de bord Aspire .NET s’affiche pour vous.

  5. Sélectionnez l’URL de votre tableau de bord.

Vous pouvez activer le tableau de bord .NET Aspire sur n'importe quel environnement d'application de conteneur existant à l'aide des commandes suivantes.

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

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

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

dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up

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

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 421.

  • Si vous rencontrez une erreur 421, « Requête mal dirigée », fermez la fenêtre du navigateur, attendez quelques minutes et 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 de Contributeur ou de Propriétaire sur votre environnement Container Apps. Pour ce faire, procédez comme suit :

    • Accédez au groupe de ressources :
      • Ouvrez le portail Azure et cherchez votre environnement Container Apps.
    • Accéder au panneau Contrôle d’accès (IAM) :
      • Cliquez sur Contrôle d’accès (IAM) pour l’environnement d’application conteneur.
    • Vérifier 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 > 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.

Contenu connexe

Vue d ensemble du tableau de bord .NET Aspire