Résolution des problèmes liés à une passerelle SiteWise Edge

AWS IoT SiteWise Les passerelles Edge exécutent un ensemble de AWS IoT Greengrass composants. Vous pouvez configurer votre passerelle SiteWise Edge pour consigner les événements sur Amazon CloudWatch et dans le système de fichiers local de votre passerelle SiteWise Edge. Vous pouvez ensuite consulter les fichiers journaux pour résoudre les problèmes liés à votre passerelle SiteWise Edge.

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 plus d’informations, consultez Surveillance AWS IoT SiteWise à l'aide des CloudWatch métriques Amazon.

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 plus d’informations, consultez Utilisation d'Amazon CloudWatch Logs.

• 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 plus d’informations, consultez Utilisation des journaux de service.

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.

Problèmes

• Impossible de déployer des packs sur les passerelles SiteWise Edge
• AWS IoT SiteWise ne reçoit pas de données en provenance des serveurs OPC-UA
• Aucune donnée n'était affichée dans le tableau de bord
• « Impossible de trouver ou de charger la classe principale » qui s'affiche dans le fichier aws.iot. SiteWiseEdgePublisher erreur de journalisation dans /greengrass/v2/logs

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.

Mettre à niveau le composant AWS IoT Greengrass Nucleus (console)

1. Accédez à la console AWS IoT Greengrass.

2. Dans le volet de navigation, sous AWS IoT Greengrass, choisissez Deployments.

3. Dans la liste des déploiements, sélectionnez le déploiement que vous souhaitez réviser.

4. Choisissez Réviser.

5. Sur la page Spécifier la cible, choisissez Next.

6. Sur la page Sélectionner les composants, sous Composants publics, dans la zone de recherche, entrezaws.greengrass.Nucleus, puis sélectionnez AWS.Greengrass.Nucleus.

7. Choisissez Suivant.

8. Sur la page Configurer les composants, choisissez Next.

9. Sur la page Configurer les paramètres avancés, choisissez Next.

10. 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 SomeExceptiondans 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 :

  • Vos alias de propriété ne correspondent pas exactement à vos variables OPC-UA, y compris les préfixes 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 de la ressource. Pour plus d’informations, consultez Mappage des flux de données industrielles avec des propriétés de ressources.

    Si vous avez déjà mappé toutes les variables OPC-UA souhaitées AWS IoT SiteWise, vous pouvez filtrer les variables OPC-UA envoyées par la passerelle Edge. SiteWise Pour plus d’informations, consultez Utilisation des filtres de nœuds OPC-UA.

• 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 un flux OPC-UA a un type de données entier, votre propriété de ressource correspondante doit être un type de données entier. Une propriété de ressource 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.

• ThrottlingExceptionou 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.

Aucune donnée n'était affichée 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.

2. Dans le volet de navigation, choisissez Edge gateways.

3. Sélectionnez la passerelle SiteWise Edge connectée au tableau de bord.

4. Sous Sources de données, sélectionnez Modifier.

5. Sélectionnez un nouveau nom de source, puis sélectionnez Enregistrer pour confirmer votre modification.

6. 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 erreur de journalisation dans /greengrass/v2/logs

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 sousOpenJDK 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, consultezModification de la version des packs de composants de la passerelle SiteWise Edge.

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 dans le Guide du AWS IoT Greengrass développeur.