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.
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.
Rubriques
Versions
Les versions de ce composant sont les suivantes :
-
2.2.x
-
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 peut être exécuté dans un VPC. Pour déployer ce composant dans un VPC, 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'interface Amazon S3 VPC. 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 terminaison VPC de passerelle Amazon S3 au lieu d'un point de terminaison VPC 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 |
---|---|---|---|
|
443 | Non |
Obligatoire si vous publiez des données sur AWS IoT Analytics. |
|
443 | Non |
Obligatoire si vous publiez des données sur Firehose. |
|
443 | Non |
Obligatoire si vous publiez des données sur AWS IoT SiteWise. |
|
443 | Non |
Obligatoire si vous publiez des données dans des compartiments S3. Vous pouvez le |
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
Le tableau suivant répertorie les dépendances pour les versions 2.2.0 et 2.2.1 de ce composant.
Dépendance | Versions compatibles | Type de dépendance |
---|---|---|
Noyau de Greengrass | >=2,0.0 <2,15.0 | Flexible |
Service d'échange de jetons | >=2,2,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 :
/work/aws.greengrass.StreamManager/greengrass/v2
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 SDK Stream Manager contrôle l'interaction entre les clients et le gestionnaire de flux. Ce paramètre détermine quels clients peuvent appeler le SDK Stream Manager pour travailler avec des flux. Pour plus d'informations, consultez la section Authentification du client du gestionnaire de flux.
Si vous le spécifiez
true
, le SDK Stream Manager n'autorise que les composants Greengrass en tant que clients.Si vous le spécifiez
false
, le SDK Stream Manager 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. Le processeur et la mémoire de votre appareil principal 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 requête PUT 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 la JVM. 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.
startupTimeoutSeconds
-
(Facultatif) Durée maximale en secondes pendant laquelle le composant démarre. L'état du composant passe à
ERRORED
s'il dépasse ce délai.Par défaut :
120
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.
/logs/aws.greengrass.StreamManager.log
/greengrass/v2
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
ou/greengrass/v2
C:\greengrass\v2
par le chemin d'accès au dossier AWS IoT Greengrass racine.sudo tail -f
/logs/aws.greengrass.StreamManager.log/greengrass/v2
Journal des modifications
Le tableau suivant décrit les modifications apportées à chaque version du composant.
Version |
Modifications |
---|---|
2.2.1 |
|
2.2.0 |
|
2.1.13 |
|
2.1.12 |
|
2.1.11 |
Version mise à jour pour la version 2.12.0 de Greengrass Nucleus. |
2.1.10 |
|
2.1.9 |
Version mise à jour pour la version 2.11.0 de Greengrass Nucleus. |
2.1.8 |
|
2.1.7 |
|
2.1.6 |
|
2.1.5 |
Version mise à jour pour la version 2.10.0 de Greengrass Nucleus. |
2.1.4 |
|
2.1.3 |
|
2.1.2 |
|
2.1.1 |
Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. |
2.1.0 |
|
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 |
|
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. |