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 SiteWise processeur IoT (aws.iot.SiteWiseEdgeProcessor) permet aux AWS IoT SiteWise passerelles de traiter les données à la périphérie.

Avec 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 du périphérique dans le Guide de l'AWS IoT SiteWise utilisateur.

Versions

Les versions de ce composant sont les suivantes :

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3,0.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 de plus amples informations, veuillez consulter 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 20.04 or 18.04

      Architecture : x86_64 () AMD64

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

      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

  • 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 pour être utilisés 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'interruption de la connexion.

    Note

    Le port 8087 est requis uniquement 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 appareils. AWS IoT Greengrass V2 Pour plus d'informations, consultez la section Exigences du guide de AWS IoT SiteWise l'utilisateur.

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 de plus amples informations, veuillez consulter Autoriser le trafic des appareils via un proxy ou un pare-feu.

Point de terminaison 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

sts.region.amazonaws.com

443 Oui

Obtenez l'identifiant de votre Compte AWS.

monitor.iotsitewise.region.amazonaws.com

443 Non

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

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.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 de la recette 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 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. Remplacer /greengrass/v2 ou C:\greengrass\v2 avec le chemin d'accès au 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 les logiciels/licences tiers suivants :

  • Apache-2.0

  • MIT

  • BSD-2 Clause

  • BSD-Article 3

  • CDDL-1,0

  • CDDL-1,1

  • ISC

  • Zlib

  • GPL-3.0 avec- -exception GCC

  • Domaine public

  • Python-2.0

  • Unicode- DFS -2015

  • BSD-1-Clause

  • Ouvert SSL

  • 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 logicielle Greengrass Core.

Journal des modifications

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

Version

Modifications

3.3.0

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

  • Encombrement mémoire réduit pour maintenir un cache contenant un grand nombre de propriétés de ressources synchronisées.

Corrections de bogues et améliorations
  • Suppression des journaux pour l'ingestion des valeurs de propriétés individuelles en l'absence d'erreur d'ingestion, ce qui réduit le bruit des journaux en cas de taux d'ingestion élevés.

  • Meilleure lisibilité du journal grâce à l'utilisation d'un format lisible par l'homme pour certaines entrées du journal.

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

3.2.1

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

  • Correction du problème consistant à ne plus publier la MessageRemaining.SiteWise_Edge_Stream métrique.

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

    • 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 API services afin de réduire l'encombrement mémoire et de 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
  • GetAssetPropertyValueAggregatesAPIprend désormais en charge les fenêtres d'agrégation de 15 minutes sur le bord.

  • 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 APIs le plan de AWS IoT SiteWise donnéesget-asset-property-value, tel que, passe de http://localhost:8081 àhttp://localhost:11080/data. Le point de terminaison local du plan de AWS IoT SiteWise contrôle APIslist-asset-models, tel que, passe de http://localhost:11080 àhttp://localhost:11080/control. AWS vous recommande toujours d'utiliser les HTTPS points de terminaison de la passerelle SiteWise Edge. Ces points de terminaison n'ont pas changé.

Corrections de bogues 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 permettra de résoudre les problèmes liés à la corruption de certaines ressources après un redémarrage forcé.

  • Corrige une situation rare dans laquelle 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 permettre au HTTP point de terminaison APIs d'être appelé en externe. Ne HTTPS peut désormais être utilisé que pour appeler APIs en dehors de l'adresse de boucle locale.

  • ListAssetsAPIaffiche désormais la hiérarchie des actifs pour les actifs stockés en périphérie.

  • Résout un problème d'échec du redémarrage, de mise à niveau ou de rétrogradation du pack de traitement des données sous Windows.

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

3.1.3

Corrections de bogues et améliorations
  • Correction d'un problème selon lequel 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 bogues et améliorations
  • Correction d'un problème d'échec de la demande SigV4 en raison d'une incompatibilité de fuseau horaire.

  • Correction d'un problème selon lequel les propriétés de transformation et de métrique cessent d'être calculées lorsqu'elles reposent sur des attributs après le redémarrage.

  • Activez la prise en charge de la configuration personnalisée du port Stream Manager.

  • Corrigez un problème en raison duquel les propriétés synchronisées avec le périphérique pouvaient ne plus être mises à jour.

3.1.0

Corrections de bogues et améliorations
  • Correction d'un problème qui ListAssetModels API empêchait de générer le jeton suivant.

3.0.0

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

2.2.1

Corrections de bogues 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,137

Corrections de bogues et améliorations
  • Dépréciez le dependency-routing-service processus et intégrez ses fonctionnalités au property-state-service processus afin de réduire l'utilisation des ressources liées à la communication des processus.

  • Augmentez la limite de résultats maximale de 20 000 get-asset-property-value-history API pour qu'elle corresponde à 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 get-asset-property-value-history API lorsqu'aucune limite maximale de résultats n'était spécifiée.

2,135

Corrections de bogues 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 bogues et améliorations
  • Ajuste les calculs de métrique/transformation pour utiliser le multi-threading sous Linux. Windows continue d'exécuter des calculs monothread 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 bogues et améliorations
  • Résout un problème lié au signalement de l'état d'erreur sur la console Greengrass.

2.1.32

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

2.1.31

Corrections de bogues et améliorations
  • Prend en charge le 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. AWS IoT SiteWise

2,129

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

2.1.28

Corrections de bogues et améliorations
  • Optimise la synchronisation des ressources pour permettre à un grand nombre de ressources de se synchroniser de la périphérie AWS Cloud à la périphérie.

2.1.24

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

2.1.23

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

  • Synchronisation des ressources optimisée 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 le docker pour les systèmes d'exploitation basés sur Linux.

2,0,16

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

2,0,15

Corrections de bogues et améliorations
  • Modifie le port que ce composant utilise pour les API opérations de synchronisation des ressources de 8085 à 8087. Par conséquent, ce composant nécessite désormais la disponibilité du port 8087. 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 API des opérations.

2,0,14

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

2.0.13

Corrections de bogues et améliorations
  • Résout un problème : 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 les AWS IoT SiteWise ressources sur le périphérique principal.

  • Ajoute API des opérations locales supplémentaires que vous pouvez utiliser pour surveiller 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 l' AWS IoT SiteWise application AWS OpsHub for 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 voir l'état de santé des conteneurs.

2.0.7

Corrections de bugs et améliorations
  • Corrige la prise en charge de l'affichage des AWS IoT SiteWise Monitor portails sur le périphérique 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 Lightweight Directory Access Protocol (LDAP) pour l'authentification.

2.0.2

Première version.

Consultez aussi