Prérequis Paramètres Données d'entrée Données de sortie Limites Licences Journal des modifications Consultez aussi

AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

SiteWise Connecteur IoT

Le SiteWise connecteur IoT envoie les données des appareils et équipements locaux aux propriétés des actifs dansAWS IoT SiteWise. Vous pouvez utiliser ce connecteur pour collecter des données provenant de plusieurs serveurs OPC-UA et les publier sur l'IoT. SiteWise Le connecteur envoie les données aux propriétés des actifs dans la région actuelle Compte AWS et dans la région.

Note

L'IoT SiteWise est un service entièrement géré qui collecte, traite et visualise les données provenant d'appareils et d'équipements industriels. Vous pouvez configurer les propriétés des ressources afin qu'elles effectuent un traitement des données brutes envoyées par ce connecteur aux propriétés de mesure de vos ressources. Par exemple, vous pouvez définir une propriété de transformation qui convertit en Fahrenheit les points de données de température d'un appareil exprimés en Celsius, ou vous pouvez définir une propriété de mesure qui calcule la température horaire moyenne. Pour plus d'informations, consultez Présentation d'AWS IoT SiteWise dans le Guide de l'utilisateur AWS IoT SiteWise.

Le connecteur envoie des données à l'IoT SiteWise avec les chemins de flux de données OPC-UA envoyés par les serveurs OPC-UA. Par exemple, le chemin de flux de données /company/windfarm/3/turbine/7/temperature peut représenter le capteur de température de la turbine n°7 au parc éolien n°3. Si le AWS IoT Greengrass cœur perd la connexion à Internet, le connecteur met en cache les données jusqu'à ce qu'il puisse se connecter correctement auAWS Cloud. Vous pouvez configurer la taille maximale du tampon disque utilisée pour la mise en cache des données. Si la taille du cache dépasse la taille maximale du tampon disque, le connecteur supprime les données les plus anciennes de la file d'attente.

Après avoir configuré et déployé le SiteWise connecteur IoT, vous pouvez ajouter une passerelle et des sources OPC-UA dans la console IoT SiteWise . Lorsque vous configurez une source dans la console, vous pouvez filtrer ou préfixer les chemins de flux de données OPC-UA envoyés par le connecteur IoT. SiteWise Pour obtenir des instructions sur la manière de terminer la configuration de votre passerelle et de vos sources, veuillez consulter Ajout de la passerelle dans le Guide de l'utilisateur AWS IoT SiteWise.

L'IoT SiteWise reçoit des données uniquement à partir de flux de données que vous avez mappés aux propriétés de mesure des SiteWise actifs IoT. Pour mapper des flux de données aux propriétés des ressources, vous pouvez définir l'alias d'une propriété comme équivalent à un chemin de flux de données OPC-UA. Pour de plus amples informations sur la définition de modèles de ressource et la création de ressources, veuillez consulter Modélisation de ressources industrielles dans le Guide de l'utilisateur AWS IoT SiteWise.

Remarques

Vous pouvez utiliser le gestionnaire de flux pour télécharger des données vers l'IoT à SiteWise partir de sources autres que les serveurs OPC-UA. Le gestionnaire de flux fournit également un support personnalisable pour la persistance et la gestion de la bande passante. Pour plus d’informations, consultez Gestion des flux de données sur AWS IoT Greengrass Core.

Ce connecteur fonctionne en mode sans isolation de conteneur. Vous pouvez donc le déployer sur un groupe Greengrass exécuté dans un conteneur Docker.

Ce connecteur est disponible dans les versions suivantes.

Version	ARN
12 (recommandé)	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12`
11	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11`
10	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10`
9	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9`
8	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8`
7	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7`
6	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6`
5	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5`
4	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4`
3	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3`
2	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2`
1	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1`

Pour obtenir des informations sur les changements apportés aux versions, veuillez consulter le Journal des modifications.

Prérequis

Ce connecteur possède les critères suivants :

Version 9, 10, 11, and 12

Important

Cette version introduit de nouvelles exigences : logiciel de AWS IoT Greengrass base v1.10.2 et gestionnaire de flux.

AWS IoT GreengrassLogiciel de base v1.10.2.
Gestionnaire de flux activé sur le groupe Greengrass.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.

Une politique IAM a été ajoutée au rôle de groupe Greengrass. Ce rôle permet au groupe AWS IoT Greengrass d'accéder à l'action iotsitewise:BatchPutAssetPropertyValue sur l'actif racine cible et ses enfants, comme illustré dans l'exemple suivant. Vous pouvez le supprimer Condition de la politique pour permettre au connecteur d'accéder à tous vos SiteWise actifs IoT.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Pour plus d'informations, consultez la section Ajout et suppression de politiques IAM dans le Guide de l'utilisateur IAM.

