Gestionnaire de flux - 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.

Gestionnaire de flux

Le composant du gestionnaire de flux (aws.greengrass.StreamManager) vous permet de traiter les flux de données à transférer vers les appareils principaux AWS Cloud de Greengrass.

Pour plus d'informations sur la configuration et l'utilisation du gestionnaire de flux dans les composants personnalisés, consultezGérez les flux de données sur les appareils principaux de Greengrass.

Versions

Les versions de ce composant sont les suivantes :

  • 2,1x

  • 2,0.x

Note

Si vous utilisez le gestionnaire de flux pour exporter des données vers le cloud, vous ne pouvez pas mettre à niveau la version 2.0.7 du composant du gestionnaire de flux vers une version comprise entre v2.0.8 et v2.0.11. Si vous déployez le gestionnaire de flux pour la première fois, nous vous recommandons vivement de déployer la dernière version du composant du gestionnaire de flux.

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 :

  • Le rôle d'échange de jetons doit autoriser l'accès aux AWS Cloud destinations que vous utilisez avec le gestionnaire de flux. Pour plus d’informations, consultez :

  • Le composant du gestionnaire de flux est compatible pour s'exécuter dans unVPC. Pour déployer ce composant dans unVPC, les éléments suivants sont requis.

    • Le composant du gestionnaire de flux doit être connecté au AWS service sur lequel vous publiez des données.

      • Amazon S3 : com.amazonaws.region.s3

      • Amazon Kinesis Data Streams : com.amazonaws.region.kinesis-streams

      • AWS IoT SiteWise: com.amazonaws.region.iotsitewise.data

    • Si vous publiez des données sur Amazon S3 dans la us-east-1 région, ce composant essaiera d'utiliser le point de terminaison global S3 par défaut ; toutefois, ce point de terminaison n'est pas disponible via le point de terminaison de l'VPCinterface Amazon S3. Pour plus d'informations, consultez la section Restrictions et limites de AWS PrivateLink pour Amazon S3. Pour résoudre ce problème, vous pouvez choisir l'une des options suivantes.

      • Configurez le composant du gestionnaire de flux pour utiliser le point de terminaison S3 régional de la us-east-1 région, en le configurant -Daws.s3UseUsEast1RegionalEndpoint=regional dansJVM_ARGS.

      • Créez un point de VPC terminaison de passerelle Amazon S3 au lieu d'un point de VPC terminaison d'interface Amazon S3. Les points de terminaison de la passerelle S3 prennent en charge l'accès au point de terminaison global S3. Pour plus d'informations, consultez la section Créer un point de terminaison de passerelle.

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

iotanalytics.region.amazonaws.com

443 Non

Obligatoire si vous publiez des données sur AWS IoT Analytics.

kinesis.region.amazonaws.com

443 Non

Obligatoire si vous publiez des données sur Firehose.

data.iotsitewise.region.amazonaws.com

443 Non

Obligatoire si vous publiez des données sur AWS IoT SiteWise.

*.s3.amazonaws.com

443 Non

Obligatoire si vous publiez des données dans des compartiments S3.

Vous pouvez le * remplacer par le nom de chaque compartiment dans lequel vous publiez des données.

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.

2.1.13

Le tableau suivant répertorie les dépendances pour les versions 2.1.11 à 2.1.10 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,14.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.11 - 2.1.12

Le tableau suivant répertorie les dépendances pour les versions 2.1.11 à 2.1.10 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0,0 <2,13,0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.9 – 2.1.10

Le tableau suivant répertorie les dépendances pour les versions 2.1.9 à 2.1.10 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,12.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.5 – 2.1.8

Le tableau suivant répertorie les dépendances pour les versions 2.1.5 à 2.1.8 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,11.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.2 – 2.1.4

Le tableau suivant répertorie les dépendances pour les versions 2.1.2 à 2.1.4 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0,0 <2,1,0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.1

Le tableau suivant répertorie les dépendances pour la version 2.1.1 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,9.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.1.0

Le tableau suivant répertorie les dépendances pour la version 2.1.0 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,8.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.15

Le tableau suivant répertorie les dépendances pour la version 2.0.15 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,7.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.13 and 2.0.14

