View a markdown version of this page

SiteWise Processeur IoT - AWS IoT Greengrass

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 Processeur IoT

Le composant du SiteWise processeur IoT (aws.iot.SiteWiseEdgeProcessor) permet aux passerelles AWS IoT SiteWise Classic Streams et V2 de traiter les données à la périphérie.

Grâce à ce composant, les AWS IoT SiteWise passerelles peuvent utiliser des modèles d'actifs et des actifs pour traiter les données sur les périphériques de passerelle. 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.

Note

La fonctionnalité Data Processing Pack (DPP) ne sera plus accessible aux nouveaux clients à compter du 7 novembre 2025. Si vous souhaitez utiliser DPP, inscrivez-vous avant cette date. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section Modification de la disponibilité des packs de traitement des données dans le Guide de AWS IoT SiteWise l'utilisateur.

Versions

Les versions de ce composant sont les suivantes :

  • 3.5.x

  • 3.4.x

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.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 20.04 ou version ultérieure

      architecture : x86_64 (AMD64)

    • Système d'exploitation : Red Hat Enterprise Linux (RHEL) 8

      architecture : x86_64 (AMD64)

    • système d'exploitation : Amazon Linux 2

      architecture : x86_64 (AMD64)

    • système d'exploitation : Windows Server 2019 ou version ultérieure

      architecture : x86_64 (AMD64)

    • système d'exploitation : Debian 11 (Bullseye) ou version ultérieure

      architecture : x86_64 (AMD64)

  • Le périphérique principal de Greengrass doit autoriser le trafic entrant sur le port 443.

  • Le périphérique principal de Greengrass doit autoriser le trafic sortant sur les ports 443 et 8883.

  • Les ports suivants sont réservés à l'utilisation par AWS IoT SiteWise : 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 et 50010. L'utilisation d'un port réservé pour le trafic peut entraîner l'arrêt de la connexion.

    Note

    Le port 8087 n'est requis que pour les versions 2.0.15 et ultérieures de ce composant.

  • Le rôle d'appareil Greengrass doit disposer d'autorisations vous permettant d'utiliser des AWS IoT SiteWise passerelles sur vos AWS IoT Greengrass V2 appareils. Pour plus d'informations, consultez la section Exigences dans le Guide de AWS IoT SiteWise l'utilisateur.

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

model.iotsitewise.region.amazonaws.com

443 Oui

Obtenez des informations sur vos AWS IoT SiteWise actifs et vos modèles d'actifs.

edge.iotsitewise.region.amazonaws.com

443 Oui

Obtenez des informations sur la configuration de la AWS IoT SiteWise passerelle du périphérique principal.

ecr.region.amazonaws.com

443 Oui

Téléchargez les images Docker de la passerelle AWS IoT SiteWise Edge depuis Amazon Elastic Container Registry.

iot.region.amazonaws.com

443 Oui

Obtenez des terminaux pour votre Compte AWS appareil.

sts.region.amazonaws.com

443 Oui

Obtenez la pièce d'identité de votre Compte AWS.

monitor.iotsitewise.region.amazonaws.com

443 Non

Obligatoire si vous accédez à AWS IoT SiteWise Monitor des portails sur l'appareil principal.

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.1.x de ce composant.

Dépendance Versions compatibles Type de dépendance
Service d'échange de jetons > = 2,0,3 < 3,0,0 Stricte
Gestionnaire de flux > = 2,0,10 < 3,0,0 Stricte
Greengrass CLI > = 2,3,0 < 3,0,0 Stricte

Pour plus d'informations sur les dépendances des composants, consultez la référence des recettes des composants.

Configuration

Ce composant ne possède aucun paramètre de configuration.

Fichier journal local

Ce composant utilise le fichier journal suivant.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.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.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Licences

Ce composant inclut le tiers suivant software/licensing :

  • Apache-2.0

  • MIT

  • BSD-2-Clause

  • BSD-3-Clause

  • CDDL-1.0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0-with-GCC-exception

  • Domaine public

  • Python-2.0

  • Unicode-DFS-2015

  • BSD-1-Clause

  • OpenSSL 

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0-with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

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

3.5.1

Nouvelles fonctionnalités

