Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Résolution des problèmes AWS IoT SiteWise Utilisez les informations suivantes pour résoudre les problèmes liés à AWS IoT SiteWise. **Topics** + [ # Résolution des problèmes liés à une passerelle SiteWise Edge ](troubleshooting-gateway.md) + [ # Résoudre les problèmes liés à un portail AWS IoT SiteWise ](troubleshooting-portal.md) + [ # Résoudre les problèmes liés à une action de AWS IoT SiteWise règle ](troubleshoot-rule.md) + [ # Résolution des problèmes liés aux opérations d'importation et d'exportation en masse ](troubleshooting-bulk.md) # Résolution des problèmes liés à une passerelle SiteWise Edge Résolvez les problèmes courants liés à la passerelle AWS IoT SiteWise Edge en explorant les rubriques pertinentes. Vous pouvez également consulter CloudWatch les métriques signalées par vos passerelles SiteWise Edge pour résoudre les problèmes de connectivité ou de flux de données. Pour de plus amples informations, veuillez consulter [Surveillez AWS IoT SiteWise avec Amazon CloudWatch Metrics](monitor-cloudwatch-metrics.md). **Topics** + [ ## Configuration et accès aux journaux de la passerelle SiteWise Edge ](#configure-gateway-logs) + [ ## Résolution des problèmes liés à la passerelle SiteWise Edge ](#troubleshoot-gateway-issues) + [ ## Résolution des problèmes liés à l'application AWS IoT SiteWise Edge sur Siemens Industrial Edge ](#troubleshoot-siemens-app) + [ ## Résolution des problèmes liés aux intégrations open source à la périphérie ](#open-source-troubleshooting) + [ ## AWS IoT Greengrass Problèmes de résolution des problèmes ](#troubleshoot-greengrass-issues) ## Configuration et accès aux journaux de la passerelle SiteWise Edge Avant de pouvoir consulter les journaux de la passerelle SiteWise Edge, vous devez configurer votre passerelle SiteWise Edge pour qu'elle envoie des journaux à Amazon CloudWatch Logs ou qu'elle les stocke sur le système de fichiers local. + Utilisez CloudWatch les journaux si vous souhaitez utiliser le AWS Management Console pour afficher les fichiers journaux de votre passerelle SiteWise Edge. Pour de plus amples informations, veuillez consulter [Utiliser Amazon CloudWatch Logs](gateway-cloudwatch-logs.md). + Utilisez les journaux du système de fichiers local si vous souhaitez utiliser la ligne de commande ou un logiciel local pour afficher les fichiers journaux de votre passerelle SiteWise Edge. Pour de plus amples informations, veuillez consulter [Utiliser les connexions au service AWS IoT SiteWise](gateway-local-logs.md). ## Résolution des problèmes liés à la passerelle SiteWise Edge Utilisez les informations suivantes pour résoudre les problèmes liés à la passerelle SiteWise Edge. **Topics** + [ ### Impossible de déployer des packs sur les passerelles SiteWise Edge ](#gateway-issue-ggv2-packs) + [ ### AWS IoT SiteWise ne reçoit pas de données en provenance des serveurs OPC UA ](#gateway-issue-data-streams) + [ ### Aucune donnée n'apparaît dans le tableau de bord ](#gateway-issue-no-data) + [ ### « Impossible de trouver ou de charger la classe principale » qui s'affiche dans le fichier aws.iot. SiteWiseEdgePublisher se connecte à/greengrass/v2/logserror ](#troubleshoot-java-issues) + [ ### Je vois « SESSION\$1TAKEN\$1OVER » ou « com.aws.greengrass.mqttclient ». MqttClient: Impossible de publier le message via Spooler et je vais réessayer. ' dans les journaux ](#sa-troubleshoot-multiple-use) + [ ### Je vois « com.aws.greengrass.deployment ». IotJobsHelper: aucune tâche de déploiement n'a été trouvée. ' ou « Le résultat du déploiement a déjà été signalé ». dans les journaux ](#sa-troubleshoot-reuse) + [ ### L'état « SYNC\$1FAILED » s'affiche lorsque je tente de configurer le paramètre d'horodatage dans un groupe de propriétés sur une source de données OPC UA ](#troubleshoot-gateway-sync-failed-timestamp) + [ ### Les types de données convertis ne sont pas inclus ](#troubleshoot-data-conversion) + [ ### Problèmes liés à Trust Store ](#troubleshoot-trust-stores) + [ ### Problèmes d'installation avec proxy ](#troubleshoot-proxy-during-installation) ### Impossible de déployer des packs sur les passerelles SiteWise Edge Si le composant AWS IoT Greengrass nucleus (`aws.greengrass.Nucleus`) est obsolète, il se peut que vous ne puissiez pas déployer de packs sur votre passerelle SiteWise Edge. Vous pouvez utiliser la AWS IoT Greengrass V2 console pour mettre à niveau le composant AWS IoT Greengrass Nucleus. **Pour mettre à niveau le composant AWS IoT Greengrass Nucleus (console)** 1. Accédez à la [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrassIntro). 1. Dans le volet de navigation, sous **AWS IoT Greengrass**, choisissez **Deployments.** 1. Dans la liste **des déploiements**, sélectionnez le déploiement que vous souhaitez réviser. 1. Choisissez **Réviser**. 1. Sur la page **Spécifier la cible**, choisissez **Next**. 1. Sur la page **Sélectionner les composants**, sous **Composants publics**, dans la zone de recherche, entrez**aws.greengrass.Nucleus**, puis sélectionnez **AWS.Greengrass.Nucleus**. 1. Choisissez **Suivant**. 1. Sur la page **Configurer les composants**, choisissez **Next**. 1. Sur la page **Configurer les paramètres avancés**, choisissez **Next**. 1. Sur la page **Review (Révision)**, choisissez **Deploy (Déployer)**. ### AWS IoT SiteWise ne reçoit pas de données en provenance des serveurs OPC UA Si vos AWS IoT SiteWise actifs ne reçoivent pas les données envoyées par vos serveurs OPC UA, vous pouvez effectuer des recherches dans les journaux de votre passerelle SiteWise Edge pour résoudre les problèmes. Recherchez les `swPublisher` journaux au niveau des informations qui contiennent le message suivant. ``` Emitting diagnostic name=PublishError.SomeException ``` En fonction du type de contenu *SomeException* dans le journal, utilisez les types d'exception suivants et les problèmes correspondants pour résoudre les problèmes liés à votre passerelle SiteWise Edge : + **ResourceNotFoundException**— Vos serveurs OPC UA envoient des données qui ne correspondent à aucun alias de propriété pour un actif. Cette exception peut se produire dans deux cas : + Les alias de vos propriétés ne correspondent pas exactement à vos variables OPC UA, y compris les préfixes de source que vous avez définis. Vérifiez que vos alias de propriété et vos préfixes source sont corrects. + Vous n'avez pas mappé vos variables OPC UA aux propriétés des actifs. Pour de plus amples informations, veuillez consulter [Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md). Si vous avez déjà mappé toutes les variables OPC UA que vous souhaitez inclure AWS IoT SiteWise, vous pouvez filtrer les variables OPC UA envoyées par la passerelle SiteWise Edge. Pour de plus amples informations, veuillez consulter [Utiliser les filtres de nœuds OPC UA dans Edge SiteWise](opc-ua-node-filters.md). + **InvalidRequestException**— Les types de données de vos variables OPC UA ne correspondent pas aux types de données des propriétés de vos actifs. Par exemple, si une variable OPC UA possède un type de données entier, la propriété d'actif correspondante doit être de type entier. Une propriété d'actif de type double ne peut pas recevoir de valeurs entières OPC UA. Pour résoudre ce problème, définissez de nouvelles propriétés avec les types de données corrects. + **TimestampOutOfRangeException**— Votre passerelle SiteWise Edge envoie des données qui se situent en dehors de la plage d' AWS IoT SiteWise acceptation. AWS IoT SiteWise rejette tous les points de données dont l'horodatage est antérieur à 7 jours dans le passé ou inférieur à 5 minutes dans le futur. En cas de perte d'alimentation ou de connexion au AWS cloud de votre passerelle SiteWise Edge, vous devrez peut-être vider le cache de votre passerelle SiteWise Edge. + **ThrottlingException**ou **LimitExceededException**: votre demande a dépassé un quota de AWS IoT SiteWise service, tel que le taux de points de données ingérés ou le taux de demandes pour les opérations de l'API de données relatives aux propriétés des actifs. Vérifiez que votre configuration ne dépasse pas le [AWS IoT SiteWise quotas](endpoints-and-quotas.md#quotas). ### Aucune donnée n'apparaît dans le tableau de bord Si aucune donnée n'apparaît dans votre tableau de bord, il est possible que la **configuration de l'éditeur** et la **source de données** de la passerelle SiteWise Edge ne soient pas synchronisées. S'ils ne sont pas synchronisés, la mise à jour du nom de la source de données peut accélérer la synchronisation entre le cloud et le périphérique, corrigeant ainsi l'erreur de désynchronisation. **Pour mettre à jour le nom d'une source de données** 1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Sélectionnez la passerelle SiteWise Edge connectée au tableau de bord. 1. Sous **Sources de données**, sélectionnez **Modifier**. 1. Sélectionnez un nouveau **nom** de source, puis sélectionnez **Enregistrer** pour confirmer votre modification. 1. Vérifiez vos modifications en confirmant que le nom de la source de données a été mis à jour dans le tableau **des sources de données**. ### « Impossible de trouver ou de charger la classe principale » qui s'affiche dans le fichier aws.iot. SiteWiseEdgePublisher se connecte à/greengrass/v2/logserror Si cette erreur s'affiche, vous devrez peut-être mettre à jour la version Java de votre passerelle SiteWise Edge. + Depuis un terminal, exécutez la commande suivante : ``` java -version ``` La version de Java avec SiteWise laquelle votre passerelle Edge est exécutée s'affichera sous`OpenJDK Runtime Environment`. Vous verrez une réponse semblable à la suivante : ``` openjdk version "11.0.20" 2023-07-18 LTS OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node) ``` Si vous utilisez la version 11.0.20.8.1 de Java, vous devez mettre à jour le pack IoT SiteWise Publisher vers la version 2.4.1 ou une version ultérieure. Seule la version 11.0.20.8.1 de Java est affectée. Les environnements dotés d'autres versions de Java peuvent continuer à utiliser les anciennes versions du composant IoT SiteWise Publisher. Pour plus d'informations sur la mise à jour d'un pack de composants, consultez[Modifier la version des packs de composants de la passerelle SiteWise Edge](manage-gateways-ggv2.md#manage-gateway-update-packs). ### Je vois « SESSION\$1TAKEN\$1OVER » ou « com.aws.greengrass.mqttclient ». MqttClient: Impossible de publier le message via Spooler et je vais réessayer. ' dans les journaux Si un avertissement `SESSION_TAKEN_OVER` ou une erreur s'affiche `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.` dans vos journaux à l'adresse`/greengrass/v2/logs/greengrass.log`, vous essayez peut-être d'utiliser le même fichier de configuration pour plusieurs passerelles SiteWise Edge sur plusieurs appareils. Chaque passerelle SiteWise Edge a besoin d'un fichier de configuration unique pour se connecter à votre AWS compte. ### Je vois « com.aws.greengrass.deployment ». IotJobsHelper: aucune tâche de déploiement n'a été trouvée. ' ou « Le résultat du déploiement a déjà été signalé ». dans les journaux Si vous voyez `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` ou `Deployment result already reported.` dans vos journaux à l'`/greengrass/v2/logs/greengrass.log`adresse, vous essayez peut-être de réutiliser le même fichier de configuration. Les solutions sont multiples : + Si vous souhaitez réutiliser le fichier de configuration, procédez comme suit : 1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Choisissez la passerelle SiteWise Edge que vous souhaitez réutiliser. 1. Choisissez l'onglet **Mises à jour**. 1. Sélectionnez une autre version de Publisher et choisissez **Déployer**. Suivez les étapes décrites [Créez une passerelle pour Siemens Industrial Edge](sa-create-config.md) pour créer un nouveau fichier de configuration. ### L'état « SYNC\$1FAILED » s'affiche lorsque je tente de configurer le paramètre d'horodatage dans un groupe de propriétés sur une source de données OPC UA Lors de la AWS IoT SiteWise mise à jour du composant collecteur OPC UA AWS IoT Greengrass dans la version 2.5.0, nous avons introduit une nouvelle option de configuration d'horodatage. Vous pouvez utiliser l'horodatage de votre appareil ou celui du serveur. Les anciennes versions du composant collecteur OPC UA ne prennent pas en charge cette option et ne se synchronisent pas. Il existe deux méthodes pour résoudre un échec de l'état de synchronisation des sources de données. La méthode recommandée consiste à mettre à niveau le composant collecteur IoT SiteWise OPC UA vers la version 2.5.0 ou supérieure. Vous pouvez également continuer à utiliser l'ancienne version du composant du collecteur OPC UA, si vous définissez l'horodatage sur. `Source` Pour savoir comment mettre à niveau le composant collecteur IoT SiteWise OPC UA, voir[Mettre à jour la version d'un AWS IoT SiteWise composant](manage-gateways-ggv2.md#update-component-version). Nous vous recommandons d'utiliser les dernières versions de tous les composants. **Note** Il n'y a aucune interruption de données en cas d'échec de l'état de synchronisation d'une source de données. Les données sources continuent d'affluer vers AWS IoT SiteWise. La configuration ne se synchronise tout simplement pas avec le composant collecteur IoT SiteWise OPC UA de votre AWS IoT Greengrass V2 déploiement. **Pour modifier la configuration d'horodatage d'un groupe de propriétés** 1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Sélectionnez la passerelle à modifier. 1. Dans la section **Sources de données**, sélectionnez la source de données dont l'état de synchronisation a échoué, puis choisissez **Modifier**. 1. Développez **la configuration avancée**, puis développez **les paramètres du groupe**. 1. **Dans **Horodatage**, sélectionnez Source.** La sélection de **Source** supprime la `timestampToReturn` propriété de la configuration. Ce paramètre active la collecte de l'horodatage de la source de données à partir de votre appareil par défaut, ce qui permet à la source de données de se synchroniser avec le composant collecteur IoT SiteWise OPC UA. 1. Choisissez **Enregistrer**. ### Les types de données convertis ne sont pas inclus Si un message d'erreur s'affiche lors de la conversion de types de données OPC UA non pris en charge en chaînes de caractères AWS IoT SiteWise, plusieurs raisons peuvent s'expliquer : + Le type de données que vous essayez de convertir est un type de données complexe. Les types de données complexes ne sont pas pris en charge. + Lorsque vous utilisez **Destinations** en tant que **AWS IoT SiteWise mémoire tampon à l'aide d'Amazon S3**, la valeur de chaîne complète est préservée dans les fichiers transférés vers un compartiment Amazon S3. Lorsque vous ingérez ultérieurement des données dans AWS IoT SiteWise, les valeurs de chaîne complètes de plus de 1 024 octets sont rejetées. ### Problèmes liés à Trust Store Si vous rencontrez des problèmes liés aux magasins de confiance dans SiteWise Edge, suivez les étapes de résolution des problèmes suivantes : + Vérifiez que le certificat de l'autorité de certification AWS IoT Greengrass racine est présent et correctement formaté dans les magasins de confiance appropriés + Assurez-vous que le KeyStore mot de passe Java est correctement défini et accessible aux composants SiteWise Edge + Vérifiez que tous les certificats personnalisés (par exemple pour les proxys HTTPS) sont au bon format (généralement PEM) et correctement importés dans les magasins de confiance + Vérifiez que les magasins de confiance disposent des autorisations de fichier correctes et sont accessibles aux processus SiteWise Edge + Consultez les journaux SiteWise Edge pour détecter toute erreur SSL/TLS associée, qui pourrait indiquer des problèmes liés au Trust Store + Testez SSL/TLS les connexions de manière indépendante à l'aide `openssl` d'outils tels que la vérification des fonctionnalités de Trust Store ### Problèmes d'installation avec proxy Si vous rencontrez des problèmes lors du processus de configuration du proxy, considérez les étapes de résolution des problèmes suivantes : + Vérifiez que l'URL du proxy est correctement formatée et inclut le schéma approprié (`http://`ou`https://`) + Assurez-vous que toutes les informations d'identification du proxy sont codées en URL si elles contiennent des caractères spéciaux + Vérifiez que la liste des adresses sans proxy inclut toutes les adresses locales et points de terminaison de AWS service nécessaires + Pour les proxys HTTPS, vérifiez que le certificat CA fourni est au format PEM + Consultez les journaux d'installation pour détecter les messages d'erreur spécifiques susceptibles d'indiquer la source du problème + Testez la connexion proxy de manière indépendante pour vous assurer qu'elle fonctionne correctement ## Résolution des problèmes liés à l'application AWS IoT SiteWise Edge sur Siemens Industrial Edge Pour résoudre les problèmes liés à l'application AWS IoT SiteWise Edge sur votre Siemens Industrial Edge appareil, vous pouvez accéder aux journaux de l'application via le portail Siemens Industrial Edge Management ou le portail Siemens Industrial Edge Device (IED). Pour plus d'informations, consultez la section [Téléchargement des journaux](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html) dans la documentation de Siemens. ### Mes données ne s'affichent pas dans AWS IoT SiteWise + Assurez-vous qu'il n'y a aucun problème avec vos Databus utilisateurs et que l'icône en forme de coche correspondant à la **configuration de base** de données est verte plutôt que grise. + Il se peut que vous n'Siemens Industrial Edge Managementutilisiez pas une version contenantSecure Storage. Mettez à niveau votre version du système d'exploitation Siemens. Pour de plus amples informations, veuillez consulter [Siemens Secure Storageet l'application AWS IoT SiteWise Edge](sitewise-edge-on-siemens.md#sa-secure-storage). ### Je vois « Fichier de configuration manquant AWS\$1REGION » dans les journaux Si vous voyez `Config file missing AWS_REGION` dans les journaux de Siemens que le JSON du fichier de configuration est endommagé. Vous devez créer un nouveau fichier de configuration. Suivez les étapes décrites [Créez une passerelle pour Siemens Industrial Edge](sa-create-config.md) pour créer un nouveau fichier de configuration. ### Un message d'erreur « Désynchronisation » s'affiche sur la configuration de la passerelle Edge Si un message d'`Out of sync`erreur s'affiche sur votre Siemens Industrial Edge passerelle une fois le déploiement terminé, cela signifie que le composant SiteWise éditeur IoT n'est pas synchronisé avec votre passerelle. Le composant SiteWise éditeur IoT fonctionne en arrière-plan sur les Siemens Industrial Edge passerelles pour fournir des fonctionnalités thématiques MQTT. Nous avons mis à niveau Siemens Industrial Edge les passerelles pour utiliser l'espace de noms des capacités `iotsitewise:publisher:3` plutôt que. `iotsitewise:publisher:2` Vous pouvez effectuer une mise à jour vers la dernière version de l'éditeur pour résoudre ce problème. **Pour passer à la dernière version de l' SiteWise éditeur IoT** 1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Sélectionnez la Siemens Industrial Edge passerelle à modifier. 1. Dans la section **Fonctionnalités Edge**, sélectionnez **Afficher les versions du logiciel**. 1. Sélectionnez la dernière version de l' SiteWise éditeur IoT dans le menu déroulant **Publisher**. 1. Sélectionnez **Exécuté**. ## Résolution des problèmes liés aux intégrations open source à la périphérie Cette section fournit des solutions aux problèmes courants que vous pouvez rencontrer lors de l'intégration d'outils open source à SiteWise Edge. **Note** Node-RED®, InfluxDB® et Grafana® ne sont ni des fournisseurs ni des fournisseurs d'Edge. SiteWise ### Problèmes de connexion Node-RED ne peut pas se connecter au courtier MQTT Vérifiez que le broker MQTT est en cours d'exécution et qu'il est accessible sur le port spécifié. Vérifiez la configuration de votre réseau et assurez-vous que l'adresse du courtier est correcte. Pour vérifier l'état du broker MQTT, exécutez : ``` docker ps | grep emqx ``` Erreurs de connexion InfluxDB Assurez-vous que votre jeton d'authentification est valide et que vous avez spécifié les noms d'organisation et de compartiment corrects. Vérifiez qu'InfluxDB est en cours d'exécution et accessible. Pour vérifier l'état d'InfluxDB, exécutez : ``` curl -I http://localhost:8086 ``` Grafana ne peut pas se connecter à InfluxDB Vérifiez que la configuration de la source de données InfluxDB dans Grafana est correcte, y compris l'URL, le jeton d'authentification, l'organisation et le compartiment. ### Problèmes de flux de données Aucune donnée n'apparaît dans AWS IoT SiteWise Vérifiez que l'alias de votre propriété dans le flux Node-RED correspond au format attendu. Vérifiez que la structure des rubriques MQTT est correcte et que la passerelle SiteWise Edge est correctement configurée pour recevoir les données du courtier MQTT. Aucune donnée SiteWise Edge stockée dans InfluxDB Vérifiez que le flux de rétention Node-RED est correctement configuré et que le nœud d'écriture InfluxDB possède les paramètres de bucket et de mesure appropriés. Vérifiez la sortie de débogage de Node-RED pour détecter toute erreur. Erreurs de format de données Assurez-vous que vos fonctions de transformation des données convertissent correctement les données entre les formats. Utilisez les nœuds de débogage Node-RED pour inspecter les données à chaque étape du flux. ### Problèmes de performance Utilisation élevée du processeur ou de la mémoire Surveillez l'utilisation des ressources et ajustez la configuration de vos composants selon les besoins. Envisagez de réduire la fréquence de collecte des données ou de mettre en œuvre un filtrage des données pour réduire la charge de traitement. Pour surveiller l'utilisation des ressources, exécutez : ``` docker stats ``` Chargement lent du tableau de bord Grafana Optimisez vos requêtes InfluxDB et envisagez d'ajouter des limites de plage de temps à vos panneaux de tableau de bord. Réduisez le nombre de points de données affichés en utilisant les fonctions d'agrégation appropriées. ### Journalisation et diagnostic Pour résoudre les problèmes, consultez les journaux de chaque composant : Logs Nœud-Red Affichez les journaux dans la console Node-RED ou exécutez : ``` docker logs node-red ``` Journaux InfluxDB Accédez aux journaux en exécutant : ``` docker logs influxdb ``` Blogs Grafana Afficher les journaux en exécutant : ``` docker logs grafana ``` SiteWise Journaux Edge Consultez les journaux de la passerelle SiteWise Edge pour détecter les problèmes de connexion MQTT et de traitement des données. Pour de plus amples informations, veuillez consulter [Résolution des problèmes liés à une passerelle SiteWise Edge](#troubleshooting-gateway). ## AWS IoT Greengrass Problèmes de résolution des problèmes Pour trouver des solutions à de nombreux problèmes liés à la configuration ou au déploiement de votre passerelle SiteWise Edge AWS IoT Greengrass, consultez la section [Résolution des problèmes AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html) dans le *Guide du AWS IoT Greengrass développeur*. # Résoudre les problèmes liés à un portail AWS IoT SiteWise Résolvez les problèmes courants liés à vos AWS IoT SiteWise portails. ## Les utilisateurs et les administrateurs ne peuvent pas accéder au AWS IoT SiteWise portail Si les utilisateurs ou les administrateurs ne peuvent pas accéder à votre AWS IoT SiteWise portail, il se peut que vous disposiez d'autorisations restreintes dans le cadre de politiques associées Gestion des identités et des accès AWS (IAM) qui empêchent les connexions réussies. Consultez les exemples suivants de politiques IAM susceptibles d'entraîner un échec de connexion : **Note** Toute politique IAM attachée qui inclut un `"Condition"` élément entraînera un échec de connexion. **Exemple 1** : La condition ici est une adresse IP limitée, ce qui entraînera un échec de connexion. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "IpAddress": { "aws:SourceIp": [ "203.0.113.0/24" ] } } } ] } ``` ------ **Exemple 2** : La condition ici est une balise incluse, ce qui provoquera un échec de connexion. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "StringLike": { "aws:ResourceTag/project": "*" } } } ] } ``` ------ Lorsque vous ajoutez des utilisateurs ou des administrateurs au portail, évitez de créer des politiques IAM qui limitent les autorisations des utilisateurs, telles qu'une adresse IP limitée. Les politiques associées avec des autorisations restreintes ne pourront pas se connecter au AWS IoT SiteWise portail. # Résoudre les problèmes liés à une action de AWS IoT SiteWise règle Pour résoudre les problèmes liés à l'action de votre AWS IoT SiteWise règle dans AWS IoT Core, vous pouvez suivre l'une des procédures suivantes : + Configuration d'Amazon CloudWatch Logs + Configurer une action d'erreur de republication pour votre règle Ensuite, comparez les messages d'erreur avec les erreurs de cette rubrique pour résoudre le problème. **Topics** + [ ## Configuration AWS IoT Core des journaux ](#configure-iot-logs) + [ ## Configurer une action d'erreur de republication ](#configure-republish-error-action) + [ ## Résoudre les problèmes liés aux règles ](#troubleshoot-rule-issues) + [ ## Résoudre les problèmes liés à une règle ()AWS IoT SiteWise ](#rule-tutorial-troubleshoot-rule) + [ ## Résolution des problèmes liés à une règle (DynamoDB) ](#dynamodb-tutorial-troubleshoot-rule) ## Configuration AWS IoT Core des journaux Vous pouvez configurer AWS IoT pour consigner différents niveaux d'informations dans CloudWatch Logs. **Pour configurer les CloudWatch journaux et y accéder** 1. Pour configurer la journalisation pour AWS IoT Core, consultez la section [Surveillance à l'aide CloudWatch des journaux](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) dans le *guide du AWS IoT développeur*. 1. Accédez à la [console CloudWatch ](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, choisissez **Groupes de journaux**. 1. Choisissez le groupe **AWSIotLogs**. 1. Choisissez un flux de journaux récent. Par défaut, CloudWatch affiche le flux de journal le plus récent en premier. 1. Choisissez une entrée de journal pour développer le message de journal. Votre entrée de journal peut ressembler à la capture d'écran suivante. ![\[CloudWatch Capture d'écran « AWS IoT  Logs ».\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png) 1. Comparez les messages d'erreur avec les erreurs de cette rubrique pour résoudre le problème. ## Configurer une action d'erreur de republication Vous pouvez configurer une action d'erreur au niveau d'une règle pour gérer les messages d'erreur. Dans cette procédure, vous configurez l'action de règle de republication en tant qu'action d'erreur pour afficher les messages d'erreur dans le client de test MQTT. **Note** L'action d'erreur de republication ne génère que l'équivalent des journaux de niveau `ERROR`. Si vous souhaitez des journaux plus détaillés, vous devez [configurer CloudWatch ](#configure-iot-logs) les journaux. **Pour ajouter une action d'erreur de republication à une règle** 1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iot/). 1. Dans le panneau de navigation de gauche, choisissez **Act (Agir)** puis **Rules (Règles)**. 1. Choisissez une règle. 1. Sous **Error action (Action d'erreur)**, choisissez **Add action (Ajouter une action)**. 1. Choisissez **Republier un message dans un AWS IoT sujet**. ![\[AWS IoT Core Capture d'écran de la page « Sélectionnez une action » avec l'action Republier surlignée.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png) 1. En bas de la page, choisissez **Configure action (Configurer l'action)**. 1. Dans **Sujet**, entrez un sujet unique (par exemple,**sitewise/windfarm/rule/error**). AWS IoT Core republiera les messages d'erreur dans cette rubrique. 1. Choisissez **Sélectionner** pour autoriser AWS IoT Core l'accès afin d'exécuter l'action d'erreur. 1. Choisissez **Select (Sélectionner)** en regard du rôle que vous avez créé pour la règle. 1. Choisissez **Update Role (Mettre à jour le rôle)** pour ajouter les autorisations supplémentaires au rôle. 1. Choisissez **Add action**. L'action d'erreur de la règle devrait ressembler à la capture d'écran suivante. ![\[AWS IoT Core Page « Règle » Republier la capture d'écran de l'action d'erreur.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png) 1. Cliquez sur la flèche de retour en haut à gauche de la console pour revenir à la page d'accueil de la AWS IoT console. Après avoir configuré l'action d'erreur de republication, vous pouvez afficher les messages d'erreur dans le client de test MQTT dans AWS IoT Core. Dans la procédure suivante, vous vous abonnez à la rubrique d'erreur dans le client de test MQTT. Le client de test MQTT vous permet de recevoir les messages d'erreur de la règle afin de résoudre le problème. **Pour vous abonner à la rubrique d'action d'erreur** 1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iot/). 1. Dans la page de navigation de gauche, choisissez **Test** pour ouvrir le client de test MQTT. 1. Dans le champ **Subscription topic (Rubrique d'abonnement)**, entrez la rubrique d'erreur que vous avez configurée précédemment (par exemple, **sitewise/windfarm/rule/error**) et choisissez **Subscribe to topic (S'abonner à la rubrique)**. ![\[AWS IoT Core Capture d'écran de la page « client MQTT » avec le bouton « S'abonner au sujet » surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png) 1. Surveillez les messages d'erreur qui s'affichent, puis développez le tableau `failures` dans chaque message d'erreur. Ensuite, comparez les messages d'erreur avec les erreurs de cette rubrique pour résoudre le problème. ## Résoudre les problèmes liés aux règles Utilisez les informations suivantes pour résoudre les problèmes de règle. **Topics** + [ ### Erreur : le membre doit être dans les 604800 secondes avant et 300 secondes après l'horodatage actuel ](#rule-error-timestamp-out-of-range) + [ ### Erreur : la valeur de la propriété ne correspond pas au type de données ](#rule-error-invalid-data-type) + [ ### Erreur : L'utilisateur n'est pas autorisé à exécuter : iotsitewise : aucune ressource BatchPutAssetPropertyValue ](#rule-error-role-not-authorized) + [ ### Erreur : iot.amazonaws.com ne parvient pas à exécuter : sts : on resource : AssumeRole ](#rule-error-unable-to-assume-role) + [ ### Info : Aucune demande n'a été envoyée. PutAssetPropertyValueEntries était vide après avoir effectué des modèles de substitution. ](#rule-info-request-was-empty) ### Erreur : le membre doit être dans les 604800 secondes avant et 300 secondes après l'horodatage actuel Votre horodatage date de plus de 7 jours ou de moins de 5 minutes, par rapport à l'époque Unix actuelle. Essayez les éléments suivants : + Vérifiez que l'horodatage est au format d'heure Unix epoch (UTC). Si vous fournissez un horodatage avec un fuseau horaire différent, vous rencontrerez cette erreur. + Vérifiez que votre horodatage est en secondes. AWS IoT SiteWise attend des horodatages divisés en secondes (à l'époque Unix) et décalés en nanosecondes. + Vérifiez que vous téléchargez des données horodatées d'au plus 7 jours auparavant. ### Erreur : la valeur de la propriété ne correspond pas au type de données Une entrée de votre action de règle comporte un type de données différent de celui de la propriété de ressource cible. Par exemple, la propriété de ressource cible est de type `DOUBLE`, tandis que le type de données que vous avez sélectionné est **Integer** ou que vous avez transmis la valeur dans `integerValue`. Essayez les éléments suivants : + Si vous configurez la règle depuis la AWS IoT console, vérifiez que vous avez choisi le bon **type de données** pour chaque entrée. + Si vous configurez la règle à partir de l'API ou AWS Command Line Interface (AWS CLI), vérifiez que votre `value` objet utilise le champ de type correct (par exemple, `doubleValue` pour une `DOUBLE` propriété). ### Erreur : L'utilisateur n'est pas autorisé à exécuter : iotsitewise : aucune ressource BatchPutAssetPropertyValue Soit la règle n'est pas autorisée à accéder à la propriété de ressource cible, soit la propriété de ressource cible n'existe pas. Essayez les éléments suivants : + Vérifiez que l'alias de la propriété est correct et que la propriété de ressource dispose de l'alias de propriété donné. Pour de plus amples informations, veuillez consulter [Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md). + Vérifiez que la règle est associée à un rôle et que le rôle `iotsitewise:BatchPutAssetPropertyValue` donne l'autorisation à la propriété de ressource cible, par exemple via la hiérarchie de la ressource cible. Pour de plus amples informations, veuillez consulter [Accordez AWS IoT l'accès requis](grant-rule-access.md). ### Erreur : iot.amazonaws.com ne parvient pas à exécuter : sts : on resource : AssumeRole Votre utilisateur n'est pas autorisé à assumer le rôle dans votre règle dans Gestion des identités et des accès AWS (IAM). Vérifiez que votre utilisateur est `iam:PassRole` autorisé à accéder au rôle indiqué dans votre règle. Pour plus d'informations, consultez la section [Transmettre les autorisations de rôle](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html) dans le *guide du AWS IoT développeur*. ### Info : Aucune demande n'a été envoyée. PutAssetPropertyValueEntries était vide après avoir effectué des modèles de substitution. **Note** Ce message est un journal de niveau `INFO`. Votre demande doit comporter au moins une entrée avec tous les paramètres requis. Vérifiez que les paramètres de la règle, y compris les modèles de substitution, génèrent des valeurs non vides. Les modèles de substitution ne peuvent pas accéder aux valeurs définies dans les clauses `AS` de l'instruction de requête de la règle. Pour plus d'informations, consultez la section [Modèles de substitution](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html) dans le *Guide du AWS IoT développeur*. ## Résoudre les problèmes liés à une règle ()AWS IoT SiteWise Suivez les étapes de cette procédure pour résoudre les problèmes liés à votre règle si les données d'utilisation du processeur et de la mémoire ne s'affichent pas AWS IoT SiteWise comme prévu. Dans cette procédure, vous configurez l'action de règle de republication en tant qu'action d'erreur pour afficher les messages d'erreur dans le client de test MQTT. Vous pouvez également configurer la journalisation dans CloudWatch Logs pour résoudre les problèmes. Pour de plus amples informations, veuillez consulter [Résoudre les problèmes liés à une action de AWS IoT SiteWise règle](#troubleshoot-rule). **Pour ajouter une action d'erreur de republication à une règle** 1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iot/). 1. Dans le volet de navigation de gauche, choisissez **Routage des messages**, puis **Règles**. 1. Choisissez la règle que vous avez créée précédemment, puis cliquez sur **Modifier**. 1. Sous **Action d'erreur - *facultatif***, choisissez **Ajouter une action d'erreur**. 1. Choisissez **Republier un message dans un AWS IoT sujet**. 1. Dans **Sujet**, entrez le chemin de votre erreur (par exemple,**sitewise/rule/tutorial/error**). AWS IoT Core republiera les messages d'erreur dans cette rubrique. 1. Choisissez le rôle que vous avez créé précédemment (par exemple, **SiteWiseTutorialDeviceRuleRole**). 1. Choisissez **Mettre à jour**. Après avoir configuré l'action d'erreur de republication, vous pouvez afficher les messages d'erreur dans le client de test MQTT dans AWS IoT Core. Dans la procédure suivante, vous vous abonnez à la rubrique d'erreur dans le client de test MQTT. **Pour vous abonner à la rubrique d'action d'erreur** 1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iot/). 1. Dans la page de navigation de gauche, choisissez le client de **test MQTT pour ouvrir le client** de test MQTT. 1. Dans le champ **Filtre par sujet**, entrez **sitewise/rule/tutorial/error** et choisissez **S'abonner**. Lorsque des messages d'erreur apparaissent, affichez le tableau `failures` dans n'importe quel message d'erreur pour diagnostiquer les problèmes. Pour plus d'informations sur les problèmes et les solutions possibles, consultez [Résoudre les problèmes liés à une action de AWS IoT SiteWise règle](#troubleshoot-rule). Si aucune erreur ne s'affiche, vérifiez que votre règle est activée et que vous vous êtes abonné à la même rubrique que celle que vous avez configurée dans l'action d'erreur de republication. Si des erreurs ne s'affichent toujours pas, vérifiez que le script du périphérique est en cours d'exécution et qu'il met à jour l'ombre du périphérique avec succès. **Note** Vous pouvez également vous abonner à la rubrique de mise à jour parallèle de votre appareil pour voir la charge utile analysée par votre AWS IoT SiteWise action. Pour ce faire, abonnez-vous à la rubrique suivante. ``` $aws/things/+/shadow/update/accepted ``` ## Résolution des problèmes liés à une règle (DynamoDB) Suivez les étapes de cette procédure pour résoudre les problèmes liés à votre règle si les données des actifs de démonstration n'apparaissent pas dans le tableau DynamoDB comme prévu. Dans cette procédure, vous configurez l'action de règle de republication en tant qu'action d'erreur pour afficher les messages d'erreur dans le client de test MQTT. Vous pouvez également configurer la journalisation dans CloudWatch Logs pour résoudre les problèmes. Pour plus d'informations, veuillez consulter la rubrique [Surveillance avec les journaux CloudWatch ](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) dans le *Guide du développeur AWS IoT *. **Pour ajouter une action d'erreur de republication à une règle** 1. Accédez à la [console AWS IoT](https://console.aws.amazon.com/iot/). 1. Dans le panneau de navigation de gauche, choisissez **Act (Agir)** puis **Rules (Règles)**. 1. Choisissez la règle que vous avez créée précédemment. ![\[AWS IoT Capture d'écran de la page « Règles » de base.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png) 1. Sous **Error action (Action d'erreur)**, choisissez **Add action (Ajouter une action)**. 1. Choisissez **Republier un message dans un AWS IoT sujet**. ![\[AWS IoT Capture d'écran de la page principale « Sélectionner une action » avec l'action Republier surlignée.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png) 1. En bas de la page, choisissez **Configure action (Configurer l'action)**. 1. Dans **Sujet**, entrez **windspeed/error**. AWS IoT Core republiera les messages d'erreur dans cette rubrique. ![\[AWS IoT Capture d'écran de la page principale « Configurer l'action de republication » avec le « Sujet » surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png) 1. Choisissez **Sélectionner** pour autoriser AWS IoT Core à exécuter l'action d'erreur en utilisant le rôle que vous avez créé précédemment. 1. Choisissez **Select (Sélectionner)** en regard de votre rôle. ![\[AWS IoT Capture d'écran de la page principale « Configurer l'action de republication » avec le bouton de sélection de rôle surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png) 1. Choisissez **Update Role (Mettre à jour le rôle)** pour ajouter les autorisations supplémentaires au rôle. ![\[AWS IoT Capture d'écran de la page principale « Configurer l'action de republication » avec le bouton de mise à jour du rôle surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png) 1. Choisissez **Add action (Ajouter une action)** pour terminer l'ajout de l'action d'erreur. 1. Cliquez sur la flèche de retour en haut à gauche de la console pour revenir à la page d'accueil de la console AWS IoT Core. Après avoir configuré l'action d'erreur de republication, vous pouvez afficher les messages d'erreur dans le client de test MQTT dans AWS IoT Core. Dans la procédure suivante, vous vous abonnez à la rubrique d'erreur dans le client de test MQTT. **Pour vous abonner à la rubrique d'action d'erreur** 1. Dans la page de navigation de gauche de la console AWS IoT Core, choisissez **Test**. 1. Dans le champ **Subscription topic (Rubrique Abonnement)** saisissez **windspeed/error** et choisissez **Subscribe to topic (S'abonner à la rubrique)**. ![\[AWS IoT Capture d'écran de la page principale « client MQTT » avec le bouton « S'abonner au sujet » surligné.\]](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png) 1. Vérifiez les messages d'erreur qui s'affichent et explorez la zone `failures` d'un message d'erreur pour diagnostiquer les problèmes courants suivants : + Fautes de frappe dans l'instruction de requête de règle + Autorisations de rôle insuffisantes Si aucune erreur ne s'affiche, vérifiez que votre règle est activée et que vous vous êtes abonné à la même rubrique que celle que vous avez configurée dans l'action d'erreur de republication. Si, malgré cela, aucune erreur ne s'affiche, vérifiez que les ressources de votre parc éolien de démonstration existent toujours et que vous avez activé les notifications sur les propriétés de vitesse du vent. Si vos ressources de démonstration ont expiré et ont disparu AWS IoT SiteWise, vous pouvez créer une nouvelle démo et mettre à jour l'énoncé de la requête de règle pour refléter le modèle et les propriétés des actifs mis à jour IDs. # Résolution des problèmes liés aux opérations d'importation et d'exportation en masse Pour gérer et diagnostiquer les erreurs produites lors d'une tâche de transfert, consultez l' AWS IoT TwinMaker **GetMetadataTransferJob**API : 1. Après avoir créé et exécuté une tâche de transfert, appelez l'**GetMetadataTransferJob**API : ``` aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id your_metadata_transfer_job_id \ --region us-east-1 ``` 1. L'état de la tâche passe à l'un des états ci-dessous : + TERMINÉ + CANCELLED + ERROR 1. L'**GetMetadataTransferJob**API renvoie un [ MetadataTransferJobProgress](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)objet. 1. L'**MetadataTransferJobProgress**objet contient les paramètres suivants : + **FailedCount** : indique le nombre d'actifs défaillants pendant le processus de transfert. + **SkippedCount** : indique le nombre d'actifs ignorés pendant le processus de transfert. + **SucceededCount** : indique le nombre d'actifs qui ont réussi pendant le processus de transfert. + **TotalCount** : indique le nombre total d'actifs impliqués dans le processus de transfert. 1. En outre, un élément **ReportURL** est renvoyé par l'appel d'API, qui contient une URL pré-signée. Si votre tâche de transfert comporte des erreurs nécessitant une enquête, vous pouvez télécharger un rapport d'erreur complet à cette adresse URL.