Configurar o componente AWS IoT SiteWise Publisher

Depois de criar um gateway AWS IoT SiteWise Edge e instalar o software, você pode configurar o componente Publisher para que seu gateway SiteWise Edge possa exportar dados para a AWS nuvem. Use o componente editor para ativar recursos adicionais ou definir as configurações padrão. Para obter mais informações, consulte AWS IoT SiteWise Publisher no Guia do AWS IoT Greengrass Version 2 desenvolvedor.

Console

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação, escolha Edge gateways.

3. Selecione o gateway SiteWise Edge para o qual você deseja configurar o editor.

4. Na seção Configuração do editor, escolha Editar

5. Em Ordem de publicação, escolha uma das seguintes opções:

   • Publique primeiro os dados mais antigos — Por padrão, o gateway SiteWise Edge publica primeiro os dados mais antigos na nuvem.

   • Publique primeiro os dados mais recentes — O gateway SiteWise Edge publica primeiro os dados mais recentes na nuvem.

6. (Opcional) Se você não quiser que o SiteWise Edge Gateway comprima seus dados, desmarque Ativar compactação ao fazer upload de dados.

7. (Opcional) Se você não quiser publicar dados antigos, escolha Excluir dados expirados e faça o seguinte:

   1. Em Período limite, insira um valor e escolha uma unidade. O período limite deve ser entre cinco minutos e sete dias. Por exemplo, se o período limite for de três dias, os dados com mais de três dias não serão publicados na nuvem.

8. (Opcional) Para definir configurações personalizadas sobre como os dados são tratados em seu dispositivo local, escolha Configurações de armazenamento local e faça o seguinte:

   1. Em Período de retenção, insira um número e escolha uma unidade. O período de retenção deve ser entre um minuto e 30 dias e maior ou igual ao período de alternância. Por exemplo, se o período de retenção for de 14 dias, o gateway SiteWise Edge excluirá todos os dados na borda que sejam mais antigos do que o período limite especificado após serem armazenados por 14 dias.

   2. Em Período de alternância, insira um número e escolha uma unidade. O período de rotação deve ser maior que um minuto e igual ou menor que o período de retenção. Por exemplo, digamos que o período de rotação seja de dois dias, o gateway SiteWise Edge agrupa e salva dados anteriores ao período limite em um único arquivo. Para gateways auto-hospedados por meio de AWS IoT Greengrass V2, o gateway SiteWise Edge transfere um lote de dados para o seguinte diretório local uma vez a cada dois dias:. /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports

   3. Em Capacidade de armazenamento, insira um valor maior ou igual a 1. Se a capacidade de armazenamento for de 2 GB, o gateway SiteWise Edge começará a excluir dados quando mais de 2 GB de dados forem armazenados localmente.

9. Escolha Salvar.

AWS CLI

Você pode usar o UpdateGatewayCapabilityConfigurationAPIpara configurar o editor. Defina o parâmetro capabilityNamespace como iotsitewise:publisher:2.

O editor fornece os seguintes parâmetros de configuração que você pode personalizar:

SiteWisePublisherConfiguration

publishingOrder

A ordem na qual os dados são publicados na nuvem. O valor desse parâmetro pode ser um dos seguintes:

• TIME_ORDER (Publicar primeiro os dados mais antigos) — Por padrão, o gateway publica primeiro os dados mais antigos na nuvem.

• RECENT_DATA (Publicar primeiro os dados mais recentes) — O gateway publica primeiro os dados mais recentes na nuvem.

dropPolicy

(Opcional) Uma política que controla quais dados são publicados na nuvem.

cutoffAge

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.

exportPolicy

(Opcional) Uma política que gerencia o armazenamento de dados na borda. Esta política se aplica a dados anteriores à idade limite.

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.

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.

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.

SiteWiseS3PublisherConfiguration

accessRoleArn

A função de acesso que dá AWS IoT SiteWise permissão para gerenciar o bucket do Amazon S3 no qual você está publicando.

streamToS3ConfigMapping

Uma matriz de configurações que mapeia um stream para uma configuração do Amazon S3.

streamName

O stream para ler e publicar na configuração do Amazon S3.

targetBucketArn

O bucket ARN no qual publicar.

publishPolicy

publishFrequency

A frequência com que o gateway SiteWise Edge publica no bucket do Amazon S3.

localSizeLimitGB

O tamanho máximo dos arquivos gravados no disco local. Se esse limite for violado, o editor publicará todos os dados armazenados em buffer em seu destino.

siteWiseImportPolicy

enableSiteWiseStorageImport

Defina isso true para importar dados de um bucket do Amazon S3 para AWS IoT SiteWise armazenamento.

enableDeleteAfterImport

Defina isso true para excluir o arquivo no bucket do Amazon S3 após a ingestão no armazenamento. AWS IoT SiteWise

exemplo configuração do editor:

O namespace do editor: iotsitewise:publisher:2

{
    "SiteWisePublisherConfiguration": {                               
        "publishingOrder": "TIME_ORDER",
        "dropPolicy": {
            "cutoffAge": "7d",
            "exportPolicy": {
                "retentionPeriod": "7d",
                "rotationPeriod": "6h",
                "exportSizeLimitGB": 10
            }
        }
    },
    "SiteWiseS3PublisherConfiguration": {
        "accessRoleArn": "arn:aws:iam:123456789012:role/roleName",
        "streamToS3ConfigMapping": [
            {
                "streamName": "S3_OPC-UA_Data_Collector",
                "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/dataCollector",
                "publishPolicy": {
                    "publishFrequency": "10m",
                    "localSizeLimitGB": 10
                },
                "siteWiseImportPolicy": {
                    "enableSiteWiseStorageImport": true,
                    "enableDeleteAfterImport": true
                }
            }
        ]
    }
}