Ajout de la prise en charge de l'ingestion de valeurs nulles et NaN si l'ingestion est activée dans AWS IoT SiteWise. Pour afficher ou modifier la configuration Null et NaN dans AWS IoT SiteWise, consultez les PutStorageConfiguration API DescribeStorageConfiguration et.

Corrections de bugs et améliorations

Dépendances mises à jour pour corriger les failles de sécurité potentielles.

3.4.0

Nouvelles fonctionnalités
  • Ajout de la prise en charge optionnelle des proxys HTTP et HTTPS pour permettre la communication par passerelle via des serveurs proxy nécessitant des certificats personnalisés. Pour plus d'informations sur la configuration d'un proxy HTTP pour le AWS IoT Greengrass cœur, consultezConnexion au port 443 ou via un proxy réseau. Pour plus d'informations sur la prise en charge des proxys spécifiques à SiteWise Edge, voir Gérer les magasins de confiance pour la prise en charge des proxys AWS IoT SiteWise Edge dans le Guide de AWS IoT SiteWise l'utilisateur.

  • Ajout de paramètres de temporisation de session configurables pour gérer les périodes d'inactivité AWS OpsHub et les API SiteWise Edge. Pour plus d'informations, voir Configurer les délais d'expiration des sessions pour AWS IoT SiteWise Edge dans le Guide de l'AWS IoT SiteWise utilisateur.

Améliorations des performances

Le temps nécessaire pour que les données entrantes atteignent le stockage de l'appareil Edge a été réduit de 5 secondes à moins d'une seconde. La latence des chargements de données AWS IoT SiteWise reste inchangée.

3.3.1

Nouvelle fonctionnalité
  • Ajout de la prise en charge facultative du CORS aux API SiteWise Edge, améliorant ainsi les fonctionnalités de partage de ressources entre origines. Cette fonctionnalité améliore la flexibilité des applications Web qui interagissent avec les API.

3.3.0

Améliorations des performances
  • Mécanisme d'actualisation du cache optimisé pour réduire I/O l'utilisation entre les AWS IoT SiteWise synchronisations d'actifs en actualisant uniquement les entrées des actifs nouveaux ou mis à jour.

  • Empreinte mémoire réduite pour gérer un cache contenant un grand nombre de propriétés d'actifs synchronisées.

Corrections de bugs et améliorations
  • Suppression des journaux pour l'ingestion de valeurs de propriétés individuelles lorsqu'il n'y a pas d'erreur d'ingestion, ce qui réduit le bruit des journaux en cas de taux d'ingestion élevés.

  • Amélioration de la lisibilité du journal grâce à l'utilisation d'un formatage lisible par l'homme pour certaines entrées du journal.

  • Ajout du support pour Java 17 et versions supérieures.

3.2.1

Corrections de bugs et améliorations
  • Correction d'un problème en raison duquel les appels AWS IoT SiteWise d'API ne sont pas paginés de manière synchrone avec Edge. SiteWise

  • Correction d'un problème qui empêchait de publier la MessageRemaining.SiteWise_Edge_Stream métrique.

  • Les CloudWatch mesures suivantes ont été ajoutées pour surveiller la connexion avec le courtier MQTT.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    Pour plus d'informations sur ces mesures, consultez la section Mesures de AWS IoT Greengrass Version 2 passerelle.

3.2.0

Améliorations des performances
  • Optimisez les services d'API pour réduire l'encombrement de la mémoire et nécessiter moins d'espace disque pour l'installation

    • Cela permet de réduire de 2 Go l'utilisation initiale de la mémoire (utilise désormais 7,5 Go de mémoire au démarrage, mais 16 Go sont toujours recommandés) et de 500 Mo de réduction de la taille du téléchargement (nécessite désormais un téléchargement de 1,4 Go) pour l'ensemble du composant.

Nouvelles fonctionnalités
  • GetAssetPropertyValueAggregatesL'API prend désormais en charge des fenêtres d'agrégation de 15 minutes en périphérie.

  • Les ports 8081 et 8082 n'ont plus besoin d'être disponibles pour que ce composant fonctionne correctement.

    Note

    Le point de terminaison local pour les API de plan de AWS IoT SiteWise donnéesget-asset-property-value, telles que, passe de http://localhost:8081 àhttp://localhost:11080/data. Le point de terminaison local pour les API du plan de AWS IoT SiteWise contrôlelist-asset-models, telles que, passe de http://localhost:11080 àhttp://localhost:11080/control. AWS recommande toujours d'utiliser les points de terminaison HTTPS de la passerelle SiteWise Edge. Ces paramètres n'ont pas changé.

