Exigences Parameters Données d’entrée Données de sortie Restrictions Licences Journal des modifications Consultez aussi

SiteWise Connecteur IoT

Le SiteWise connecteur IoT envoie les données des appareils et équipements locaux aux propriétés des actifs dans AWS IoT SiteWise. Vous pouvez utiliser ce connecteur pour collecter des données provenant de plusieurs OPC-UA serveurs 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 de 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 OPC-UA données envoyés par les OPC-UA serveurs. 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 au AWS 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 OPC-UA des sources dans la SiteWise console IoT. Lorsque vous configurez une source dans la console, vous pouvez filtrer ou préfixer les chemins de flux de OPC-UA données envoyés par le SiteWise connecteur IoT. 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 les flux de données aux propriétés des actifs, vous pouvez définir l'alias d'une propriété de manière à ce qu'il soit équivalent à un chemin de flux de OPC-UA données. 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 OPC-UA les serveurs. Le gestionnaire de flux fournit également un support personnalisable pour la gestion de la persistance et de la bande passante. Pour de plus amples informations, veuillez consulter Gérez les flux de données sur AWS IoT Greengrass principal.

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 possède 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.

Exigences

Ce connecteur possède les critères suivants :

Version 9, 10, 11, and 12

Important

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

AWS IoT Greengrass Logiciel 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 AWS IoT Greengrass groupe d'accéder à l'iotsitewise:BatchPutAssetPropertyValueaction 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.

JSON

JSON


{
    "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 : le logiciel de AWS IoT Greengrass base v1.10.0 et le gestionnaire de flux.

AWS IoT Greengrass Logiciel 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.

JSON

JSON


{
    "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 Greengrass Logiciel 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.

JSON

JSON


{
    "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 Greengrass Logiciel 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.

JSON

JSON


{
    "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 Greengrass Logiciel 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.

JSON

JSON


{
    "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 Greengrass Logiciel 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.

JSON

JSON


{
    "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 Ajout et suppression d’autorisations basées sur l’identité IAM dans le Guide de l’utilisateur IAM.

Parameters

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

SiteWiseLocalStoragePath

Le répertoire de l' AWS IoT Greengrass hô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

Une liste de secrets AWS Secrets Manager contenant chacun une paire clé-valeur de nom OPC-UA d'utilisateur et de 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 OPC-UA username/password

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 Greengrass hô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

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

Nom affiché dans la AWS IoT console : ARN du OPC-UA username/password secret

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

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

Nom d'affichage dans la AWS IoT console : ressource OPC-UA username/password secrète

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 de plus amples informations, veuillez consulter 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.

Restrictions

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 SiteWise Points de terminaison et quotas dans le. Références générales AWS

Nombre maximum de passerelles par. Compte AWS
Nombre maximum de OPC-UA sources par passerelle.
Taux maximal de points de données TQV (timestamp-quality-value) 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 bugs.	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 OPC-UA les valeurs avec un `ServerTimestamp` lorsque aucun n'`SourceTimestamp`est disponible.	22 janvier 2021
9	Support lancé pour les destinations de `StreamManager` streaming Greengrass personnalisées, les zones OPC-UA mortes, 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 CloudWatch des métriques et de la découverte automatique de nouvelles OPC-UA balises. Cette version nécessite un gestionnaire de flux et le logiciel AWS IoT Greengrass Core v1.10.0 ou supérieur.	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 de reconnexion au OPC-UA serveur.	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 OPC-UA secrètes.	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 Ethernet IoT

Kinesis Firehose