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. # Ajouter une destination AWS IoT SiteWise Edge en temps réel Le type de destination en temps réel vous permet de diffuser des données IoT directement depuis vos appareils et vos passerelles vers le AWS IoT SiteWise stockage en temps réel. Cette option est idéale pour les cas d'utilisation qui nécessitent l'ingestion et le traitement immédiats des données dès leur génération, sans nécessiter de traitement par lots ou de mise en mémoire tampon. Vous ne pouvez configurer qu'une seule destination en temps réel dans chaque passerelle, car elle diffuse des données en continu vers AWS IoT SiteWise. **Note** La duplication TQVs peut entraîner une double charge. **Pour ajouter une destination en temps réel** Utilisez la AWS IoT SiteWise console ou AWS CLI pour ajouter une destination en temps réel à votre passerelle SiteWise Edge compatible MQTT. ------ #### [ Console ] 1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/). 1. Dans le volet de navigation, choisissez **Edge gateways**. 1. Sélectionnez la passerelle à laquelle vous souhaitez ajouter une destination. 1. Dans la section **Destinations**, choisissez **Ajouter une destination**. 1. Sur la page **Ajouter une destination**, entrez les **détails de la destination** : 1. Le nom de votre destination dans le champ **Nom de la destination**. 1. Sélectionnez le **AWS IoT SiteWise temps réel** pour le **type de destination**. 1. Configurez l'ordre de publication de la passerelle en définissant l'**ordre de publication** sur **Publier les anciennes données en premier** ou **Publier les données les plus récentes en premier**. Par défaut, la passerelle publie les données les plus anciennes en premier. 1. Utilisez le **délai d'attente maximal par lots** pour définir le temps d'attente maximal que l'éditeur doit attendre avant d'envoyer un lot de données à AWS IoT SiteWise. Ce paramètre s'applique à chaque alias. Les données sont stockées localement jusqu'à ce que : + Le temps défini est écoulé, ou + 10 entrées time-quality-value (TQV) sont reçues pour l'alias Quelle que soit la condition remplie, cela déclenche d'abord l'envoi du lot vers le cloud. 1. Pour compresser les données téléchargées, cochez la case **Activer la compression lors du téléchargement des données**. Le fait de laisser la passerelle compresser vos données avant de les télécharger dans le cloud réduit l'utilisation de la bande passante. 1. Pour filtrer les données d'éditeur expirées, cochez la case **Exclure les données expirées**. Cette sélection envoie uniquement les données actives et actuelles à AWS IoT SiteWise. 1. Dans le champ **Période limite**, entrez la fréquence à laquelle les données doivent être considérées comme expirées dans votre ensemble de données. Vous pouvez déterminer si les données sont comptées en minutes ou en jours. La période limite minimale est de cinq minutes. La période limite maximale est de sept jours. 1. Configurez éventuellement les **paramètres de stockage local** : 1. Définissez la fréquence de la **période de conservation** : durée pendant laquelle la passerelle stocke localement des données antérieures à la période limite. La durée de conservation minimale est d'une minute. La période de conservation maximale est de 30 jours et est supérieure ou égale à la période de rotation. 1. Définir la **période de rotation** : intervalle de temps à spécifier lors de l'enregistrement de données antérieures à la période limite pour un seul fichier. La passerelle transfère un lot de données vers le répertoire local suivant à la fin de chaque période de rotation :`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. La durée de conservation doit être supérieure à une minute et égale à la durée de conservation. 1. Indiquez la valeur **de capacité de stockage (Go)** pour définir la taille maximale des données stockées localement en Go. Si les données dépassent la taille maximale de stockage local déterminée, la passerelle commence par supprimer les données les plus anciennes. La passerelle continue à effectuer des suppressions jusqu'à ce que la taille des données stockées localement soit égale ou inférieure au quota. La capacité de stockage doit être supérieure ou égale à un Go. 1. Ajoutez des filtres de chemin à votre destination. Pour plus d'informations, voir,[Ajouter des filtres de chemin aux destinations AWS IoT SiteWise Edge](destinations-add-path-filters.md). Pour de plus amples informations, veuillez consulter [Types de destination](gw-destinations.md#destination-types). ------ #### [ AWS CLI ] **Example : créer une nouvelle destination AWS IoT SiteWise en temps réel** Utilisez l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API pour configurer l'éditeur. Définissez le paramètre `capabilityNamespace` sur `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Pour mettre à jour une destination AWS IoT SiteWise en temps réel existante, utilisez d'abord l'`DescribeGatewayCapabilityConfiguration`API pour trouver le`destinationId`. **Example : Mettre à jour une destination AWS IoT SiteWise en temps réel** Utilisez l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API pour configurer l'éditeur. Définissez le paramètre `capabilityNamespace` sur `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "your-existing-destination-id", "type": "SITEWISE_REALTIME", "name": "your-destination-name", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "7d", "exportPolicy": { "retentionPeriod": "7d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } }, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Les options de configuration suivantes sont spécifiques aux passerelles utilisant l'espace de `iotsitewise:publisher:3` noms. `sources` Définit les sources de données vers lesquelles transférer les données de votre équipement industriel AWS IoT SiteWise. Pour les passerelles compatibles MQTT, utilisez. `MQTT` Type : tableau d’objets Obligatoire : oui `destinations` Définit où envoyer les données. Les destinations sont soit en temps réel, soit mises en mémoire tampon à l'aide d'Amazon S3. Au moins un objet de destination est requis, mais vous pouvez ajouter un tableau vide. Vous pouvez avoir une destination en temps réel pour chaque passerelle. Pour de plus amples informations, veuillez consulter [Comprendre les destinations AWS IoT SiteWise Edge](gw-destinations.md#source-destination). Type : tableau d’objets Obligatoire : oui `id` Identifiant unique de la destination. Vous pouvez soit fournir un identifiant de destination existant, soit le laisser vide. Si vous ne spécifiez aucun identifiant, un UUID est généré par défaut. Type : chaîne Obligatoire : non `type` Type de destination. Les options incluent : `SITEWISE_REALTIME` et`SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`— Envoyez les données directement vers le AWS IoT SiteWise stockage en temps réel. + `SITEWISE_BUFFERED`— Envoyez des données à Amazon S3 par lots au format Parquet, puis importez-les dans le AWS IoT SiteWise stockage. Type : Chaîne Obligatoire : oui `name` Nom unique pour la destination. Type : Chaîne Obligatoire : oui `config` Configuration spécifique au type de destination au format JSON. La configuration varie entre les destinations en temps réel et les destinations mises en mémoire tampon. Type : objet Obligatoire : oui Ordre de publication Détermine l'ordre dans lequel les données sont publiées. Les données sont publiées en fonction de leur horodatage. Les options incluent `TIME_ORDER` et`RECENT_DATA`. + `TIME_ORDER`(par défaut) — Publie d'abord les anciennes données. + `RECENT_DATA`— Publie d'abord les données les plus récentes. Type : chaîne Obligatoire : non Activer la compression Lorsque ce paramètre est défini sur`true`, active la compression des données avant de les envoyer à AWS IoT SiteWise. Le fait de laisser la passerelle compresser vos données avant de les télécharger dans le cloud réduit l'utilisation de la bande passante. La valeur par défaut est `true`. Type : booléen Obligatoire : non Politique de dépôt Définit la manière de gérer les anciennes données. Type : objet Obligatoire : non + `cutoffAge` L'âge maximal des données à publier est indiqué en jours, heures et minutes. Par exemple, `7d` ou `1d7h16m`. Les données plus anciennes que celles que vous spécifiez ne sont pas envoyées à AWS IoT SiteWise. Les données antérieures à la période limite ne sont pas publiées dans le cloud. L'âge limite doit être compris entre cinq minutes et sept jours. Vous pouvez utiliser `m``h`, et `d` lorsque vous spécifiez un âge limite. Notez que cela `m` `h` représente les minutes, les heures et les `d` jours. Type : Chaîne Obligatoire : oui + `exportPolicy` Définit comment traiter les données qui dépassent l'âge limite. Type : objet Obligatoire : non + `retentionPeriod` Votre passerelle SiteWise Edge supprime toutes les données de la périphérie antérieures à la période limite du stockage local une fois qu'elles ont été stockées pendant la période de conservation spécifiée. La période de conservation doit être comprise entre une minute et 30 jours, et être supérieure ou égale à la période de rotation. Vous pouvez utiliser `m``h`, et `d` lorsque vous spécifiez une période de conservation. Notez que cela `m` `h` représente les minutes, les heures et les `d` jours. Type : chaîne Obligatoire : non + `rotationPeriod` Intervalle de temps pendant lequel les données antérieures à la période limite doivent être regroupées et enregistrées dans un seul fichier. La passerelle SiteWise Edge transfère un lot de données vers le répertoire local suivant à la fin de chaque période de rotation :`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. La période de rotation doit être supérieure à une minute et égale ou inférieure à la période de conservation. Vous pouvez utiliser `m``h`, et `d` lorsque vous spécifiez une période de rotation. Notez que cela `m` `h` représente les minutes, les heures et les `d` jours. Type : chaîne Obligatoire : non + `exportSizeLimitGB` Taille maximale autorisée des données stockées localement, en Go. Si ce quota est dépassé, la passerelle SiteWise Edge commence à supprimer les données les plus anciennes jusqu'à ce que la taille des données stockées localement soit égale ou inférieure au quota. La valeur de ce paramètre doit être supérieure ou égale à 1. Type : Integer Obligatoire : non `maxBatchWaitTime` Définit le délai maximal pendant lequel l'éditeur doit attendre avant d'envoyer un lot de données à AWS IoT SiteWise. Ce paramètre s'applique à chaque alias. Les données sont stockées localement jusqu'à ce que : + Le temps défini est écoulé, ou + 10 entrées time-quality-value (TQV) sont reçues pour l'alias Utilisez `m``h`, et `d` pour spécifier une heure limite. Notez que cela `m` `h` représente les minutes, les heures et les `d` jours. Type : chaîne Obligatoire : non `filters` Filtres à appliquer aux données. Au moins un filtre est requis. Type : Chaîne Obligatoire : oui `type` Type de filtre Utilisez `PATH`. Type : Chaîne Obligatoire : oui `config` Configuration spécifique au type de filtre au format JSON. Au moins un objet est requis, mais le tableau peut être vide. Type : objet Obligatoire : oui + `paths` Un ensemble de filtres de chemin. Pour de plus amples informations, veuillez consulter [Comprendre les filtres de chemin pour les destinations AWS IoT SiteWise EdgeComprendre les filtres de chemin](gw-destinations.md#destinations-path-filters). Le chemin par défaut est `#`. Type : tableau de chaînes Obligatoire : oui ------