Corrections de bugs et améliorations
  • La synchronisation à partir de AWS IoT SiteWise permet désormais de faire passer les ressources à un état valide si la synchronisation précédente a été interrompue. Cela résoudra les problèmes liés à la corruption de certaines ressources après un redémarrage forcé.

  • Corrige une situation rare où une ressource peut être corrompue en périphérie si elle est modifiée pendant la synchronisation. La synchronisation échouera désormais si cette condition est détectée, et la ressource sera réessayée lors de la prochaine synchronisation.

  • Résout un problème qui aurait pu autoriser l'appel externe du point de terminaison HTTP pour les API. Seul le protocole HTTPS peut désormais être utilisé pour appeler des API en dehors de l'adresse de bouclage locale.

  • ListAssetsL'API affiche désormais les hiérarchies des actifs stockés en périphérie.

  • Résout un problème qui empêchait le redémarrage, la mise à niveau ou la rétrogradation du pack de traitement des données sous Windows.

  • Corrige un bogue dans le pack de traitement des données pour Windows qui empêchait les clients d'utiliser des informations d'identification pour se connecter à un courtier MQTT.

3.1.3

Corrections de bugs et améliorations
  • Correction d'un problème en raison duquel le pack de traitement des données signalait à tort une synchronisation réussie alors que certaines ressources échouaient réellement.

  • Autorisez plusieurs actifs à porter le même nom tant qu'ils n'ont pas le même parent.

3.1.1

Corrections de bugs et améliorations
  • Correction d'un problème d'échec de la requête SIGv4 en raison d'une incompatibilité de fuseau horaire.

  • Correction d'un problème en raison duquel les propriétés de transformation et de métrique cessent de se calculer lorsqu'elles s'appuient sur des attributs après le redémarrage.

  • Activez la prise en charge de la configuration personnalisée des ports Stream Manager.

  • Corrigez un problème qui pouvait empêcher la mise à jour des propriétés synchronisées avec le périphérique.

3.1.0

Corrections de bugs et améliorations
  • Résolution du problème en raison duquel ListAssetModels l'API ne parvient pas à générer le jeton suivant.

3.0.0

Nouvelles fonctionnalités
  • Permet de prendre en charge l'ingestion de données à partir d'un courtier MQTT.

2.2.1

Corrections de bugs et améliorations
  • Ajustez le processus de synchronisation afin de rendre le stockage des données du plan de contrôle plus cohérent avec le fonctionnement du cloud. Cela a un léger impact sur la mise à niveau.

    Note

    Les données du plan de contrôle synchronisées sur la version 2.2.1 ou supérieure ne seront pas compatibles avec les versions précédentes. Pour revenir aux versions précédentes, vous devez effectuer une nouvelle installation. Cela n'a aucun impact sur les mises à niveau, les données synchronisées sur les versions précédentes fonctionneront avec la version 2.2.1.

  • Modifications supplémentaires apportées à la chaîne AWS d'informations d'identification pour hiérarchiser les AWS IoT Greengrass V2 informations d'identification.

2,1,37

Corrections de bugs et améliorations
  • Dépréciez le processus dependency-routing-service et déplacez ses fonctionnalités vers le processus property-state-service afin de réduire l'utilisation des ressources par les processus de communication.

  • Augmentez la limite de résultats maximale pour l'get-asset-property-value-historyAPI à 20 000 afin de correspondre à la limite utilisée par AWS IoT SiteWise.

  • Correction d'un problème en raison duquel le jeton suivant n'était pas fourni dans les résultats paginés de l'get-asset-property-value-historyAPI alors qu'aucune limite de résultats maximale n'était spécifiée.

2,1,35

Corrections de bugs et améliorations
  • Modifie la chaîne AWS d'informations d'identification pour hiérarchiser les AWS IoT Greengrass informations d'identification.

  • Résout un problème lié à la détection des comptes lors du déploiement dans le cadre d'un AWS IoT groupe d'objets.

2,1.34