Versions 6, 7, and 8

Important

Cette version introduit de nouvelles exigences : logiciel AWS IoT Greengrass Core version 1.10.0 et gestionnaire de flux.

AWS IoT GreengrassLogiciel de base v1.10.0.
Gestionnaire de flux activé sur le groupe Greengrass.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Pour plus d'informations, consultez la section Ajout et suppression de politiques IAM dans le Guide de l'utilisateur IAM.

Version 5

AWS IoT GreengrassLogiciel de base v1.9.4.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Pour plus d'informations, consultez la section Ajout et suppression de politiques IAM dans le Guide de l'utilisateur IAM.

Version 4

AWS IoT GreengrassLogiciel de base v1.10.0.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Pour plus d'informations, consultez la section Ajout et suppression de politiques IAM dans le Guide de l'utilisateur IAM.

Version 3

AWS IoT GreengrassLogiciel de base v1.9.4.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Pour plus d'informations, consultez la section Ajout et suppression de politiques IAM dans le Guide de l'utilisateur IAM.

Versions 1 and 2

AWS IoT GreengrassLogiciel de base v1.9.4.
Java 8 installé sur l'appareil principal et ajouté à la variable d'environnement PATH.
Ce connecteur ne peut être utilisé que dans les régions Amazon Web Services où les deux technologies AWS IoT Greengrasset l'IoT SiteWise sont pris en charge.

Une politique IAM ajoutée au rôle de groupe Greengrass permet d'accéder AWS IoT Core à iotsitewise:BatchPutAssetPropertyValue l'actif racine cible et à ses enfants et d'agir sur ceux-ci, comme illustré dans l'exemple suivant. Vous pouvez le supprimer Condition de la politique pour permettre au connecteur d'accéder à tous vos SiteWise actifs IoT.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        },
        {
            "Effect": "Allow",
            "Action": [
                 "iot:Connect",
                 "iot:DescribeEndpoint",
                 "iot:Publish",
                 "iot:Receive",
                 "iot:Subscribe"
            ],
            "Resource": "*"
        }
    ]
}

Pour plus d’informations, consultez la rubrique Ajout et suppression d’autorisations basées sur l’identité IAM du Guide de l’utilisateur IAM.

Paramètres

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12

SiteWiseLocalStoragePath

Le répertoire de l'AWS IoT Greengrasshôte dans lequel le SiteWise connecteur IoT peut écrire des données persistantes. La valeur par défaut est /var/sitewise.

Nom affiché dans la AWS IoT console : chemin de stockage local

Nécessaire : false

Type : string

Modèle valide : ^\s*$|\/.

AWSSecretsArnList

Liste de secrets dans AWS Secrets Manager contenant chacun le nom d'utilisateur OPC-UA et la paire clé-valeur du mot de passe. Chaque secret doit être un secret de type paire clé-valeur.

Nom d'affichage dans la AWS IoT console : liste des ARN pour les secrets de nom d'utilisateur/mot de passe OPC-UA

Nécessaire : false

Type : JsonArrayOfStrings

Modèle valide : \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

Taille maximale en Go pour l'utilisation des SiteWise disques IoT. La valeur par défaut est 10 Go.

Nom affiché dans la AWS IoT console : taille maximale de la mémoire tampon du disque

Nécessaire : false

Type : string

Modèle valide : ^\s*$|[0-9]+

Version 1

SiteWiseLocalStoragePath

Le répertoire de l'AWS IoT Greengrasshôte dans lequel le SiteWise connecteur IoT peut écrire des données persistantes. La valeur par défaut est /var/sitewise.

Nom affiché dans la AWS IoT console : chemin de stockage local

Nécessaire : false

Type : string

Modèle valide : ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Secret dans AWS Secrets Manager qui contient le nom d'utilisateur OPC-UA et la paire clé-valeur du mot de passe. Ce secret doit être un secret de type paire clé-valeur.

Nom affiché dans la AWS IoT console : ARN du code secret du nom d'utilisateur/mot de passe OPC-UA

Nécessaire : false

Type : string

Modèle valide : ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

Ressource secrète du groupe AWS IoT Greengrass qui fait référence à un secret de nom d'utilisateur et mot de passe OPC-UA.

