Utiliser l’outil de suivi dynamique pour Azure SignalR Service
L’outil de suivi dynamique est une application web unique pour la capture et l’affichage des suivis dynamiques dans Azure SignalR Service. Les traces dynamiques peuvent être collectées en temps réel sans aucune dépendance vis-à-vis d’autres services.
Vous pouvez activer et désactiver la fonctionnalité de suivi dynamique en une seule sélection. Vous pouvez également choisir n’importe quelle catégorie de journal qui vous intéresse.
Remarque
Les suivis actifs sont comptabilisées en tant que messages sortants.
L’utilisation de Microsoft Entra ID pour accéder à l’outil de suivi dynamique n’est pas prise en charge.
Lancer l’outil de suivi dynamique
Lorsque vous activez une clé d’accès, vous utilisez un jeton d’accès pour authentifier l’outil de suivi dynamique. Sinon, vous utilisez Microsoft Entra ID pour authentifier l’outil.
Vous pouvez vérifier si vous avez activé une clé d’accès en accédant à la page Clés d’Azure SignalR Service dans le portail Azure.
Étapes si vous avez activé une clé d’accès
- Accédez au portail Azure et à votre page Azure SignalR Service.
- Dans le menu de gauche, sous Surveillance, sélectionnez Paramètres de suivi dynamique.
- Sélectionnez Activer la trace dynamique.
- Sélectionnez le bouton Enregistrer, puis attendez que les modifications prennent effet.
- Sélectionnez Ouvrir l’outil de suivi dynamique.
Étapes si vous n’avez pas activé une clé d’accès
Attribuer l’autorisation de l’API de l’outil Live Trace à vous-même
- Accédez au portail Azure et à votre page Azure SignalR Service.
- Sélectionnez Contrôle d’accès (IAM) .
- Dans la nouvelle page, sélectionnez +Ajouter, puis sélectionnez Attribution de rôle.
- Dans la nouvelle page, sélectionnez l’onglet Rôles de fonction de tâche, sélectionnez le rôle Propriétaire Azure SignalR Service, puis sélectionnez Suivant.
- Sur la page Membres, cliquez sur +Sélectionner des membres.
- Dans le nouveau panneau, recherchez et sélectionnez des membres, puis cliquez sur Sélectionner.
- Cliquez sur Vérifier + attribuer, puis attendez la notification d’achèvement.
Ouvrir l’outil
- Accédez au portail Azure et à votre page Azure SignalR Service.
- Dans le menu de gauche, sous Surveillance, sélectionnez Paramètres de suivi dynamique.
- Sélectionnez Activer la trace dynamique.
- Sélectionnez le bouton Enregistrer, puis attendez que les modifications prennent effet.
- Sélectionnez Ouvrir l’outil de suivi dynamique.
Connectez-vous avec votre compte Microsoft
- Lorsque la fenêtre de connexion Microsoft s’ouvre dans l’outil de suivi dynamique, entrez vos informations d’identification. Si aucune fenêtre de connexion n’apparaît, veillez à autoriser les fenêtres contextuelles dans votre navigateur.
- Attendez que la mention Prêt apparaisse dans la barre d’état.
Capturer des traces dynamiques
Dans l’outil de suivi dynamique, vous pouvez :
- Commencer à capturer des traces dynamiques en temps réel à partir de l’instance Azure SignalR Service.
- Effacer les traces dynamiques en temps réel capturées.
- Exporter les traces dynamiques dans un fichier. Le format de fichier actuellement pris en charge est le format .csv.
- Filtrer les traces dynamiques en temps réel capturées avec un mot clé spécifique. Les séparateurs (par exemple, espace, virgule ou point-virgule), s’ils sont présents, sont traités comme faisant partie intégrante du mot clé.
Les traces dynamiques en temps réel capturées par l’outil contiennent des informations détaillées pour la résolution des problèmes.
| Nom | Description |
|---|---|
| Heure | Heure de l’événement de journal. |
| Niveau de consignation | Niveau de l’événement de journal : Trace, Debug, Informational, Warning ou Error. |
| Nom de l’événement | Nom de l’opération de l’événement de journal. |
| Message | Message détaillé de l’événement de journal. |
| Exception | Exception d’exécution du service Azure Web PubSub. |
| Hub | Nom du hub défini par l’utilisateur. |
| ID de connexion | Identité de la connexion. |
| Type de la connexion | Type de la connexion. Les valeurs autorisées sont Server (connexions entre le serveur et le service) et Client (connexions entre le client et le service). |
| Code utilisateur | Identité de l’utilisateur. |
| IP | Adresse IP du client. |
| Serveur Sticky | Mode de routage du client. Les valeurs autorisées sont Disabled, Preferred et Required. Pour plus d’informations, consultez ServerStickyMode. |
| Transport | Transport que le client peut utiliser pour envoyer des requêtes HTTP. Les valeurs autorisées sont WebSockets, ServerSentEvents et LongPolling. Pour plus d’informations, consultez HttpTransportType. |
| ID de suivi des messages | Identificateur unique d’un message. |
| Modèle de routage | Modèle de routage de l’API. |
| méthode HTTP | Méthode HTTP POST, GET, PUT ou DELETE. |
| URL | Uniform Resource Locator. |
| ID de trace | Identificateur unique pour représenter une requête. |
| Code d’état | Code de réponse HTTP. |
| Durée | Durée entre la réception et le traitement de la demande. |
| En-têtes | Informations supplémentaires passées par le client et le serveur à l’aide d’une requête ou d’une réponse HTTP. |
| ID d’appel | Identificateur unique pour représenter une invocation (disponible uniquement pour ASP.NET SignalR). |
| Type de message | Type du message. BroadcastDataMessage, JoinGroupMessage et LeaveGroupMessage en sont des exemples. |
Étapes suivantes
Découvrez comment gérer les problèmes courants liés à l’outil de trace dynamique :
- Pour résoudre les problèmes classiques basés sur des traces dynamiques, consultez le guide de résolution des problèmes.
- Pour que l’autodiagnostic trouve la cause racine directement ou pour déterminer le problème, consultez l’introduction aux méthodes de résolution des problèmes.