Traçage des messages - IoT Platform - Centre de documentation Alibaba Cloud

Simple Log Service for IoT Platform vous permet de consulter les traces des messages échangés par les appareils. Utilisez un TraceID ou un MessageId pour retracer le parcours complet de tout message transitant par IoT Platform. Cette fonctionnalité facilite également l'analyse et la localisation rapides des problèmes en identifiant les nœuds défaillants. Cette rubrique explique comment afficher la trace d'un message.

Procédure

Connectez-vous à la console IoT Platform.
Sur la page Overview, repérez l'instance à gérer, puis cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, choisissez Monitoring & O&M > Simple Log Service. Sous l'onglet IoT Platform logs, identifiez le TraceID ou le MessageId du message à tracer.
Cliquez sur Message Trace. Dans la zone de recherche, saisissez le TraceID ou le MessageId.
Cliquez sur l'icône de recherche située à droite pour afficher la carte du trajet.
- La carte du trajet se compose d'icônes représentant les nœuds de communication et de lignes de connexion. La couleur verte indique un flux de communication réussi, tandis que la couleur rouge signale un échec.
- Survolez un nœud de communication pour consulter l'heure de la communication, les informations de succès ou la cause de l'échec.
Par exemple, pour les données transmises par un produit de thermostat domestique, une règle de transfert de données est configurée comme suit :

Instruction SQL pour le traitement des données :
```
SELECT 
items.temperature.value as temperature, 
items.humidity.value as humidity,
deviceName() as deviceName,
timestamp() as time 
FROM "/g***/TH_sensor/thing/event/property/post"
```
La règle transfère les données temperature, humidity, deviceName et time de la manière suivante :
- Les données sont insérées dans Tablestore, avec la clé primaire définie sur ${deviceName}.
- Les données sont publiées vers le groupe de consommateurs d'abonnement côté serveur AMQP Default Consumer Group.
- Les données sont insérées dans ApsaraDB RDS, où le champ time de la table de base de données est configuré comme clé primaire à incrémentation automatique.
- Les données sont publiées vers un autre topic : /g***/TH_sensor/user/update.
Pour plus d'informations, consultez la rubrique Définir des règles de transfert de données.

Par exemple, Une fois que l'appareil a transmis les données, la trace du message affiche les résultats suivants pour les opérations de transfert de données :
- Le traitement des messages réussit lorsqu'ils sont publiés vers un autre Topic (opération republish), insérés dans Tablestore (opération ots), ou publiés vers un groupe de consommateurs d'abonnement côté serveur AMQP.
- L'insertion des données dans ApsaraDB (opération RDS
  
  L'écriture des données dans la base de données de séries temporelles d'une instance (opération
  
  tsdb in vpc
  
  ) avec des paramètres invalides, ou
  
  ) avec une configuration de produit anormale entraîne l'échec du traitement des messages.

Étapes suivantes

Si vous identifiez un nœud défaillant dans la trace de communication, résolvez le problème en vous basant sur la cause de l'échec. Pour plus d'informations sur les méthodes de dépannage, consultez les descriptions des codes d'erreur dans la rubrique Journaux IoT Platform.

En vous appuyant sur l'exemple de carte du trajet précédent, accédez à la page Message Forwarding > Data Forwarding. Repérez la règle de transfert correspondant au paramètre ruleName et corrigez les opérations de transfert ayant échoué : Lors de l'insertion des données dans ApsaraDB RDS, supprimez la configuration de clé primaire du champ time dans la table de la base de données.

Une fois que l'appareil a de nouveau transmis des données, consultez la trace du message. Vous constaterez que le message a été traité avec succès.