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 Greengrass doit autoriser la connectivité réseau sortante vers les serveurs UA. OPC

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, consultez BatchPutAssetPropertyValue dans la référence AWS IoT SiteWise API.

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. Remplacez /greengrass/v2 ou C:\greengrass\v2 par 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. Remplacez /greengrass/v2 ou C:\greengrass\v2 par 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.1	Corrections de bogues et améliorations Corrige un bogue selon lequel les futures tâches de capture d'écran sont annulées en cas d'erreur lors de l'exécution d'une tâche de capture instantanée. Corrige un bogue selon lequel les mises à jour de configuration des sources de données ne sont conservées qu'après le redémarrage de l'OPCUA Collector, en cas de perte de connexion au serveur OPC UA de la source de données.
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 bogues et améliorations Réinitialise la configuration d'interrogation par défaut pour utiliser l'horodatage de la source.
2.4.2	Corrections de bogues 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 bogues 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 bogues 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 spécification OPC UA.
2.3.0	Nouvelles fonctionnalités Ajoute la prise en charge de la configuration du HTTPproxy Greengrass Nucleus sous Linux. Corrections de bogues 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 bogues 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 bogues 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 Permet de configurer les 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 bogues 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 bogues 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