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

SiteWise Éditeur IoT

Le composant SiteWise éditeur IoT (aws.iot.SiteWiseEdgePublisher) permet aux AWS IoT SiteWise passerelles d'exporter des données de la périphérie vers le AWS Cloud.

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 :

3.1.x
3,0. 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 plus d’informations, consultez 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 (RHEL) 8
  
  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)
L'appareil principal de Greengrass doit se connecter à Internet.
L'appareil principal de Greengrass doit être autorisé à effectuer l'iotsitewise:BatchPutAssetPropertyValueaction. Pour plus d'informations, voir Autoriser les appareils principaux à interagir avec AWS les services.
Exemple stratégie d'autorisation
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}
```

Points de terminaison et ports

Ce composant doit être capable d'effectuer des demandes sortantes vers les points de terminaison et les ports suivants, en plus des points de terminaison et des ports requis pour le fonctionnement de base. Pour plus d’informations, consultez Autoriser le trafic des appareils via un proxy ou un pare-feu.

Point de terminaison	Port	Obligatoire	Description
`data.iotsitewise.region.amazonaws.com`	443	Oui	Publiez les données sur AWS IoT SiteWise.

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 pour les versions 2.0.x à 2.2.x 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

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 l'API pour configurer le composant SiteWise éditeur IoT. Pour plus d'informations, voir Étape 3 : Configuration de l'éditeur - facultatif dans le guide de AWS IoT SiteWise l'utilisateur.

Données d'entrée

Ce composant lit PutAssetPropertyValueEntry les messages du gestionnaire de AWS IoT Greengrass flux. Pour plus d'informations, consultez PutAssetPropertyValueEntryla référence de AWS IoT SiteWise l'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 C:\greengrass\v2 par le chemin d'accès au dossier AWS IoT Greengrass racine.
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.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 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


accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

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
3.1.3	Corrections de bogues et améliorations Résolution d'un problème en raison duquel le fichier journal des événements situé à l'adresse `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log` avait été créé mais aucun événement n'était enregistré. Les CloudWatch métriques suivantes ont été ajoutées pour surveiller la connexion avec le broker MQTT : `IoTSiteWisePublisher.IsConnectedToMqttBroker` `IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker` `IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived` `IoTSiteWisePublisher.MqttMessageReceivedSuccessCount` `IoTSiteWisePublisher.MqttReceivedSuccessBytes` Pour plus d'informations sur ces mesures, consultez la section Mesures de AWS IoT Greengrass Version 2 passerelle. Résolution d'un problème selon lequel l'`BatchCreateJob`API était toujours appelée même en cas d'échec du téléchargement d'un fichier parquet vers S3.
3.1.2	Corrections de bogues et améliorations Correction du problème d'utilisation élevée du processeur introduit dans la version 3.1.1.
3.1.1	Corrections de bogues et améliorations Ajoute une journalisation supplémentaire qui identifie les alias de données concernés en cas d'erreur. Ajoute l'application locale des limites d' AWS IoT SiteWise API relatives à l'âge des données ingérées. Résout le problème selon lequel Publisher mélange les points de contrôle des StreamManager flux lorsqu'il existe plusieurs destinations Amazon S3. Résout le problème de performance lié à la manière dont l'éditeur lit les StreamManager flux.
3.1.0	Nouvelles fonctionnalités Permet de publier des données sous forme de fichiers parquet sur Amazon S3. Ajoute un support pour l'ingestion AWS IoT SiteWise en mémoire tampon.
3.0.0	Corrections de bogues et améliorations Résout les problèmes liés à la prise en charge des proxys. Nouvelles fonctionnalités Permet de prendre en charge l'ingestion de données à partir d'un courtier MQTT.
2.4.1	Corrections de bogues et améliorations Activez le composant pour qu'il fonctionne avec Java Corretto 11 versions 11.0.20.8.1 et ultérieures. Les versions 2.4.0 et 2.3.3 du composant affichent le message `"Could not find or load main class"` d'erreur lorsqu'elles sont utilisées avec Java Corretto version 11.0.20.8.1.
2.4.0	Nouvelles fonctionnalités Ajoute un nouveau journal des événements pour faciliter l'identification et la résolution des problèmes. Corrections de bogues et améliorations Améliore la restauration des points de contrôle de Publisher.
2.3.3	Corrections de bogues et améliorations Améliore la capacité à prendre en charge un débit élevé.
2.3.2	Corrections de bogues et améliorations Résout le support du proxy HTTP lors du téléchargement de la configuration de Publisher.
2.3.1	Nouvelles fonctionnalités Prend en charge l'installation du pack de collecte de données sur l'architecture Linux ARMv8. Configuration minimale requise pour Linux ARMv8 : Mémoire : 4 Go Processeur : ARM Cortex-A72 ou spécification équivalente
2.2.3	Corrections de bogues et améliorations Supprime la nouvelle tentative pour une exception générique qui ne figurait pas dans la liste des exceptions récupérables.
2.2.2	Corrections de bogues et améliorations Réintroduit la prise en charge du téléchargement de données AWS IoT SiteWise via un serveur proxy HTTP.
2.2.1	Note Cette version ne prend pas en charge la configuration du proxy HTTP. Les versions 2.2.2 et supérieures réintroduisent le support de cette fonctionnalité. Nouvelles fonctionnalités Ajoute la prise en charge de ce composant pour activer la compression lors du téléchargement de données vers. AWS IoT SiteWise
2.2.0	Note Cette version ne prend pas en charge la configuration du proxy HTTP. Les versions 2.2.2 et supérieures réintroduisent le support de cette fonctionnalité. Nouvelles fonctionnalités Met à jour ce composant pour compresser les données avant de les envoyer au AWS IoT SiteWise service. Dans la plupart des cas, cette modification réduit l'utilisation de la bande passante de 75 % par rapport aux versions précédentes de ce composant. Dans la plupart des cas, cette modification augmente l'utilisation du processeur jusqu'à 5 %. Sur les passerelles qui traitent de grandes quantités de données, cette modification peut augmenter l'utilisation du processeur jusqu'à 15 %. Cette modification n'a aucune incidence sur les frais AWS IoT SiteWise de service ni sur l'utilisation des quotas de service. Ajoute la prise en charge de Windows Server 2019 ou version ultérieure. Corrections de bogues et améliorations Résout un problème qui empêchait ce composant de démarrer lorsque le fichier de point de contrôle est endommagé.
2.1.4	Corrections de bogues et améliorations Corrige la compatibilité avec la version 8 de Java.
2.1.3	Avertissement Cette version n'est plus disponible, sauf dans les régions de l'est des États-Unis (Ohio), du Canada (centre) et AWS GovCloud (de l'est des États-Unis). Cette version du composant nécessite la version 11 ou supérieure de Java pour fonctionner. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant. 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. Mises à jour pour enregistrer les erreurs en cas d'échec des téléchargements de données.
2.1.2	Corrections de bogues et améliorations Mises à jour pour invoquer la fonctionnalité d'exportation des données expirées dès que les données expirent.
2.1.1	Corrections de bogues et améliorations.
2.1.0	Nouvelles fonctionnalités Permet de publier d'abord les données les plus récentes dans le cloud. Permet de ne pas publier les données expirées dans le cloud. Ajoute la prise en charge du stockage local des données expirées. Corrections de bogues et améliorations Réduit les E/S du disque et la latence correspondante.
2.0.2	Corrections de bogues et améliorations.
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

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

SiteWise Processeur IoT