As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Adicione um destino em tempo real do AWS IoT SiteWise Edge O tipo de destino em tempo real permite que você transmita dados de IoT diretamente de seus dispositivos e gateways para o AWS IoT SiteWise armazenamento em tempo real. Essa opção é ideal para casos de uso que exigem ingestão e processamento imediatos de dados à medida que são gerados, sem a necessidade de lotes ou armazenamento em buffer. Você só pode ter um destino em tempo real configurado em cada gateway, pois ele transmite dados continuamente para AWS IoT SiteWise. **nota** A duplicação TQVs pode resultar em cobrança dupla. **Para adicionar um destino em tempo real** Use o AWS IoT SiteWise console ou AWS CLI adicione um destino em tempo real ao seu gateway SiteWise Edge habilitado para MQTT. ------ #### [ Console ] 1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação, escolha **Gateways de borda**. 1. Selecione o gateway ao qual você deseja adicionar um destino. 1. Na seção **Destinos**, escolha **Adicionar destino**. 1. Na página **Adicionar destino**, insira **os detalhes do destino**: 1. Um nome para seu destino no campo **Nome do destino**. 1. Selecione o **AWS IoT SiteWise tempo real** para o **tipo de destino**. 1. Configure a ordem de publicação do gateway definindo a **Ordem de publicação** como **Publicar primeiro os dados mais antigos** ou **Publicar os dados mais recentes primeiro**. Por padrão, o gateway publica primeiro os dados mais antigos. 1. Use o **Tempo máximo de espera do lote** para definir um tempo máximo de espera do editor antes de enviar um lote de dados AWS IoT SiteWise. Essa configuração se aplica a cada alias. Os dados são armazenados localmente até que: + O tempo definido já passou, ou + 10 entradas time-quality-value (TQV) são recebidas para o alias Qualquer condição atendida primeiro aciona o lote a ser enviado para a nuvem. 1. Para compactar dados carregados, marque a caixa de seleção **Ativar compactação ao carregar dados**. Deixar o gateway compactar seus dados antes de enviá-los para a nuvem reduz o uso da largura de banda. 1. Para filtrar dados expirados do editor, marque a caixa de seleção **Excluir dados expirados**. Essa seleção envia somente dados ativos e atuais para AWS IoT SiteWise. 1. No campo **Período limite**, insira a frequência com que os dados devem ser considerados expirados em seu conjunto de dados. Você pode determinar se os dados são contados em termos de minutos ou dias. O período mínimo de corte é de cinco minutos. O prazo máximo de corte é de sete dias. 1. Opcionalmente, defina as **configurações de armazenamento local**: 1. Defina a frequência do **período de retenção** — A quantidade de tempo em que o gateway armazena localmente dados anteriores ao período limite. O período mínimo de retenção é de um minuto. O período máximo de retenção é de 30 dias e maior ou igual ao período de rotação. 1. Definir o **período de rotação** — O intervalo de tempo a ser especificado ao salvar dados anteriores ao período limite de um único arquivo. O gateway transfere um lote de dados para o seguinte diretório local no final de cada período de alternância: `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. A retenção deve ser maior que um minuto e igual ao período de retenção. 1. Forneça o valor da **capacidade de armazenamento (GB)** para definir o tamanho máximo dos dados armazenados localmente em GB. Se os dados excederem o tamanho máximo de armazenamento local determinado, o gateway começará a excluir primeiro os dados mais antigos. O gateway continua sendo excluído até que o tamanho dos dados armazenados localmente seja igual ou menor que a cota. A capacidade de armazenamento deve ser maior ou igual a um GB. 1. Adicione filtros de caminho ao seu destino. Para obter mais informações, consulte, [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md). Para obter mais informações, consulte [Tipos de destino](gw-destinations.md#destination-types). ------ #### [ AWS CLI ] **Example : Crie um novo destino AWS IoT SiteWise em tempo real** Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor. Defina o parâmetro `capabilityNamespace` como `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": [ "#" ] } } ] } ] } ``` Para atualizar um destino existente AWS IoT SiteWise em tempo real, primeiro use a `DescribeGatewayCapabilityConfiguration` API para encontrar `destinationId` o. **Example : Atualize um destino AWS IoT SiteWise em tempo real** Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor. Defina o parâmetro `capabilityNamespace` como `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": [ "#" ] } } ] } ] } ``` As opções de configuração a seguir são específicas para gateways que usam o `iotsitewise:publisher:3` namespace. `sources` Define as fontes de dados para as quais transferir dados de seu equipamento industrial AWS IoT SiteWise. Para gateways habilitados para MQTT, use. `MQTT` Tipo: matriz de objetos Obrigatório: Sim `destinations` Define para onde enviar os dados. Os destinos são em tempo real ou armazenados em buffer usando o Amazon S3. É necessário pelo menos um objeto de destino, mas você pode adicionar uma matriz vazia. Você pode ter um destino em tempo real para cada gateway. Para obter mais informações, consulte [AWS IoT SiteWise Entenda os destinos Edge](gw-destinations.md#source-destination). Tipo: matriz de objetos Obrigatório: Sim `id` O identificador exclusivo do destino. Você pode fornecer uma ID de destino existente ou deixá-la em branco. Se você não especificar um ID, um UUID será gerado por padrão. Tipo: string Obrigatório: não `type` Tipo de destino. As opções incluem: `SITEWISE_REALTIME` `SITEWISE_BUFFERED` e. + `SITEWISE_REALTIME`— Envie dados diretamente para o AWS IoT SiteWise armazenamento em tempo real. + `SITEWISE_BUFFERED`— Envie dados para o Amazon S3 em lotes no formato Parquet e, em seguida, importe para o armazenamento. AWS IoT SiteWise Tipo: String Obrigatório: Sim `name` Um nome exclusivo para o destino. Tipo: String Obrigatório: Sim `config` Configuração específica para o tipo de destino no formato JSON. A configuração varia entre destinos em tempo real e em buffer. Tipo: objeto Obrigatório: Sim Ordem de publicação Determina a ordem na qual os dados são publicados. Os dados são publicados com base em seu registro de data e hora. As opções incluem `TIME_ORDER` `RECENT_DATA` e. + `TIME_ORDER`(padrão) — Publica primeiro os dados mais antigos. + `RECENT_DATA`— Publica primeiro os dados mais recentes. Tipo: string Obrigatório: não Ativar compactação Quando definido como`true`, ativa a compactação de dados antes de enviar para AWS IoT SiteWise. Deixar o gateway compactar seus dados antes de enviá-los para a nuvem reduz o uso da largura de banda. O valor padrão é `true`. Tipo: booliano Obrigatório: não Política de descarte Define como lidar com dados mais antigos. Tipo: objeto Obrigatório: não + `cutoffAge` A idade máxima dos dados a serem publicados é especificada em dias, horas e minutos. Por exemplo, `7d` ou `1d7h16m`. Dados mais antigos do que os especificados não são enviados para AWS IoT SiteWise. Os dados anteriores ao período limite não são publicados na nuvem. A idade limite deve ser entre cinco minutos e sete dias. Você pode usar `m`, `h` e `d` ao especificar uma idade limite. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. Tipo: String Obrigatório: Sim + `exportPolicy` Define como lidar com dados que excedem a idade limite. Tipo: objeto Obrigatório: não + `retentionPeriod` Seu gateway SiteWise Edge exclui todos os dados na borda anteriores ao período limite do armazenamento local após serem armazenados pelo período de retenção especificado. O período de retenção deve ser entre um minuto e 30 dias e maior ou igual ao período de alternância. Você pode usar `m`, `h` e `d` ao especificar um período de retenção. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. Tipo: string Obrigatório: não + `rotationPeriod` O intervalo de tempo para agrupar e salvar dados anteriores ao período limite em um único arquivo. O gateway SiteWise Edge transfere um lote de dados para o seguinte diretório local no final de cada período de rotação:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. O período de alternância deve ser maior que um minuto e menor ou igual ao período de retenção. Você pode usar `m`, `h` e `d` ao especificar um período de alternância. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. Tipo: string Obrigatório: não + `exportSizeLimitGB` O tamanho máximo permitido de dados armazenados localmente, em GB. Se essa cota for violada, o SiteWise Edge Gateway começará a excluir os dados mais antigos até que o tamanho dos dados armazenados localmente seja igual ou menor que a cota. O valor desse parâmetro deve ser maior ou igual a 1. Tipo: inteiro Obrigatório: não `maxBatchWaitTime` Define um tempo máximo para o editor esperar antes de enviar um lote de dados AWS IoT SiteWise. Essa configuração se aplica a cada alias. Os dados são armazenados localmente até que: + O tempo definido já passou, ou + 10 entradas time-quality-value (TQV) são recebidas para o alias Use `m``h`, e `d` para especificar um horário limite. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. Tipo: string Obrigatório: não `filters` Filtros a serem aplicados aos dados. É necessário pelo menos um filtro. Tipo: String Obrigatório: Sim `type` Tipo de filtro. Use `PATH`. Tipo: String Obrigatório: Sim `config` Configuração específica para o tipo de filtro no formato JSON. É necessário pelo menos um objeto, mas a matriz pode estar vazia. Tipo: objeto Obrigatório: Sim + `paths` Uma variedade de filtros de caminho. Para obter mais informações, consulte [Entenda os filtros de caminho para destinos AWS IoT SiteWise do EdgeUnderstand path filters](gw-destinations.md#destinations-path-filters). O caminho padrão é `#`. Tipo: matriz de strings Obrigatório: Sim ------