Le tableau suivant répertorie les dépendances pour les versions 2.0.13 et 2.0.14 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,6.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.11 and 2.0.12

Le tableau suivant répertorie les dépendances pour les versions 2.0.11 et 2.0.12 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,5.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.10

Le tableau suivant répertorie les dépendances pour la version 2.0.10 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,4.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.9

Le tableau suivant répertorie les dépendances pour la version 2.0.9 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,3.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.8

Le tableau suivant répertorie les dépendances pour la version 2.0.8 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0.0 <2,2.0 Flexible
Service d'échange de jetons >=0,0.0 Stricte
2.0.7

Le tableau suivant répertorie les dépendances pour la version 2.0.7 de ce composant.

Dépendance Versions compatibles Type de dépendance
Noyau de Greengrass >=2,0,3 <2,10 Flexible
Service d'échange de jetons >=0,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 fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

STREAM_MANAGER_STORE_ROOT_DIR

(Facultatif) Le chemin absolu du répertoire local utilisé pour stocker les flux. Cette valeur doit commencer par une barre oblique (par exemple, /data).

Vous devez spécifier un dossier existant, et l'utilisateur du système qui exécute le composant du gestionnaire de flux doit être autorisé à lire et à écrire dans ce dossier. Par exemple, vous pouvez exécuter les commandes suivantes pour créer et configurer un dossier/var/greengrass/streams, que vous spécifiez comme dossier racine du gestionnaire de flux. Ces commandes permettent à l'utilisateur du système par défaut de lire et d'écrire dans ce dossier. ggc_user

sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams

Par défaut : /greengrass/v2/work/aws.greengrass.StreamManager

STREAM_MANAGER_SERVER_PORT

(Facultatif) Le numéro de port local à utiliser pour communiquer avec le gestionnaire de flux.

Vous pouvez spécifier 0 d'utiliser un port disponible de manière aléatoire.

Par défaut : 8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(Facultatif) Vous pouvez obliger les clients à s'authentifier avant de pouvoir interagir avec le gestionnaire de flux. Le Stream Manager SDK contrôle l'interaction entre les clients et le gestionnaire de flux. Ce paramètre détermine quels clients peuvent appeler le Stream Manager SDK pour travailler avec des flux. Pour plus d'informations, consultez la section Authentification du client du gestionnaire de flux.

Si vous le spécifieztrue, le Stream Manager n'SDKautorise que les composants Greengrass en tant que clients.

Si vous le spécifiezfalse, le Stream Manager SDK permet à tous les processus du périphérique principal d'être des clients.

Par défaut : true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(Facultatif) Bande passante maximale moyenne (en kilobits par seconde) que le gestionnaire de flux peut utiliser pour exporter des données.

Par défaut : pas de limite

STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

(Facultatif) Le nombre maximum de threads actifs que le gestionnaire de flux peut utiliser pour exporter des données.

La taille optimale dépend de votre matériel, du volume de flux et du nombre planifié de flux d'exportation. Si votre vitesse d'exportation est faible, vous pouvez ajuster ce paramètre afin de trouver la taille optimale en fonction de votre matériel et de votre analyse de rentabilisation. La mémoire CPU et le matériel de base de votre appareil sont des facteurs limitatifs. Pour commencer, vous pouvez essayer de définir cette valeur par le nombre de cœurs de processeur sur l'appareil.

Veillez à ne pas définir une taille supérieure à ce que votre matériel peut prendre en charge. Chaque flux consomme des ressources matérielles. Essayez donc de limiter le nombre de flux d'exportation sur les appareils soumis à des contraintes.

Par défaut : 5 fils

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(Facultatif) Taille minimale (en octets) d'une partie dans un téléchargement partitionné vers Amazon S3. Le gestionnaire de flux utilise ce paramètre et la taille du fichier d'entrée pour déterminer comment regrouper les données dans une PUT demande en plusieurs parties.

Note

Le gestionnaire de flux utilise la sizeThresholdForMultipartUploadBytes propriété streams pour déterminer s'il convient d'exporter vers Amazon S3 sous forme de téléchargement en une ou plusieurs parties. AWS IoT Greengrass les composants peuvent définir ce seuil lorsqu'ils créent un flux exporté vers Amazon S3.