Nom affiché dans la AWS IoT console : ressource secrète de nom d'utilisateur/mot de passe OPC-UA

Nécessaire : false

Type : string

Modèle valide : ^$|.+

MaximumBufferSize

Taille maximale en Go pour l'utilisation des SiteWise disques IoT. La valeur par défaut est 10 Go.

Nom affiché dans la AWS IoT console : taille maximale de la mémoire tampon du disque

Nécessaire : false

Type : string

Modèle valide : ^\s*$|[0-9]+

Exemple de création de connecteur (AWS CLI)

La AWS CLI commande suivante crée un ConnectorDefinition avec une version initiale contenant le SiteWise connecteur IoT.


aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTSiteWiseConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11"
        }
    ]
}'

Note

Les fonctions Lambda de ce connecteur ont un cycle de vie prolongé.

Dans la AWS IoT Greengrass console, vous pouvez ajouter un connecteur depuis la page Connecteurs du groupe. Pour plus d’informations, consultez Mise en route avec les connecteurs Greengrass (console).

Données d'entrée

Ce connecteur n'accepte pas les messages MQTT comme données d'entrée.

Données de sortie

Ce connecteur ne publie pas les messages MQTT en tant que données de sortie.

Limites

Ce connecteur est soumis à toutes les limites imposées par l'IoT SiteWise, y compris les suivantes. Pour plus d'informations, consultez la section AWS IoT SiteWisePoints de terminaison et quotas dans le. Références générales AWS

Nombre maximum de passerelles par. Compte AWS
Nombre maximal de sources OPC-UA par passerelle.
Débit maximal de points de données timestamp-quality-value (TQV) stockés par. Compte AWS
Taux maximal de points de données TQV stockés par propriété de ressource.

Licences

Journal des modifications

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

Version	Modifications	Date
12	Cette version contient des corrections de bogues.	22 décembre 2021
11	Support pour les chaînes contenant des caractères masqués ou non imprimables. Les caractères masqués et non imprimables sont automatiquement supprimés avant que les chaînes ne soient envoyées au. AWS Cloud Correction d'un problème en raison duquel la SiteWise passerelle IoT réessayait indéfiniment les demandes non valides. Correction d'un problème qui provoquait un point de contrôle endommagé lorsque la SiteWise passerelle IoT était connectée à une source de données haute fréquence. Messages d'erreur améliorés pour aider à résoudre les problèmes de configuration de la passerelle.	24 mars 2021
10	Configuré `StreamManager` pour améliorer la gestion lorsque la connexion source est perdue puis rétablie. Cette version accepte également les valeurs OPC-UA avec un `ServerTimestamp` lorsque non `SourceTimestamp` est disponible.	22 janvier 2021
9	Support lancé pour les destinations de `StreamManager` streaming Greengrass personnalisées, le deadbanding OPC-UA, le mode de scan personnalisé et le taux de scan personnalisé. Inclut également des performances améliorées lors des mises à jour de configuration effectuées à partir de la SiteWise passerelle IoT.	15 décembre 2020
8	Stabilité améliorée lorsque le connecteur est confronté à une connectivité réseau intermittente.	19 novembre 2020
7	Correction d'un problème lié aux métriques de passerelle.	14 août 2020
6	Ajout de la prise en charge des CloudWatch métriques et de la découverte automatique de nouvelles balises OPC-UA. Cette version nécessite le gestionnaire de flux et le logiciel AWS IoT Greengrass Core version 1.10.0 ou ultérieure.	29 avril 2020
5	Correction d'un problème de compatibilité avec le logiciel AWS IoT Greengrass Core v1.9.4.	12 février 2020
4	Correction d'un problème lié à la reconnexion du serveur OPC-UA.	7 février 2020
3	Suppression de l'obligation des autorisations `iot:*`.	17 décembre 2019
2	Ajout de la prise en charge de plusieurs ressources de secret OPC-UA.	10 décembre 2019
1	Première version.	2 décembre 2019

Un groupe Greengrass ne peut contenir qu'une seule version du connecteur à la fois. Pour de plus amples informations sur la mise à niveau d'une version de connecteur, veuillez consulter Mise à niveau des versions du connecteur.

Consultez aussi

Intégrer à des services et protocoles à l'aide de connecteurs Greengrass
Mise en route avec les connecteurs Greengrass (console)
Démarrage avec les connecteurs Greengrass (CLI)
Consultez les rubriques suivantes dans le Guide de l'utilisateur AWS IoT SiteWise :

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

Adaptateur de protocole IP IoT Ethernet

Kinesis Firehose