Configuration du gestionnaire de flux AWS IoT Greengrass - 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.

Configuration du gestionnaire de flux AWS IoT Greengrass

Sur les appareils principaux de Greengrass, le gestionnaire de flux peut stocker, traiter et exporter les données des appareils IoT. Le gestionnaire de flux fournit des paramètres que vous pouvez utiliser pour configurer les paramètres d'exécution. Ces paramètres s'appliquent à tous les streams sur l'appareil principal de Greengrass. Vous pouvez utiliser la AWS IoT Greengrass console ou l'API pour configurer les paramètres du gestionnaire de flux lorsque vous déployez le composant. Les modifications prennent effet une fois le déploiement terminé.

Paramètres du gestionnaire de flux

Le gestionnaire de flux fournit les paramètres suivants que vous pouvez configurer lorsque vous déployez le composant sur vos appareils principaux. Tous les paramètres sont facultatifs.

Répertoire de stockage

Nom du paramètre: STREAM_MANAGER_STORE_ROOT_DIR

Le chemin absolu du dossier 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

Pour de plus amples informations sur la sécurité des données de flux, veuillez consulter Sécurité des données locales.

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

Server port

Nom du paramètre: STREAM_MANAGER_SERVER_PORT

Numéro de port local utilisé pour communiquer avec le gestionnaire de flux. L’argument par défaut est 8088.

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

Authentification du client

Nom du paramètre: STREAM_MANAGER_AUTHENTICATE_CLIENT

Indique si les clients doivent être authentifiés pour interagir avec le gestionnaire de flux. Toutes les interactions entre les clients et le gestionnaire de flux sont contrôlées par le SDK Stream Manager. Ce paramètre détermine quels clients peuvent appeler le SDK Stream Manager pour travailler avec des flux. Pour plus d’informations, consultez Authentification client.

Les valeurs valides sont true ou false. La valeur par défaut est true (recommandé).

  • true. Autorise uniquement les composants Greengrass en tant que clients. Les composants utilisent des protocoles AWS IoT Greengrass Core internes pour s'authentifier auprès du SDK Stream Manager.

  • false. Permet à tout processus exécuté sur le AWS IoT Greengrass Core d'être un client. Ne définissez pas la valeur sur false sauf si votre analyse de rentabilisation l'exige. Par exemple, à utiliser false uniquement si les processus non composants du périphérique principal doivent communiquer directement avec le gestionnaire de flux.

Bande passante maximum

Nom du paramètre: STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

Bande passante maximale moyenne (en kilobits par seconde) pouvant être utilisée pour exporter des données. La valeur par défaut permet une utilisation illimitée de la bande passante disponible.

Taille du groupe de threads

Nom du paramètre: STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

Nombre maximal de threads actifs pouvant être utilisés pour exporter des données. L’argument par défaut est 5.

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.

Arguments JVM

Nom du paramètre: JVM_ARGS

Arguments JVM (machine virtuelle Java) personnalisés à transmettre au gestionnaire de flux au démarrage. Les arguments doivent être séparés 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.

Logging level (Niveau de journalisation)

Nom du paramètre: LOG_LEVEL

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

Taille minimale pour le téléchargement en plusieurs parties

Nom du paramètre: STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

Taille minimale (en octets) d'une partie dans un 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. La valeur minimale par défaut est de 5 5242880 octets (5 Mo).

Note

Le gestionnaire de flux utilise la sizeThresholdForMultipartUploadBytes propriété du flux pour déterminer s'il convient d'exporter vers Amazon S3 sous forme de téléchargement en une ou plusieurs parties. Les composants Greengrass définis par l'utilisateur définissent ce seuil lorsqu'ils créent un flux exporté vers Amazon S3. Le seuil par défaut est de 5 Mo.

Consultez aussi