Résolution des problèmes dans Azure IoT Central

Cet article inclut des conseils de résolution des problèmes de connectivité des appareils et des problèmes de configuration d’exportation de données dans vos applications IoT Central.

Problèmes de connectivité de l’appareil

Cette section vous aide à déterminer si vos données parviennent à IoT Central.

Si vous ne l'avez pas déjà fait, installez l’outil az cli et l’extension azure-iot.

Pour savoir comment installer az cli, consultez Installer Azure CLI.

Pour installer l’extension azure-iot, exécutez la commande suivante :

az extension add --name azure-iot

Après avoir installé l’extension azure-iot, démarrez votre appareil pour voir si les messages qu’il envoie parviennent à IoT Central.

Utilisez les commandes suivantes pour vous connecter à l’abonnement dans lequel se trouve votre application IoT Central :

az login
az account set --subscription <your-subscription-id>

Pour surveiller les données de télémétrie que votre appareil envoie, utilisez la commande suivante :

az iot central diagnostics monitor-events --app-id <iot-central-app-id> --device-id <device-name>

Si l’appareil s’est correctement connecté à IoT Central, une sortie similaire à l’exemple suivant s’affiche :

Monitoring telemetry.
Filtering on device: device-001
{
    "event": {
        "origin": "device-001",
        "module": "",
        "interface": "",
        "component": "",
        "payload": {
            "temp": 65.57910343679293,
            "humid": 36.16224660107426
        }
    }
}

Pour surveiller les mises à jour de propriétés que votre appareil échange avec IoT Central, utilisez la commande d’aperçu suivante :

az iot central diagnostics monitor-properties --app-id <iot-central-app-id> --device-id <device-name>

Si l’appareil envoie correctement les mises à jour de propriétés, une sortie similaire à l’exemple suivant s’affiche :