Corrections de bugs et améliorations
  • Ajuste les metric/transform calculs pour utiliser le multithreading sous Linux. Windows continue d'exécuter des calculs à thread unique pour des raisons de compatibilité.

  • Résout un problème en raison duquel les calculs métriques étaient absents pour certaines fenêtres de calcul.

2,1.33

Corrections de bugs et améliorations
  • Résout un problème lié au signalement de l'état d'erreur à la console Greengrass.

2,1.32

Corrections de bugs et améliorations
  • Ajoute la prise en charge des noms d'utilisateur et des groupes personnalisés.

2,1.31

Corrections de bugs et améliorations
  • Ajoute la prise en charge du calcul de la moyenne pondérée dans le temps et de l'écart type pondéré dans le temps pour les données modélisées dans. AWS IoT SiteWise

2,1,29

Corrections de bugs et améliorations
  • Ajoute la prise en charge de la fonctionnalité de filtrage des actifs en périphérie.

2,1.28

Corrections de bugs et améliorations
  • Optimise la synchronisation des ressources pour permettre la synchronisation d'un grand nombre d'actifs de la périphérie AWS Cloud à la périphérie.

2,1.24

Corrections de bugs et améliorations
  • Résout un problème qui provoquait la disparition du tableau de bord lors de la deuxième synchronisation d'une ressource.

2,1.23

Corrections de bugs et améliorations
  • Ajout d'un délai d'attente pour le aws.iot.SiteWiseEdgeProcessor processus d'installation afin d'éviter tout échec de l'installation si la connectivité Internet est lente.

  • Synchronisation optimisée des ressources pour améliorer l'efficacité de la synchronisation entre le cloud et la périphérie.

2,1.21

Avertissement

La mise à niveau de la version 2.0.x vers la version 2.1.x entraînera une perte de données locales.

Nouvelles fonctionnalités
  • Ajoute la prise en charge de Windows Server 2019 ou version ultérieure.

  • Supprime Docker pour les systèmes Linux-based d'exploitation.

2,0,16

Cette version contient des corrections de bugs et des améliorations.

2,0,15

Corrections de bugs et améliorations
  • Fait passer le port que ce composant utilise pour les opérations de l'API de synchronisation des ressources de 8085 à 8087. Par conséquent, ce composant nécessite désormais que le port 8087 soit disponible. Ce composant nécessite toujours que le port 8085 soit disponible.

  • Met à jour AWS OpsHub l'authentification pour refuser les utilisateurs non autorisés lors de la connexion plutôt que lorsqu'un utilisateur tente d'appeler les opérations de l'API.

2,0,14

Cette version contient des corrections de bugs et des améliorations.

2.0.13

Corrections de bugs et améliorations
  • Résout un problème selon lequel, lorsque ce composant transmet des données à Amazon CloudWatch Metrics, il indique désormais correctement quelles données ne sont pas modélisées.

2,0,9

Corrections de bugs et améliorations
  • Améliore la fiabilité pour créer et mettre à jour AWS IoT SiteWise des ressources sur le périphérique principal.

  • Ajoute des opérations d'API locales supplémentaires que vous pouvez utiliser pour contrôler les composants installés sur le périphérique principal, la version de chaque composant et l'état de chaque composant. Vous pouvez consulter ces informations dans l'onglet Paramètres de AWS OpsHub l' AWS IoT SiteWise application correspondante sur l'appareil principal.

  • Ajoute un état de santé pour les conteneurs Docker exécutés par ce composant. Vous pouvez exécuter la docker ps commande pour afficher l'état de santé des conteneurs.

2.0.7

Corrections de bugs et améliorations
  • Corrige la prise en charge de l'affichage AWS IoT SiteWise Monitor des portails sur l'appareil principal.

2.0.6

Corrections de bugs et améliorations
  • Corrige les latest() fonctions AWS IoT SiteWise statetime()earliest(), et que ce composant calcule sur le périphérique principal.

2.0.5

Corrections de bugs et améliorations
  • Ajoute la prise en charge de la AWS IoT SiteWise pretrigger() fonction dans les transformations que ce composant calcule sur le périphérique principal.

  • Modifie le chemin où ce composant stocke la configuration LDAP (Lightweight Directory Access Protocol) pour l'authentification.

2.0.2

Première version.

Consultez aussi