Versions Type Système d’exploitation Prérequis Dépendances Configuration Données d'entrée Données de sortie Fichier journal local Dépannage et débogage Licences Journal des modifications Consultez aussi

Collecteur IoT SiteWise OPC -UA

Le composant collecteur IoT SiteWise OPC -UA (aws.iot.SiteWiseEdgeCollectorOpcua) permet aux AWS IoT SiteWise passerelles de collecter des données à partir de serveurs OPC -UA locaux.

Avec ce composant, les AWS IoT SiteWise passerelles peuvent se connecter à plusieurs serveurs OPC -UA. Pour plus d'informations sur les AWS IoT SiteWise passerelles, consultez la section Utilisation AWS IoT SiteWise du périphérique dans le Guide de l'AWS IoT SiteWise utilisateur.

Versions

Les versions de ce composant sont les suivantes :

2,5.x
2.4.x
2.3.x
2.2.x
2,1x
2,0.x

Type

Ce composant est un composant générique (aws.greengrass.generic). Le noyau Greengrass exécute les scripts de cycle de vie du composant.

Pour de plus amples informations, veuillez consulter Types de composants.

Système d’exploitation

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :

Linux
Windows

Prérequis

Ce composant répond aux exigences suivantes :

L'appareil principal de Greengrass doit fonctionner sur l'une des plateformes suivantes :
- Système d'exploitation : Ubuntu 18.04 ou version ultérieure
  
  Architecture : x86_64 (AMD64) ou ARMv8 (Aarch64)
- Système d'exploitation : Red Hat Enterprise Linux (8RHEL)
  
  Architecture : x86_64 (AMD64) ou ARMv8 (Aarch64)
- Système d'exploitation : Amazon Linux 2
  
  Architecture : x86_64 (AMD64) ou ARMv8 (Aarch64)
- Système d'exploitation : Debian 11
  
  Architecture : x86_64 (AMD64) ou ARMv8 (Aarch64)
- Système d'exploitation : Windows Server 2019 ou version ultérieure
  
  Architecture : x86_64 () AMD64
Le périphérique principal de Greengrass doit autoriser la connectivité réseau sortante aux OPC serveurs -UA.

Dépendances

Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des versions publiées de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la AWS IoT Greengrass console. Sur la page de détails du composant, recherchez la liste des dépendances.

Le tableau suivant répertorie les dépendances de toutes les versions de ce composant.

Dépendance	Versions compatibles	Type de dépendance
Noyau de Greengrass	>=2,3,0 <3,0,0	Stricte
Gestionnaire de flux	>2,0,10<3,0.0	Stricte
Directeur secret	>=2,0,8 <3,0,0	Stricte

Pour plus d'informations sur les dépendances des composants, consultez la référence de la recette des composants.

Configuration

Ce composant ne possède aucun paramètre de configuration.

Vous pouvez utiliser la AWS IoT SiteWise console ou API configurer le composant collecteur IoT SiteWise OPC -UA. Pour plus d'informations, voir Étape 4 : Ajouter des sources de données (facultatif) dans le Guide de AWS IoT SiteWise l'utilisateur.

Données d'entrée

Ce composant n'accepte que les données dans les formats suivants, tous les autres seront ignorés et rejetés. Le tableau ci-dessous met en correspondance les types de données OPC UA avec leurs SiteWise équivalents.

SiteWise type de données	OPCType de données UA	Description
`STRING`	`String` `Guid` `XmlElement`	Chaîne d'une longueur maximale de 1024 octets.
`INTEGER`	`SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`* `Int64`*	Un entier signé de 32 bits dont la plage est comprise `-2,147,483,648 to 2,147,483,647` entre.
`DOUBLE`	`UInt32`* `Int64`* `Float` `Double`	Nombre à virgule flottante avec plage de `–10^100 to 10^100` valeurs et `IEEE 754` double précision.
`BOOLEAN`	`Boolean`	`true` ou `false`.

* Pour les types de données OPC UA UInt32 etInt64, son type de SiteWise données sera INTEGER s'il SiteWise est capable de représenter sa valeur, sinon il le seraDOUBLE.

Données de sortie

Ce composant écrit BatchPutAssetPropertyValue des messages dans le gestionnaire de AWS IoT Greengrass flux. Pour plus d'informations, reportez-vous BatchPutAssetPropertyValueà la section AWS IoT SiteWise APIRéférence.

Fichier journal local

Ce composant utilise le fichier journal suivant.

