View a markdown version of this page

SiteWise Éditeur IoT - AWS IoT Greengrass
VersionsTypeSystème d’exploitationExigencesDépendancesConfigurationDonnées d’entréeFichier journal localRésolution des problèmes et débogageLicencesJournal des modificationsConsultez aussi

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 Éditeur IoT

Le composant IoT SiteWise Publisher (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 en périphérie dans le Guide de l'AWS IoT SiteWise utilisateur.

Versions

Les versions de ce composant sont les suivantes :

  • 4.1.x

  • 4.0. x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 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 composant.

Système d’exploitation

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

  • Linux

  • Windows

Exigences

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
    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Points de terminaison et ports

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

Endpoint Port Obligatoire Description

data.iotsitewise.region.amazonaws.com

 443 Oui

Publiez des données sur AWS IoT SiteWise.

Dépendances

Lorsque vous déployez un composant, déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez répondre aux exigences relatives au composant et à toutes ses dépendances pour pouvoir le déployer avec succès. Cette section répertorie les dépendances pour les 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 pour chaque version du composant dans la AWS IoT Greengrass console. Sur la page des détails des composants, 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 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 IoT SiteWise Publisher. 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 PutAssetPropertyValueEntry dans la Référence d’API AWS IoT SiteWise .

Fichier journal local

Ce composant utilise le fichier journal suivant.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Pour afficher 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 du 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

Résolution des problèmes 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.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Ce journal contient des informations détaillées et des instructions de dépannage. Des informations de dépannage sont fournies parallèlement aux 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 informations suivantes :

  • Niveau de gravité

  • Horodatage

  • Informations supplémentaires spécifiques à l'événement

Exemple 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 du logiciel Greengrass Core.

Journal des modifications

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

Version

Modifications

4.1.4
Corrections de bugs et améliorations

  • L' SiteWise éditeur IoT communique désormais les indicateurs de santé du système, tels que l'utilisation de la mémoire et du processeur de l' SiteWise éditeur IoT, à CloudWatch.

  • Mise à jour des rapports d'erreur AWS IoT Greengrass afin que IoT SiteWise Publisher soit redémarré en cas d'échec partiel du flux de démarrage.

4.1.3
Corrections de bugs et améliorations

  • Corrige une fuite de mémoire lors du processus de vérification des données.

  • Corrige les failles de sécurité.

4.1.2
Corrections de bugs et améliorations

  • Résout un problème lié à la synchronisation de configurations volumineuses.

  • Les retards d'inscription AWS IoT Core n'affecteront plus le processus de démarrage.

  • Les retards dans l'initialisation des points de contrôle n'ont plus d'incidence sur le processus de démarrage.

4.1.1
Corrections de bugs et améliorations

  • Résout un problème qui entraînait une utilisation élevée du processeur et de la mémoire sur les passerelles Classic Streams et V2 lors de l'envoi de données via une destination mise en AWS IoT SiteWise mémoire tampon à l'aide d'Amazon S3 après le redémarrage de l'éditeur.

  • Ajoute la prise en charge de la modification du comportement de journalisation par défaut des composants en créant un fichier facultatif situé à l'adresse :/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/log4j2.xml.

4.1.0
Nouvelles fonctionnalités

  • Ajoute un outil de ligne de commande pour gérer les utilisateurs intégrés du broker EMQX MQTT. Cette interface permet la gestion des comptes utilisateurs et configure les politiques de contrôle d'accès pour la publication de sujets MQTT et les autorisations d'abonnement.

Corrections de bugs et améliorations

  • Corrige le calcul qui détermine le nombre d'alias uniques que peut contenir un seul fichier Parquet d'ingestion Buffered.

4,0.3
Corrections de bugs et améliorations

  • Met à jour le maximum d'alias uniques par fichier d'ingestion AWS IoT SiteWise mis en mémoire tampon pour qu'il corresponde à la limite du cloud de 10 000.

  • Résout un problème de AWS IoT Greengrass journalisation qui signale de manière incorrecte des états de service non valides.

  • Ajoute une validation pour éviter la duplication des noms de flux dans les configurations de destination Amazon S3 dans les flux classiques et les passerelles V2.

  • Résout un problème de compatibilité lié à l'ingestion en AWS IoT SiteWise mémoire tampon dans des partitions non standard AWS .

  • Résout un problème qui provoquait l'ingestion de données dupliquées.

4,0.2
Corrections de bugs et améliorations

  • Résout un problème qui empêche le téléchargement de données après l'expiration du délai d'attente du lot.

  • Ajoute une validation pour vérifier que chaque destination dans MQTT-enabled les configurations de passerelle V3 est unique.

4.0.1
Corrections de bugs et améliorations

  • Résout un problème qui empêche le téléchargement des données AWS IoT SiteWise lorsque vous désactivez la configuration du temps d'attente maximal par lots.

  • Résout un problème en raison duquel la IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker métrique indique de manière inexacte le nombre de sujets uniques souscrits au courtier MQTT.

4.0.0
Nouvelles fonctionnalités

Ajoute la prise en charge des MQTT-enabled passerelles V3 en plus des flux classiques, des passerelles V2 (anciennement connues sous le nom de passerelles SiteWise Edge auto-hébergées).

Corrections de bugs et améliorations

  • Résout un problème en raison duquel la PublishSuccessCount métrique indique des valeurs négatives.

  • Résout un problème en raison duquel l'éditeur ne démarre pas dans les 100 secondes et entre dans l'BROKENétat.

  • Corrige les failles de sécurité.

3.2.0
Nouvelles fonctionnalités
Corrections de bugs et améliorations

  • Résout les problèmes provoquant la corruption des fichiers de base de données des points de contrôle.

  • Résout les problèmes liés à la génération de métriques dupliquées.

3.1.4
Avertissement

La version 3.1.4 a été abandonnée le 20 février 2025. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant.

Corrections de bugs et améliorations

  • Résout les problèmes susceptibles d'entraîner des délais de démarrage plus longs que prévu après une mise hors ligne.

3.1.3
Corrections de bugs et améliorations

  • Résout un problème en raison duquel le fichier journal des événements situé à l'/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.logadresse a été créé alors qu'aucun événement n'était enregistré.

  • Ajoute les CloudWatch métriques suivantes 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ésout un problème en raison duquel l'BatchCreateJobAPI est toujours appelée même si le téléchargement d'un fichier parquet vers S3 échoue.

3.1.2
Corrections de bugs et améliorations

  • Résout le problème d'utilisation élevée du processeur introduit dans la version 3.1.1.

3.1.1
Avertissement

La version 3.1.1 a été abandonnée le 12 mars 2024. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant.

Corrections de bugs 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.

  • Corrige le goulot d'étranglement des performances lié à la façon dont l'éditeur lit les StreamManager streams.

3.1.0
Nouvelles fonctionnalités

  • Ajoute la prise en charge de la publication de données sous forme de fichiers parquet sur Amazon S3.

  • Ajoute un support pour l'ingestion AWS IoT SiteWise tamponnée.

3.0.0
Corrections de bugs 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 bugs et améliorations

  • Activez le composant pour qu'il fonctionne avec les versions 11.0.20.8.1 et ultérieures de Java Corretto 11. Les versions des composants 2.4.0 et 2.3.3 affichent le message "Could not find or load main class" d'erreur lorsqu'elles sont utilisées avec la version 11.0.20.8.1 de Java Corretto.

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 bugs et améliorations

  • Améliore la restauration des points de contrôle de Publisher.

2.3.3
Corrections de bugs et améliorations

  • Améliore la capacité à prendre en charge un débit élevé.

2.3.2
Corrections de bugs et améliorations

  • Corrige le support du proxy HTTP lors du téléchargement de la configuration de Publisher.

2.3.1
Nouvelles fonctionnalités

  • Ajoute la prise en charge de l'installation du pack de collecte de données sur l'architecture Linux ARMv8.

  • Configuration minimale requise pour Linux ARMv8 :

    • Mémoire : 4 Go

    • CPU : ARM Cortex-A72 ou spécification équivalente

2.2.3
Corrections de bugs 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 bugs 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 de proxy HTTP. Les versions 2.2.2 et supérieures réintroduisent la prise en charge de cette fonctionnalité.

Nouvelles fonctionnalités

  • Ajoute un support à ce composant pour activer ou désactiver 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 de proxy HTTP. Les versions 2.2.2 et supérieures réintroduisent la prise en charge 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 bugs et améliorations

  • Résout un problème qui empêche ce composant de démarrer lorsque le fichier de point de contrôle est endommagé.

2.1.4
Corrections de bugs 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 USA Est (Ohio), Canada (Centre) et AWS GovCloud (US-East). 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 bugs 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 du chargement des données.

2.1.2
Corrections de bugs et améliorations

  • Mises à jour pour invoquer la fonction d'exportation de données expirées dès que les données expirent.

2.1.1

Corrections de bugs et améliorations.

2.1.0
Nouvelles fonctionnalités

  • Ajoute la prise en charge de la publication des données les plus récentes dans le cloud en premier.

  • Ajoute la prise en charge 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 bugs et améliorations

  • Réduit le disque I/O et la latence correspondante.

2.0.2

Corrections de bugs et améliorations.

2.0.1

Première version.

Consultez aussi