Par défaut : 5242880 (5 Mo). Il s'agit également de la valeur minimale.

LOG_LEVEL

(Facultatif) Le niveau de journalisation du composant. Choisissez parmi les niveaux de journalisation suivants, listés ici par ordre de niveau :

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

Par défaut : INFO

JVM_ARGS

(Facultatif) Les arguments personnalisés de la machine virtuelle Java à transmettre au gestionnaire de flux au démarrage. Séparez les arguments multiples par des espaces.

Utilisez ce paramètre uniquement lorsque vous devez remplacer les paramètres par défaut utilisés par leJVM. Par exemple, il peut s'avérer nécessaire d'augmenter la taille de pile par défaut si vous prévoyez d'exporter un grand nombre de flux.

Exemple : mise à jour de la fusion de configurations

L'exemple de configuration suivant indique d'utiliser un port autre que le port par défaut.

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

Fichier journal local

Ce composant utilise le fichier journal suivant.

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

Journal des modifications

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

Version

Modifications

2.1.13

Corrections de bogues et améliorations

Prend en charge les FIPS points de terminaison pour AWS IoT SiteWise

2.1.12

Corrections de bogues et améliorations

Met à jour l'ordre dans lequel les informations d'identification sont utilisées afin que les informations d'identification Greengrass soient préférées pour les demandes de AWS service.

2.1.11

Version mise à jour pour la version 2.12.0 de Greengrass Nucleus.

2.1.10

Corrections de bogues et améliorations

Résout un problème selon lequel la configuration du HTTPS proxy ne fait pas confiance à la chaîne de certificats de l'autorité de certification (CA) Greengrass.

2.1.9

Version mise à jour pour la version 2.11.0 de Greengrass Nucleus.

2.1.8

Corrections de bogues et améliorations

Résout un problème selon lequel le gestionnaire de flux réessaie indéfiniment SiteWise les exportations échouant avec. InvalidRequestException

2.1.7

Corrections de bogues et améliorations

Résout un problème en raison duquel le gestionnaire de flux ne lisait pas correctement la configuration du proxy.

2.1.6

Corrections de bogues et améliorations

Résout un problème susceptible de provoquer un crash au démarrage sur certains ARMv8 processeurs, notamment le Jetson Nano.

2.1.5

Version mise à jour pour la version 2.10.0 de Greengrass Nucleus.

2.1.4

Corrections de bogues et améliorations
  • Résout un problème où des entrées pour le même actif immobilier avec le même horodatage au sein d'un même lot sont renvoyées par lot, SiteWise API ce qui oblige le gestionnaire ConflictingOperationException de flux à réessayer continuellement.

  • Actualise le délai de connexion par défaut de 3 secondes à 1 minute.

2.1.3

Corrections de bogues et améliorations

Résout un problème de démarrage sur le système d'exploitation Windows lors de l'exécution en tant qu'SYSTEMutilisateur.

2.1.2

Corrections de bogues et améliorations
  • Résout un problème sur les systèmes d'exploitation Windows qui utilisent une langue autre que l'anglais.

  • Version mise à jour pour la version 2.9.0 de Greengrass Nucleus.

2.1.1

Version mise à jour pour la version 2.8.0 de Greengrass Nucleus.

2.1.0

Nouvelles fonctionnalités

2,0,15

Version mise à jour pour la version 2.6.0 de Greengrass Nucleus.

2,0,14

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

2.0.13

Version mise à jour pour la version 2.5.0 de Greengrass Nucleus.

2,0,12
Corrections de bogues et améliorations

Résout un problème qui empêchait la mise à niveau du gestionnaire de flux v2.0.7 vers une version comprise entre v2.0.8 et v2.0.11. Si vous utilisez le gestionnaire de flux pour exporter des données vers le cloud, vous pouvez désormais passer à la version 2.0.12.

2.0.11

Version mise à jour pour la version 2.4.0 de Greengrass Nucleus.

2.0.10

Version mise à jour pour la version 2.3.0 de Greengrass Nucleus.

2.0.9

Version mise à jour pour la version 2.2.0 de Greengrass Nucleus.

2.0.8

Version mise à jour pour la version 2.1.0 de Greengrass Nucleus.

2.0.7

Première version.