Pour consulter les journaux de ce composant

Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacer /greengrass/v2 ou C:\greengrass\v2 avec le chemin d'accès au dossier AWS IoT Greengrass racine.
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
```

Dépannage et débogage

Ce composant inclut un nouveau journal des événements pour aider les clients à identifier et à résoudre les problèmes. Le fichier journal est distinct du fichier journal local et se trouve à l'emplacement suivant. Remplacer /greengrass/v2 ou C:\greengrass\v2 avec le chemin d'accès au dossier AWS IoT Greengrass racine.

Ce journal contient des informations détaillées et des instructions de dépannage. Des informations de dépannage sont fournies en même temps que les diagnostics, avec une description de la manière de remédier au problème, et parfois avec des liens vers des informations supplémentaires. Les informations de diagnostic incluent les éléments suivants :

Niveau de gravité
Horodatage
Informations supplémentaires spécifiques à l'événement

Exemple de journal


dataSourceConnectionSuccess:
  Summary: Successfully connected to OpcUa server
  Level: INFO
  Timestamp: '2023-06-15T21:04:16.303Z'
  Description: Successfully connected to the data source.
  AssociatedMetrics:
  - Name: FetchedDataStreams
    Description: The number of fetched data streams for this data source
    Value: 1.0
    Namespace: IoTSiteWise
    Dimensions:
    - Name: SourceName
      Value: SourceName{value=OPC-UA Server}
    - Name: ThingName
      Value: test-core
  AssociatedData:
  - Name: DataSourceTrace
    Description: Name of the data source
    Data:
    - OPC-UA Server
  - Name: EndpointUri
    Description: The endpoint to which the connection was attempted.
    Data:
    - '"opc.tcp://10.0.0.1:1234"'

Licences

Ce composant est publié dans le cadre du contrat de licence logicielle Greengrass Core.

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version du composant.

Version	Modifications
2.5.0	Nouvelles fonctionnalités Ajoute une option de source de données pour convertir des tableaux et des DateTime valeurs simples en chaînes. Ajoute une option de groupe de propriétés permettant de sélectionner un horodatage source ou serveur lors de la collecte de données à partir d'un serveur OPC -UA. Corrections de bugs et améliorations Réinitialise la configuration d'interrogation par défaut pour utiliser l'horodatage de la source.
2.4.2	Corrections de bugs et améliorations Résout les problèmes lors de la découverte du serveur OPC UA dans lesquels un nœud peut être découvert plusieurs fois. Corrige la fonctionnalité de capture instantanée afin de garantir que l'horodatage est nouveau pour chaque point de données de capture instantanée.
2.4.1	Corrections de bugs et améliorations Résout les problèmes liés à la prise en charge des proxys. Résout un problème en raison duquel le nettoyage des threads échouait et provoquait un blocage des données.
2.4.0	Nouvelles fonctionnalités Ajoute un journal des événements pour faciliter l'identification et la résolution des problèmes. Corrections de bugs et améliorations Résout un problème lié au client OPC -UA qui provoquait des erreurs de certificat lors de la connexion à un serveur OPC -UA utilisant la version 1.05 de la OPC spécification -UA.
2.3.0	Nouvelles fonctionnalités Ajoute la prise en charge de la configuration du HTTPproxy Greengrass Nucleus sous Linux. Corrections de bugs et améliorations Résout un problème de sécurité (CVE-2019-19135).
2.2.0	Nouvelles fonctionnalités Prend en charge l'installation du pack de collecte de données sur ARMv8 l'architecture Linux. Configuration minimale requise pour Linux ARMv8 : Mémoire : 4 Go CPU: ARM Cortex-A72 ou spécification équivalente Corrections de bugs et améliorations Améliore la journalisation des métriques dans le processus de découverte des nœuds. Améliore la gestion des types de données non pris en charge. Améliore l'enregistrement des erreurs de flux de données.
2.1.3	Nouvelles fonctionnalités Ajoute la prise en charge de Windows Server 2019 ou version ultérieure. Corrections de bugs et améliorations Améliore les messages d'erreur lorsque vous déployez ce composant sur des appareils non pris en charge.
2.1.1	Nouvelles fonctionnalités Ajoute la prise en charge de la configuration des propriétés d'abonnement suivantes : DataChangeTrigger‐ Vous pouvez définir la condition qui déclenche une alerte de modification des données. QueueSize‐ La profondeur de la file d'attente sur un serveur OPC ‐UA pour une métrique particulière où les notifications relatives aux éléments surveillés sont mises en file d'attente. PublishingIntervalMilliseconds‐ Intervalle (en millisecondes) d'un cycle de publication spécifié lors de la création d'un abonnement. SnapshotFrequencyMilliseconds ‐ Vous pouvez configurer le paramètre de délai d'expiration de la fréquence des instantanés pour garantir qu' AWS IoT SiteWise Edge ingère un flux constant de données. Cette version prend en charge l'ingestion de données de `BAD` qualité et filtre les données en fonction des qualités de données suivantes : `UNCERTAIN`données de qualité `BAD`données de qualité Corrections de bugs et améliorations Améliorations des statistiques relatives aux clients. Corrige le codage de sécurité qui causait parfois des problèmes lors de la connexion à des serveurs sur lesquels le chiffrement était activé. Résout un problème en raison duquel le groupe de propriétés n'a pas pu être mis à jour.
2.0.3	Corrections de bugs et améliorations.
2.0.2	Corrections de bogues et améliorations apportées à la synchronisation des priorités des actifs avec Edge.
2.0.1	Première version.

Consultez aussi

Qu'est-ce que c'est AWS IoT SiteWise ? dans le guide de AWS IoT SiteWise l'utilisateur.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Service d'échange de jetons

Simulateur de source de données IoT SiteWise OPC-UA