Changes in reported properties:
version : 32
{'state': 'true', 'name': {'value': {'value': 'Contoso'}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac
': 200}, 'brightness': {'value': {'value': 2}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac': 200}, 'p
rocessorArchitecture': 'ARM', 'swVersion': '1.0.0'}

Si des données s’affichent dans votre terminal, cela signifie que les données parviennent à votre application IoT Central.

Si aucune donnée ne s’affichent après quelques minutes, essayez d’appuyer sur la touche Enter ou return de votre clavier, si la sortie est bloquée.

Si les données ne s’affichent toujours pas dans votre terminal, il est probable que votre appareil rencontre des problèmes de connectivité réseau ou qu’il n’envoie pas correctement les données à IoT Central.

Vérifier l’état d’approvisionnement de votre appareil

Si vos données ne s’affichent pas dans le moniteur CLI, vérifiez l’état d’approvisionnement de votre appareil en exécutant la commande suivante :

az iot central device registration-info --app-id <iot-central-app-id> --device-id <device-name>

La sortie suivante montre un exemple d’appareil dont la connexion est bloquée :

{
  "@device_id": "v22upeoqx6",
  "device_registration_info": {
    "device_status": "blocked",
    "display_name": "Environmental Sensor - v22upeoqx6",
    "id": "v22upeoqx6",
    "instance_of": "urn:krhsi_k0u:modelDefinition:w53jukkazs",
    "simulated": false
  },
  "dps_state": {
    "error": "Device is blocked from connecting to IoT Central application. Unblock the device in IoT Central and retry. Learn more:
https://aka.ms/iotcentral-docs-dps-SAS",
    "status": null
  }
}

En savoir plus sur les valeurs d’état de l’appareil dans l’interface utilisateur et les valeurs d’état de l’appareil dans l’API REST.

Codes d’erreur

Si vous ne parvenez toujours pas à diagnostiquer la raison pour laquelle vos données ne s’affichent pas dans monitor-events, l’étape suivante consiste à rechercher les codes d’erreur signalés par votre appareil.

Démarrez une session de débogage sur votre appareil ou collectez les journaux à partir de ce dernier. Recherchez les codes d’erreur signalés par l’appareil.

Les tableaux suivants présentent les codes d’erreur courants, ainsi que les actions possibles pour les atténuer.

Si vous constatez des problèmes liés à votre flux d’authentification :

Codes détaillés d’erreur d’autorisation

Codes d’erreur de chargement du fichier

Voici une liste des codes d’erreur courants que vous pouvez voir lorsqu’un appareil tente de charger un fichier vers le cloud. N’oubliez pas que pour que votre appareil puisse charger un fichier, vous devez configurer les chargements de fichiers d’appareil dans votre application.

Problèmes de données non modélisées

Après avoir vérifié que votre appareil envoie des données à IoT Central, l’étape suivante consiste à vous assurer que votre appareil envoie des données dans un format valide.

Pour détecter les catégories dans lesquelles se manifeste votre problème, exécutez la commande Azure CLI la plus adaptée à votre scénario :

• Pour valider la télémétrie, utilisez la commande d’aperçu :

  az iot central diagnostics validate-messages --app-id <iot-central-app-id> --device-id <device-name>
  

• Pour valider les mises à jour de propriétés, utilisez la commande d’aperçu :

  az iot central diagnostics validate-properties --app-id <iot-central-app-id> --device-id <device-name>
  

Vous pouvez être invité à installer la bibliothèque uamqp la première fois que vous exécutez une commande validate.

Les trois types courants de problèmes qui empêchent les données d’appareil d’apparaître dans IoT Central sont :

• Non-concordance des données du modèle d’appareil avec l’appareil.
• Les données JSON ne sont pas valides.
• Les anciennes versions d’IoT Edge entraînent l’affichage incorrect de la télémétrie des composants sous forme de données non modélisées.

Non-concordance des données du modèle d’appareil avec l’appareil

Un appareil doit utiliser le même nom et la même casse que ceux utilisés dans le modèle d’appareil pour tous les noms de champs de télémétrie dans la charge utile qu’il envoie. La sortie suivante montre un exemple de message d’avertissement indiquant que l’appareil envoie une valeur de télémétrie appelée Temperature, au lieu de temperature :

Validating telemetry.
Filtering on device: sample-device-01.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[WARNING] [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg] Device is sending data that has not been defined in the device template. Following capabilities have NOT been defined in the device template '['Temperature']'. Following capabilities have been defined in the device template (grouped by components) '{'thermostat1': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport'], 'thermostat2': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport'], 'deviceInformation': ['manufacturer', 'model', 'swVersion', 'osName', 'processorArchitecture', 'processorManufacturer', 'totalStorage', 'totalMemory']}'. 

Un appareil doit utiliser le même nom et la même casse que ceux utilisés dans le modèle d’appareil pour tous les noms de propriété dans la charge utile qu’il envoie. La sortie suivante montre un exemple de message d’avertissement dans lequel la propriété osVersion n’est pas définie dans le modèle d’appareil :

Command group 'iot central diagnostics' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[WARNING]  [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg] Device is sending data that has not been defined in the device template. Following capabilities have NOT been defined in the device template '['osVersion']'. Following capabilities have been defined in the device template (grouped by components) '{'thermostat1': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport', 'rundiagnostics'], 'thermostat2': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport', 'rundiagnostics'], 'deviceInformation': ['manufacturer', 'model', 'swVersion', 'osName', 'processorArchitecture', 'processorManufacturer', 'totalStorage', 'totalMemory']}'.

Un appareil doit utiliser les types de données définis dans le modèle d’appareil pour les données de télémétrie ou les valeurs de propriété. Par exemple, vous voyez une incompatibilité de schéma si le type défini dans le modèle d’appareil est booléen, mais que l’appareil envoie une chaîne. La sortie suivante montre un exemple de message d’erreur dans lequel l’appareil utilise une valeur de chaîne pour une propriété qui est définie comme un double :

Command group 'iot central diagnostics' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Validating telemetry.
Filtering on device: sample-device-01.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[ERROR] [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg]  Datatype of telemetry field 'temperature' does not match the datatype double. Data sent by the device : curr_temp. For more information, see: https://aka.ms/iotcentral-payloads

