Tableau de bord .NET.NET Aspire autonome

Le tableau de bord .NET.NET Aspire fournit une interface utilisateur idéale pour l’affichage des données de télémétrie. Tableau de bord :

• Est fourni en tant qu’image conteneur qui peut être utilisée avec n’importe quelle application OpenTelemetry activée.
• Peut être utilisé autonome, sans le rest de .NET Aspire.

Démarrer le tableau de bord

Le tableau de bord est démarré à l’aide de la ligne de commande Docker.

Bash

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

Commande Docker précédente :

• Démarre un conteneur à partir de l’image mcr.microsoft.com/dotnet/aspire-dashboard:9.0.
• Le conteneur expose deux ports :
  • Mappage du port OTLP du tableau de bord 18889 au port de l’hôte 4317. Le port 4317 reçoit des données OpenTelemetry des applications. Les applications envoient des données à l’aide du protocole OTLP (OpenTelemetry Protocol).
  • Mappage du port du tableau de bord 18888 au port de l’hôte 18888. Le port 18888 a l’interface utilisateur du tableau de bord. Accédez à http://localhost:18888 dans le navigateur pour afficher le tableau de bord.

Se connecter au tableau de bord

Les données affichées dans le tableau de bord peuvent être sensibles. Par défaut, le tableau de bord est sécurisé avec l’authentification qui nécessite un jeton pour se connecter.

Lorsque le tableau de bord est exécuté à partir d’un conteneur autonome, le jeton de connexion est imprimé dans les journaux du conteneur. Après avoir copié le jeton mis en surbrillance dans la page de connexion, sélectionnez le bouton Connexion.

Pourboire

Pour éviter la connexion, vous pouvez désactiver l’exigence d’authentification en définissant la variable d’environnement DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS sur true. Une configuration supplémentaire est disponible, consultez configuration du tableau de bord.

Pour plus d’informations sur la connexion au tableau de bord, consultez d’authentification de tableau de bord.

Explorer le tableau de bord

Le tableau de bord offre une interface utilisateur permettant d’afficher les données de télémétrie. Reportez-vous à la documentation pour explorer les fonctionnalités de télémétrie :

• page journaux structurés
• page Traces
• page Métriques

Bien qu’il n’y ait aucune restriction sur l’emplacement d’exécution du tableau de bord, le tableau de bord est conçu comme un outil de développement et de diagnostic à court terme. Le tableau de bord conserve les données de télémétrie en mémoire, ce qui crée certaines limitations :

• La télémétrie est automatiquement supprimée si limites de télémétrie sont dépassées.
• Aucune télémétrie n’est conservée lorsque le tableau de bord est redémarré.

Le tableau de bord dispose également de fonctionnalités permettant d’afficher .NET.NET Aspire ressources. Les fonctionnalités des ressources du tableau de bord sont désactivées lorsqu’elles sont exécutées en mode autonome. Pour activer l’interface utilisateur des ressources, ajouter une configuration pour un service de ressources.

Envoyer des données de télémétrie au tableau de bord

Les applications envoient des données de télémétrie au tableau de bord à l’aide de OpenTelemetry Protocol (OTLP). Le tableau de bord doit exposer un port pour recevoir des données OpenTelemetry, et les applications sont configurées pour envoyer des données à cette adresse.

Une commande Docker a été affichée précédemment pour démarrer le tableau de bord. Il a configuré le conteneur pour recevoir des données OpenTelemetry sur le port 4317. L’adresse complète du point de terminaison OTLP est http://localhost:4317.

Configurer OpenTelemetry SDK

Les applications collectent et envoient des données de télémétrie à l’aide de OpenTelemetrySDK de leur langue.

Options importantes OpenTelemetry SDK à configurer :

• Point de terminaison OTLP, qui doit correspondre à la configuration du tableau de bord, par exemple, http://localhost:4317.
• Protocole OTLP, avec le tableau de bord prenant actuellement en charge uniquement le protocole OTLP/gRPC. Configurez les applications pour utiliser le protocole grpc.

Pour configurer des applications :

• Utilisez les API OpenTelemetry SDK au sein de l’application, ou
• Démarrez l’application avec variables d’environnement connues:
  • OTEL_EXPORTER_OTLP_PROTOCOL avec une valeur de grpc.
  • OTEL_EXPORTER_OTLP_ENDPOINT avec une valeur de http://localhost:4317.

Échantillon

Pour obtenir un exemple d’utilisation du tableau de bord autonome, consultez l’exemple d’application .NET.NET Aspire tableau de bord autonome.

Étapes suivantes

Configurer le tableau de bord .NET.NET Aspire