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
<a name="stream-manager-component"></a>

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, consultez[Gérez les flux de données sur les appareils principaux de Greengrass](manage-data-streams.md).

**Topics**
+ [Versions](#stream-manager-component-versions)
+ [Type](#stream-manager-component-type)
+ [Système d’exploitation](#stream-manager-component-os-support)
+ [Prérequis](#stream-manager-component-requirements)
+ [Dépendances](#stream-manager-component-dependencies)
+ [Configuration](#stream-manager-component-configuration)
+ [Fichier journal local](#stream-manager-component-log-file)
+ [Journal des modifications](#stream-manager-component-changelog)

## Versions
<a name="stream-manager-component-versions"></a>

Les versions de ce composant sont les suivantes :
+ 2.2.x
+ 2,1x
+ 2,0.x

**Note**  <a name="stream-manager-upgrade-note"></a>
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
<a name="stream-manager-component-type"></a>

<a name="public-component-type-generic"></a>Ce <a name="public-component-type-generic-phrase"></a>composant est un composant générique (`aws.greengrass.generic`). Le [noyau Greengrass](greengrass-nucleus-component.md) exécute les scripts de cycle de vie du composant.

<a name="public-component-type-more-information"></a>Pour de plus amples informations, veuillez consulter [Types de composants](develop-greengrass-components.md#component-types).

## Système d’exploitation
<a name="stream-manager-component-os-support"></a>

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :
+ Linux
+ Windows

## Prérequis
<a name="stream-manager-component-requirements"></a>

Ce composant répond aux exigences suivantes :
+ Le [rôle d'échange de jetons](device-service-role.md) doit autoriser l'accès aux AWS Cloud destinations que vous utilisez avec le gestionnaire de flux. Pour en savoir plus, consultez :<a name="export-destinations-links"></a>
  + [AWS IoT Analytics chaînes](stream-export-configurations.md#export-to-iot-analytics)
  + [Flux de données Amazon Kinesis](stream-export-configurations.md#export-to-kinesis)
  + [AWS IoT SiteWise propriétés des actifs](stream-export-configurations.md#export-to-iot-sitewise)
  + [Objets Amazon S3](stream-export-configurations.md#export-to-s3)
+ 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 [Restrictions et limites de AWS PrivateLink pour Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/privatelink-interface-endpoints.html#privatelink-limitations). 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` dans`JVM_ARGS`.
    + Créez un point de terminaison VPC Amazon S3 Gateway 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](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3).

### Points de terminaison et ports
<a name="stream-manager-component-endpoints"></a>

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](allow-device-traffic.md).


| Endpoint |  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
<a name="stream-manager-component-dependencies"></a>

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](#stream-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass). Sur la page de détails du composant, recherchez la liste des **dépendances**.

------
#### [ 2.1.3 – 2.2.1 ]

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


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau de Greengrass](greengrass-nucleus-component.md) |  >=2,0.0 <3,0.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0,0 <2,13,0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,12.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,11.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0,0 <2,1,0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,9.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,8.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,7.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,6.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,5.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,4.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,3.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0.0 <2,2.0  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=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](greengrass-nucleus-component.md) |  >=2,0,3 <2,10  | Flexible | 
| [Service d'échange de jetons](token-exchange-service-component.md) |  >=0,0.0  | Stricte | 

------

Pour plus d'informations sur les dépendances des composants, consultez la [référence de la recette des composants](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuration
<a name="stream-manager-component-configuration"></a>

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`).  
<a name="stream-manager-store-root-dir-parameter-folder-requirements"></a>Vous devez spécifier un dossier existant, et l'[utilisateur du système qui exécute le composant du gestionnaire de flux](configure-greengrass-core-v2.md#configure-component-user) 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 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](manage-data-streams.md#stream-manager-security-client-authentication).  
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 limités.  
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.  
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 d'attente.  
Par défaut : `120`

**Example 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
<a name="stream-manager-component-log-file"></a>

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. Remplacez `/greengrass/v2` ou *C:\$1greengrass\$1v2* par 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
<a name="stream-manager-component-changelog"></a>

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


|  **Version**  |  **Modifications**  | 
| --- | --- | 
|  2.2.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.2.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html) | 
|  2.1.11  | Version mise à jour pour la version 2.12.0 de Greengrass Nucleus. | 
|  2.1.10  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.9  | Version mise à jour pour la version 2.11.0 de Greengrass Nucleus. | 
|  2.1.8  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.7  |  <a name="changelog-stream-manager-2.1.7"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.6  |  <a name="changelog-stream-manager-2.1.6"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.5  | Version mise à jour pour la version 2.10.0 de Greengrass Nucleus. | 
|  2.1.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  2.1.1  | Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  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 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/stream-manager-component.html)  | 
|  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.  |