Les commandes de validation signalent également une erreur si le même nom de télémétrie est défini dans plusieurs interfaces, mais que l’appareil n’est pas conforme à la norme IoT Plug and Play.

Si vous préférez utiliser une interface utilisateur graphique, utilisez la vue Données brutes IoT Central pour voir si un objet n’est pas modélisé.

Après avoir détecté le problème, vous serez peut-être amené à mettre à jour le microprogramme de l’appareil ou à créer un nouveau modèle d’appareil qui modélise les données précédemment non modélisées.

Si vous choisissez de créer un nouveau modèle qui modélise correctement les données, migrez les appareils de votre ancien modèle vers le nouveau modèle. Pour plus d’informations, consultez Gérer les appareils dans votre application Azure IoT Central.

JSON non valide

Si aucune erreur n’est signalée, mais qu’une valeur n’apparaît pas, il s’agit probablement de code JSON incorrect dans la charge utile que l’appareil envoie. Pour en savoir plus, consultez Charges utiles de télémétrie, de propriétés et de commandes.

Vous ne pouvez pas utiliser les commandes de validation ou la vue de Données brutes dans l’interface utilisateur pour détecter si l’appareil envoie un JSON mal formé.

Version d’IoT Edge

Pour afficher correctement la télémétrie des composants hébergés dans des modules IoT Edge, utilisez IoT Edge version 1.2.4 ou ultérieure. Si vous utilisez une version antérieure, la télémétrie des composants dans des modules IoT Edge s’affiche comme _unmodeleddata.

Problèmes liés à l’identité managée d’exportation de données

Vous utilisez une identité managée pour autoriser la connexion à une destination d’exportation. Les données n’arrivent pas à la destination de l’exportation.

Avant de configurer ou d’activer la destination d’exportation, assurez-vous d’effectuer les étapes suivantes :

• Activez l’identité managée pour l’application IoT Central. Pour vérifier que l’identité managée est activée, accédez à la page Identité de votre application dans le portail Azure ou utilisez la commande CLI suivante :

  az iot central app identity show --name {your app name} --resource-group {your resource group name}
  

• Configurez les autorisations pour l’identité managée. Pour afficher les autorisations attribuées, sélectionnez les attributions de rôles Azure dans la page Identité de votre application dans le portail Azure ou utilisez la commande CLI az role assignment list. Voici les autorisations nécessaires :

  Destination	Autorisation
  stockage d’objets blob Azure	Contributeur aux données Blob du stockage
  Azure Service Bus	Expéditeur de données Azure Service Bus
  Hubs d'événements Azure	Expéditeur de données Azure Event Hubs
  Explorateur de données Azure	Administrateur

  Si les autorisations n’ont pas été définies correctement avant de créer la destination dans votre application IoT Central, essayez de supprimer la destination, puis de l’ajouter à nouveau.

• Configurez des réseaux virtuels, des points de terminaison privés et des stratégies de pare-feu.

Pour en savoir plus, consultez Exporter des données.

Problèmes de connexion de destination d’exportation de données

La page de définition d’exportation affiche des informations sur les connexions ayant échoué à la destination d’exportation :

Problèmes d’exportation de données manquants

L’exportation de données exporte uniquement les données qui arrivent dans votre application après avoir activé l’exportation des données. Si vous avez besoin d’exporter des données historiques ou des données qui ont été manquées alors que votre exportation de données était temporairement désactivée, vous pouvez utiliser l’API REST IoT Central pour interroger les données de télémétrie des appareils. Utilisez une requête pour récupérer les données manquantes, puis ajoutez les données à votre destination d’exportation. Pour plus d’informations, consultez Comment utiliser l’API REST d’IoT central pour interroger des appareils.

Étapes suivantes

Si vous avez besoin d’aide supplémentaire, vous avez la possibilité de contacter les experts Azure sur les forums Microsoft Q&A et Stack Overflow. Vous pouvez également soumettre un ticket de support Azure.

Pour plus d’informations, consultez Options d’aide et de support Azure IoT.