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á. # Integre dados ao SiteWise Edge usando um gateway V3 habilitado para MQTT Este tutorial orienta você na integração de dispositivos e sensores de terceiros que usam o protocolo de mensagens MQTT com o gateway V3 AWS IoT SiteWise habilitado para MQTT. Você aprenderá a configurar um gateway de AWS IoT SiteWise borda para coletar e monitorar dados de seus dispositivos habilitados para MQTT. AWS IoT SiteWise permite coletar, processar e monitorar dados de equipamentos industriais. Use os recursos do SiteWise Edge para otimizar as operações industriais de IoT e transformar dados brutos em insights acionáveis. Neste tutorial, usamos dados de uma demonstração de parque eólico para ilustrar os principais conceitos. Depois de se familiarizar com o processo, você pode repetir o tutorial com seus próprios dados. Depois de concluir este tutorial, você pode fazer os seguintes itens: + Configure e configure um gateway V3 habilitado para MQTT para receber dados de dispositivos industriais + Processe e valide as mensagens MQTT recebidas do seu equipamento na borda + Visualize os dados do dispositivo AWS IoT SiteWise usando uma plataforma de visualização de terceiros + Envie dados processados do seu gateway de borda para o Nuvem AWS para permitir armazenamento centralizado e análises adicionais Além disso, você pode aproveitar seus recursos de gateway de borda conectando-se a outros AWS IoT serviços para realizar as seguintes tarefas: + Configure AWS IoT regras para rotear dados para serviços como [Amazon S3](https://aws.amazon.com/s3/), [Amazon Timestream e. [AWS Lambda](https://aws.amazon.com/lambda/)](https://aws.amazon.com/timestream/) + Use [AWS IoT Device Defender](https://aws.amazon.com/iot-device-defender/)para gerenciar e atualizar remotamente suas configurações de gateway. + Implemente autenticação e autorização seguras de dispositivos usando recursos AWS IoT de segurança. Para obter mais informações, consulte [AWS IoT segurança](https://docs.aws.amazon.com/iot/latest/developerguide/iot-security.html) no *Guia do AWS IoT desenvolvedor*. + Crie alertas e notificações automatizados com base nos dados do equipamento. Para obter mais informações, consulte [Regras para AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) no *Guia do AWS IoT desenvolvedor*. **nota** Este tutorial faz referência a serviços, ferramentas e documentação de terceiros. AWS não é fornecedor de nenhum produto ou serviço de terceiros e não pode garantir a precisão das informações de fornecedores externos. Avalie e valide todas as ferramentas de terceiros antes da implantação. **Topics** + [Pré-requisitos](#gateway-tutorial-prerequisites) + [Etapa 1: criar uma AWS IoT política](#gateway-tutorial-create-iot-policy) + [Etapa 2: criar e configurar qualquer AWS IoT coisa](#gateway-tutorial-create-and-configure-aws-iot-thing) + [Etapa 3: Configurar seu gateway V3 compatível com SiteWise Edge MQTT](#gateway-tutorial-configure-your-edge-gateway) + [Etapa 4: instalar o software SiteWise Edge Gateway](#install-gateway-software) + [Etapa 5: Configurar o agente EMQX para se conectar a aplicativos externos](#configure-emqx-broker-external-applications) + [Etapa 6: publicar dados com o Mosquitto](#add-mqtt-data-source) + [Etapa 7: especificar destinos](#specify-destinations) + [Etapa 8: especificar filtros de caminho](#specify-path-filters) + [Etapa 9: configurar seus recursos de AWS IoT](#configure-iot-resources) + [Etapa 10: visualize seus dados](#visualize-your-data) + [Etapa 11: limpar os recursos após o tutorial](#tutorial-clean-up-resources) + [Recursos adicionais do](#additional-resources) ## Pré-requisitos Para concluir este tutorial, você precisará do seguinte: + Um Conta da AWS. Se você não tiver uma, consulte [Configurar uma AWS conta](getting-started.md#set-up-aws-account). + Um usuário AWS Identity and Access Management (IAM) com permissões de administrador. Para obter mais informações, consulte [Gerenciamento de identidade e acesso para AWS IoT SiteWise](security-iam.md). + A versão mais recente do Python instalado em seu dispositivo. **Importante** Este tutorial requer o uso de recursos criados no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). Você deve concluí-lo antes de continuar com este tutorial. ## Etapa 1: criar uma AWS IoT política Este tutorial usa a AWS IoT política que você criou no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). Essa política define as regras de segurança para seus dispositivos e cria uma representação digital de seus dispositivos externos e sensores em AWS IoT. A política permite que seus dispositivos de terceiros enviem dados AWS IoT Core usando o MQTT (Message Queuing Telemetry Transport). Para ter mais informações sobre as mensagens MQTT, consulte [O que é MQTT?](https://aws.amazon.com/what-is/mqtt/). ------ #### [ Console ] Garanta a conclusão de uma AWS IoT política. Para obter instruções detalhadas, consulte [a Etapa 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). **Para verificar se você tem uma AWS IoT política ativa** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/). 1. No painel de navegação esquerdo, escolha **Valores Mobiliários** e, em seguida, **Políticas**. 1. Escolha a política que você criou. Por exemplo, .**SiteWiseTutorialDevicePolicy** 1. Confirme se o status da política está listado como Ativo. ------ #### [ AWS CLI ] Garanta a conclusão de uma AWS IoT política. Para obter instruções detalhadas, consulte [a Etapa 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). Use o seguinte comando AWS CLI [get-policy](https://docs.aws.amazon.com/cli/latest/reference/iot/get-policy.html) na *Referência de AWS CLI Comandos* para verificar se você tem uma política ativa AWS IoT : ``` aws iot get-policy --policy-name "SiteWiseTutorialDevicePolicy" ``` ------ Essa política permite que seus AWS IoT dispositivos estabeleçam conexões e se comuniquem com sombras de dispositivos usando mensagens MQTT. Para interagir com as sombras do dispositivo, suas AWS IoT coisas publicam e recebem mensagens MQTT sobre tópicos que começam com. `$aws/things/thing-name/shadow/` Essa política incorpora uma variável da política de coisas conhecida como `${iot:Connection.Thing.ThingName}`. Essa variável substitui o nome da coisa conectada em cada tópico. A instrução `iot:Connect` define limitações sobre quais dispositivos podem estabelecer conexões, garantindo que a variável da política de coisas só possa substituir nomes que começam com `SiteWiseTutorialDevice`. Para obter mais informações, consulte [Thing policy variables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-variables.html) in the *AWS IoT Developer Guide*. **nota** Essa política se aplica a coisas cujos nomes começam com `SiteWiseTutorialDevice`. Para usar um nome diferente para as coisas, é necessário atualizar a política de acordo. ## Etapa 2: criar e configurar qualquer AWS IoT coisa Nesta etapa, registre seu dispositivo de borda como uma AWS IoT coisa e gere os certificados e chaves necessários para uma comunicação segura com o AWS IoT SiteWise Edge. Esse processo estabelece a base para que seu dispositivo envie dados de terceiros por meio do gateway V3 habilitado para MQTT. ------ #### [ Console ] Garanta a conclusão das etapas de criação e configuração de qualquer AWS IoT coisa. Para obter instruções detalhadas, consulte [a Etapa 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). **Para verificar se você tem uma AWS IoT coisa ativa** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/). 1. No painel de navegação esquerdo, escolha **Todos os dispositivos** e depois **Coisas**. 1. Escolha o que você criou. Por exemplo, .**SiteWiseTutorialDevice1** 1. Em **Certificados**, confirme se o status está listado como ativo. ------ #### [ AWS CLI ] Garanta a conclusão das etapas de criação e configuração de qualquer AWS IoT coisa. Para obter instruções detalhadas, consulte [a Etapa 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). Use o AWS CLI comando a seguir para verificar se você tem uma AWS IoT política ativa: ``` aws iot describe-thing --thing-name "SiteWiseTutorialDevice1" ``` ------ Depois de concluir essas etapas, você pode conectar seu dispositivo com segurança ao AWS IoT SiteWise Edge. Você criou um diretório local para armazenar seus certificados e chaves que você gerou para a autenticação MQTT. Seu dispositivo está registrado como AWS IoT algo no [AWS IoT console](https://console.aws.amazon.com/iot/) e está preparado para integrar dados com o SiteWise Edge. Você pode conectar seu equipamento industrial ou outros dispositivos à AWS IoT plataforma e começar a ingerir dados no SiteWise Edge. ## Etapa 3: Configurar seu gateway V3 compatível com SiteWise Edge MQTT Nesta etapa, crie seu gateway V3 compatível com AWS IoT SiteWise Edge MQTT e configure-o para receber dados do agente EMQX. O gateway atua como uma ponte entre seus dispositivos AWS IoT e. Isso permite que você processe dados localmente na borda antes de enviá-los para Nuvem AWS o. Essa configuração reduz a largura de banda e diminui os atrasos no processamento na nuvem. ------ #### [ Console ] **Para criar seu gateway V3 AWS IoT SiteWise habilitado para MQTT** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/) e abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação esquerdo, escolha **Edge gateways** e, em seguida, escolha **Create** gateway. 1. Em **Destino de implantação**, escolha **Gateway auto-hospedado**. 1. *Em Opções de gateway auto-hospedado, escolha Gateway **V3 habilitado para MQTT - recomendado**.* 1. Na **configuração do Gateway**: 1. Em **Nome do gateway**, insira um nome para o gateway. Por exemplo, .**SiteWise Tutorial Device Gateway** 1. No **sistema operacional do dispositivo Greengrass**, selecione a opção apropriada para seu dispositivo. 1. Em **Configuração avançada**: 1. Escolha **Configuração padrão**. 1. Insira um nome para o dispositivo principal do Greengrass ou use o nome gerado por. AWS IoT SiteWise 1. Escolha **Criar gateway**. 1. Na caixa de diálogo de confirmação, escolha **Gerar e baixar** para gerar um instalador para seu gateway SiteWise Edge. Para obter mais informações, consulte [Criar um gateway SiteWise Edge auto-hospedado](create-gateway-ggv2.md#configure-gateway-console). **Atenção** Armazene o arquivo do instalador em um local seguro. Esse arquivo não pode ser regenerado e é necessário para concluir a configuração do gateway em etapas posteriores. ------ #### [ AWS CLI ] Use AWS CLI para criar um gateway auto-hospedado. Você precisa fornecer um nome para o gateway, especificar a plataforma e a versão do gateway. Para obter mais informações, consulte [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) na *Referência de APIs do AWS IoT SiteWise *. Para usar esse exemplo, substitua os espaços reservados para entrada do usuário por suas próprias informações. ``` aws iotsitewise create-gateway \ --gateway-name SiteWise Tutorial Device Gateway \ --gateway-platform greengrassV2={coreDeviceThingName=your-core-device-thing-name, coreDeviceOperatingSystem=LINUX_AMD64} \ --gateway-version 3 \ [--cli-input-json your-configuration] ``` + `gateway-name`— Um nome exclusivo para o gateway, por exemplo,`SiteWise Tutorial Device Gateway`. + `gateway-platform`— Entrar`greengrassV2`. Para obter mais informações, consulte [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) na *Referência de APIs do AWS IoT SiteWise *. + `coreDeviceThingName`— O nome da AWS IoT coisa para o seu dispositivo AWS IoT Greengrass V2 principal. Por exemplo, .`SiteWiseTutorialDevice1` + `coreDeviceOperatingSystem`— O sistema operacional do dispositivo principal em AWS IoT Greengrass V2. É necessário especificar o sistema operacional para a versão 3 do gateway. As opções incluem: `LINUX_AARCH64``LINUX_AMD64`, `WINDOWS_AMD64` e. + `gateway-version`— A versão do gateway. + Use `3` para a versão do gateway para criar um gateway V3 habilitado para MQTT. + `cli-input-json`— Um arquivo JSON contendo parâmetros de solicitação. Use o AWS CLI comando a seguir para verificar se o gateway foi criado com êxito: ``` aws iotsitewise describe-gateway --gateway-id your-gateway-id ``` ------ ## Etapa 4: instalar o software SiteWise Edge Gateway Para instalar o software do gateway, use o pacote do instalador que você baixou na etapa anterior. O processo de instalação configura os componentes necessários, inicia o serviço principal do Greengrass e registra seu dispositivo com. AWS IoT Greengrass Após a conclusão da instalação, verifique se o gateway aparece no [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/) sob os **gateways Edge** e se o serviço Greengrass está funcionando corretamente no seu dispositivo. Para obter instruções detalhadas, consulte [Instale o software AWS IoT SiteWise Edge Gateway em seu dispositivo local](install-gateway-software-on-local-device.md). ## Etapa 5: Configurar o agente EMQX para se conectar a aplicativos externos **nota** Você deve ter implantado seu gateway V3 compatível com SiteWise Edge MQTT antes de continuar. O gateway fornece a infraestrutura e as configurações de segurança necessárias para configurar o agente EMQX. A configuração do broker falhará sem uma implantação ativa do gateway. Configure o agente EMQX para permitir a comunicação segura entre seus dispositivos de IoT e aplicativos externos. O agente EMQX funciona como um hub central de mensagens que roteia dados entre seus dispositivos de IoT, gateway e aplicativos. O agente EMQX garante a entrega confiável de mensagens em seu gateway e em aplicativos conectados na borda. Para obter mais informações, consulte [Conecte aplicativos externos ao corretor EMQX](connect-external-applications-emqx.md). **Para configurar o corretor EMQX** 1. Configure o corretor EMQX. Para obter instruções detalhadas de configuração, siga as etapas de 1 a 14 em [Atualizar a configuração de implantação do EMQX](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) para autenticação. 1. Configure tópicos do MQTT para monitoramento de parques eólicos. Para obter mais informações sobre os requisitos do MQTT, consulte[Requisitos de tópicos do MQTT](connect-broker-payload-format.md#connect-broker-mqtt-requirements). 1. Uso da CPU: `SiteWiseTutorialDevice/cpu` 1. Uso de memória: `SiteWiseTutorialDevice/memory` 1. Carimbo de data/hora: `SiteWiseTutorialDevice/timestamp` 1. Revise sua configuração e conclua a implantação. 1. Escolha **Confirmar** para salvar suas configurações. 1. Escolha **Avançar** até chegar à etapa de **revisão**. 1. Na página **Pré-visualizar**, escolha **Implantar**. 1. Aguarde até que a implantação seja concluída com êxito antes de continuar. 1. Prepare mensagens usando o formato de carga útil para enviar ao agente EMQX. Para obter mais informações sobre estruturação de cargas, consulte [Atualizar a configuração de implantação do EMQX](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) para autenticação. 1. Implemente as seguintes medidas de segurança: 1. Use a criptografia Transport Layer Security (TLS) (porta 8833) para proteger os dados em trânsito. Para obter mais informações, consulte [Configure o TLS para conexões seguras com o agente EMQX no Edge AWS IoT SiteWise](connect-app-to-broker.md#configure-tls-emqx-broker). 1. Configure a autenticação de nome de usuário e senha para verificar as identidades do dispositivo. Essa medida de segurança ajuda a proteger seus dados e garante que somente dispositivos autorizados possam se conectar ao seu sistema. Para obter mais informações, consulte [Ativar autenticação de nome de usuário e senha](configure-emqx-broker.md#emqx-broker-username-password-auth). O EMQX permite criar regras de autorização com base em identificadores como nome de usuário, endereço IP ou ID do cliente. Isso é útil para controlar o acesso aos seus dados. Para obter mais informações, consulte [Configurar regras de autorização para o AWS IoT SiteWise Edge no EMQX](authorization-rules-emqx-broker.md). Após a implantação bem-sucedida, seu agente EMQX está configurado e pronto para se conectar com segurança a aplicativos externos. **nota** O formato da carga útil deve seguir uma estrutura específica para que o AWS IoT SiteWise Edge processe e consuma adequadamente seus dados. Para obter mais informações sobre a estrutura necessária, consulte[Estrutura de carga útil JSON](connect-broker-payload-format.md#connect-broker-json-payload). **Exemplo: adicionar cargas JSON de CPU, memória e carimbo de data/hora** **Carga útil da CPU JSON** ``` { "propertyAlias": "SiteWiseTutorialDevice/cpu", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 45.2 } } ] } ``` **Carga útil de memória JSON** ``` { "propertyAlias": "SiteWiseTutorialDevice/memory", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 67.8 } } ] } ``` **Carga útil JSON com carimbo de data/hora** ``` { "propertyAlias": "SiteWiseTutorialDevice/timestamp", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1753206441 }, "value": { "integerValue": 23.5 } } ] } ``` **nota** Cada payload JSON deve ser publicado separadamente como uma mensagem individual. Não combine vários valores de propriedade em uma única mensagem. Envie cada carga útil de CPU, memória e timestamp como sua própria publicação MQTT distinta. A carga define a estrutura JSON necessária que seus dispositivos de IoT devem usar para enviar dados do dispositivo por meio do agente EMQX para o Edge. SiteWise Esse formato garante que AWS IoT SiteWise você possa identificar seus dispositivos e processar as leituras do sensor. Depois de implementar essas configurações e estruturas de carga útil, seu sistema de monitoramento de parques eólicos está pronto para coletar e processar dados. ## Etapa 6: publicar dados com o Mosquitto Depois de criar seu gateway V3 habilitado para MQTT, configure o Eclipse Mosquitto para enviar dados de teste para o Edge. SiteWise O Mosquitto é um agente de mensagens MQTT de código aberto que usa o protocolo MQTT para mensagens leves entre dispositivos. O cliente Mosquitto permite que você publique mensagens em tópicos do MQTT, simulando dados de sensores de parques eólicos. Usando o Mosquitto, simule os dados do dispositivo sem precisar de serviços de terceiros ou equipamentos adicionais. Para obter mais informações, consulte a [documentação](https://mosquitto.org) no site oficial do Eclipse Mosquitto. Neste tutorial, dados locais do tutorial de [ingestão de dados e dados](ingest-data-from-iot-things.md) fictícios estão sendo usados para fins de demonstração. **Use o cliente Mosquitto CLI para testar o corretor Edge EMQX SiteWise ** 1. Instale o Mosquitto em seu dispositivo local. Para obter instruções detalhadas, consulte [Download Mosquitto](https://mosquitto.org/download/) no site oficial do Eclipse Mosquitto. 1. Para obter mais informações sobre como conectar aplicativos externos para transferir dados industriais, consulte[Conecte aplicativos externos ao corretor EMQX](connect-external-applications-emqx.md). **Importante** Certifique-se de que as configurações de conexão MQTT definidas aqui correspondam às configurações usadas no comando de publicação do Mosquitto. O host deve ser o endereço IP ou o nome do host do seu gateway SiteWise Edge. A porta normalmente é 1883 (ou 8883 se estiver usando SSL/TLS). Use o Mosquitto para publicar dados de teste. Abra uma linha de comando e execute os seguintes comandos: **Exemplo: propriedade da CPU** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/cpu" -m '{ "propertyAlias": "SiteWiseTutorialDevice/cpu", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 45.2 } } ] }' ``` **Exemplo: propriedade de memória** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/memory" -m '{ "propertyAlias": "SiteWiseTutorialDevice/memory", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 72.1 } } ] }' ``` **Exemplo: propriedade Timestamp** ``` mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/timestamp" -m '{ "propertyAlias": "SiteWiseTutorialDevice/timestamp", "propertyValues": [ { "quality": "GOOD", "timestamp": { "timeInSeconds": 1753206441, "offsetInNanos": 0 }, "value": { "integerValue": 1683000000 } } ] }' ``` **nota** O uso do `localhost` endereço do corretor EMQX é apenas para fins de demonstração. Em ambientes de produção ou ao se conectar a partir de dispositivos externos, você deve usar o endereço de agente EMQX apropriado para sua configuração de implantação específica. Para obter instruções detalhadas de conexão, consulte[Conecte um aplicativo ao corretor EMQX no Edge AWS IoT SiteWise](connect-app-to-broker.md). ## Etapa 7: especificar destinos Nesta etapa, especifique destinos para determinar para onde direcionar seus dados de origem. Use AWS IoT SiteWise com o buffer do Amazon S3 como seu destino. Essa opção fornece uma maneira escalável de armazenar e processar seus dados de IoT. ------ #### [ Console ] **Para adicionar destinos** 1. Navegue até o [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/) e selecione **Edge gateways**. 1. Em **SiteWise Tutorial Device Gateway**, escolha **Adicionar destinos**. 1. Em **Detalhes do destino**, escolha **AWS IoT SiteWise Armazenado em buffer usando o Amazon S3**. Para saber mais sobre os tipos de destino, consulte [destinos de AWS IoT SiteWise gateway](gw-destinations.md#source-destination). 1. Em **Nome do destino**, insira um nome para seu destino, por exemplo,`SiteWise Tutorial S3 Destination`. 1. Em **Configurações de upload do S3**, insira a localização do bucket do S3. Por exemplo, .`s3://sitewise-tutorial-mqtt-data-[your-account-id]` Para saber mais sobre o Amazon S3, consulte [Criação, configuração e trabalho com buckets do Amazon S3 no Guia do usuário do *Amazon*](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) Simple Storage Service. 1. Em **Frequência de upload de dados**, insira um valor entre 1 minuto e 30 dias. Por exemplo, .`1 minute` 1. Em **Configurações de armazenamento de dados**: 1. Desmarque **Copiar dados para armazenamento**. Embora essa configuração seja recomendada para ambientes de produção, você não precisa dela para este tutorial. Quando você desmarca essa opção, a opção **Excluir dados do S3** é automaticamente desmarcada. 1. Escolha **Adicionar destino**. **nota** Este tutorial usa um intervalo de 1 minuto para testes. Depois de concluir o tutorial, você pode ajustar esse intervalo para atender às suas necessidades de produção ou excluí-lo para evitar cobranças adicionais. ------ #### [ AWS CLI ] **Exemplo: Crie um novo AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3** Use o [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)na *Referência de AWS CLI Comandos* para configurar o editor. Defina o parâmetro `capabilityNamespace` como `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_BUFFERED", "name": "your-s3-destination-name", "config": { "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder", "publishPolicy": { "publishFrequency": "1m", "localSizeLimitGB": 10 }, "siteWiseImportPolicy": { "enableSiteWiseStorageImport": true, "enableDeleteAfterImport": true, "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name" } }, "filters": [ { "type": "PATH", "config": { "paths": [ "#" ] } } ] } ] } ``` Para obter mais informações sobre destinos, consulte[Adicione um destino em AWS IoT SiteWise buffer usando o Amazon S3](destinations-buffered.md). ------ ## Etapa 8: especificar filtros de caminho Nesta etapa, configure filtros de caminho para especificar quais tópicos do MQTT devem ser monitorados para os dados do dispositivo do seu parque eólico. Os filtros de caminho seguem a especificação curinga do tópico MQTT, que suporta dois caracteres especiais: + `+`— Esse símbolo representa um curinga de nível único, que corresponde a qualquer string em um único nível. + `#`— Esse símbolo representa um curinga de vários níveis, que corresponde a qualquer número de níveis na hierarquia de tópicos. **nota** Para obter mais informações sobre outros filtros de caminho, consulte[Caracteres especiais nos nomes dos filtros de caminho](gw-destinations.md#path-filters-special-characters). ------ #### [ Console ] **Para configurar seus filtros de caminho** Em **Filtros de caminho**: 1. Navegue até o [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/) e selecione **Edge gateways**. 1. Em **SiteWise Tutorial Device Gateway**, escolha **Adicionar destinos**. 1. Escolha **Adicionar filtros de caminho** para inserir manualmente os seguintes filtros de caminho: + `SiteWiseTutorialDevice/#` + `windfarm/+/turbine/+/performance/#` + `cpu/+/idle-time` + `cpu/+/interruption-count/+` + `+/memory/consumption` + `timestamp/+/measurement` + `device/+/status/+` + `system/+/performance-log` 1. Escolha **Adicionar destino**. Para obter mais informações sobre as melhores práticas para filtros de caminho, consulte[Práticas recomendadas para filtros de caminho](gw-destinations.md#create-effective-path-filters). ------ #### [ AWS CLI ] Use os AWS CLI comandos a seguir para configurar seus filtros de caminho: **Exemplo 1: dados do dispositivo usando curinga** ``` { "destinations": [ { "name": "All Device Data Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "SiteWiseTutorialDevice/#", "windfarm/+/turbine/+/performance/#" ] } } ] } ``` Essa configuração de filtro de caminho usa curingas de vários níveis (\$1) para capturar todos os dados SiteWiseTutorialDevice e todos os dados de desempenho de qualquer turbina no parque eólico. **Exemplo 2: desempenho da CPU e da memória** ``` { "destinations": [ { "name": "Performance Metrics Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "cpu/+/idle-time", "+/memory/consumption", "cpu/+/interruption-count/+" ] } } ] } ``` Este exemplo captura várias métricas de CPU (tempo ocioso e contagem de interrupções) e dados de consumo de memória em todos os dispositivos. **Exemplo 3: Diagnóstico do dispositivo** ``` { "destinations": [ { "name": "Device Diagnostics Destination" } ], "filters": [ { "type": "PATH", "config": { "paths": [ "device/+/status/+", "system/+/performance-log" ] } } ] } ``` Essa configuração usa o `+` caractere curinga para capturar dados de diagnóstico de vários dispositivos, especificamente registros de desempenho do sistema e atualizações de status do dispositivo. Esses três filtros de caminho correspondem aos tópicos do MQTT que você usa para publicar dados de teste com o Mosquitto. Os filtros garantem que seu gateway SiteWise Edge capture e processe as mensagens MQTT relevantes. Para obter mais informações sobre como adicionar filtros de caminho, consulte[Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md). ------ ## Etapa 9: configurar seus recursos de AWS IoT Nesta etapa, crie os modelos e ativos de AWS IoT SiteWise ativos necessários para representar seus dispositivos simulados de terceiros e permitir a ingestão de dados por meio de seu gateway de borda. Antes de iniciar essa etapa, você deve ter concluído as etapas 3 a 8 no tutorial [de ingestão de dados](ingest-data-from-iot-things.md). Essas etapas estabelecem os componentes fundamentais para integrar seus dados de terceiros por meio do gateway V3 habilitado para MQTT. Você também configura regras que definem como os dados do sensor fluem AWS IoT SiteWise e executa um script de cliente de dispositivo que simula dados de parques eólicos industriais. **Para validar sua configuração de recursos AWS de IoT** 1. Use o AWS CLI comando a seguir para verificar se você criou e configurou corretamente seu Modelo de Dispositivo SiteWise Tutorial e Modelo de Frota de Dispositivos SiteWise Tutoriais: ``` aws iotsitewise describe-asset-model --asset-model-id your-device-model-id ``` Use o AWS CLI comando a seguir para recuperar o ID dos seus modelos de ativos: ``` aws iotsitewise list-asset-models ``` 1. Use o AWS CLI comando a seguir para verificar se você criou e configurou corretamente o ativo SiteWise Tutorial Device 1 e o ativo SiteWise Tutorial Device Fleet 1: ``` aws iotsitewise describe-asset --asset-id your-asset-id ``` Use o AWS CLI comando a seguir para recuperar o ID dos seus ativos: ``` aws iotsitewise list-assets ``` ## Etapa 10: visualize seus dados Configure a versão de código aberto do Grafana para visualizar os dados do dispositivo do seu parque eólico. Grafana é uma plataforma de visualização que exibe seus dados operacionais em tempo real. Esses painéis ajudam você a monitorar a eficiência operacional e identificar as necessidades de manutenção em toda a sua infraestrutura. Para obter mais informações sobre integração, consulte[Integre AWS IoT SiteWise com a Grafana](grafana-integration.md). **Para configurar o Grafana** 1. Para obter instruções sobre como baixar e instalar a versão mais recente do Grafana, consulte Instalar o [Grafana no site oficial do Grafana](https://grafana.com/docs/grafana/latest/setup-grafana/installation/#install-grafana). 1. Para obter instruções detalhadas de configuração específicas para seu sistema operacional, consulte [Configurar o Grafana no site oficial](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configure-grafana) do Grafana. 1. Configure a fonte de AWS IoT SiteWise dados. Isso permite que você configure o AWS IoT SiteWise plug-in no seu servidor Grafana. Para obter instruções detalhadas sobre como usar o plug-in, consulte [Conecte-se a uma fonte de AWS IoT SiteWise dados no Guia](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) do *usuário do Amazon Managed Grafana*. **Importante** Certifique-se de ter a versão mais recente do Grafana para compatibilidade com a fonte de AWS IoT SiteWise dados. Depois de concluir essas etapas, você pode criar e personalizar os painéis da Grafana para exibir as métricas operacionais do seu parque eólico. Isso permite que você acompanhe e analise o desempenho do seu parque eólico na borda em tempo real. **nota** Embora este tutorial use a versão de código aberto do Grafana AWS , também oferece o Amazon Managed Grafana para ambientes de produção. O Amazon Managed Grafana é um serviço totalmente gerenciado que elimina a necessidade de instalar, configurar e manter seus próprios servidores Grafana. Considere fazer o upgrade para o Amazon Managed Grafana quando estiver pronto para escalar sua solução. Para obter instruções detalhadas sobre como conectar seus SiteWise dados ao Grafana, consulte o tutorial [Visualizar e compartilhar dados no Grafana](visualize-with-grafana.md). Você concluiu o tutorial. Neste procedimento, você configurou o AWS IoT SiteWise Edge para integrar dados de dispositivos de terceiros usando um gateway V3 habilitado para MQTT. Essa configuração permite coletar, processar e visualizar dados de equipamentos industriais na borda, reduzindo a latência e os custos operacionais. Ao usar a demonstração do parque eólico, você coletou e processou métricas operacionais, como dados de uso de CPU e memória, por meio de seu gateway V3 habilitado para MQTT. Para aprimorar sua solução de IoT, considere explorar recursos avançados, como detecção de anomalias, aproveitando-os ou integrando-os a outros serviços[Detectar anomalias com o Lookout for Equipment](anomaly-detection.md), AWS como o Amazon Quick, [no Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) *User* Guide para análises avançadas. ## Etapa 11: limpar os recursos após o tutorial Depois de concluir este tutorial sobre a integração de dados no AWS IoT SiteWise Edge, limpe seus recursos para evitar cobranças adicionais. **Para excluir ativos hierárquicos no AWS IoT SiteWise** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação à esquerda, escolha **Ativos**. 1. Ao excluir ativos em AWS IoT SiteWise, você deve primeiro desassociá-los. Conclua as seguintes etapas para desassociar os ativos do dispositivo do ativo da frota de dispositivos: 1. Escolha o ativo da frota do seu dispositivo (**SiteWise Tutorial Device Fleet 1**). 1. Escolha **Editar**. 1. Em **Assets associated to this asset (Ativos associados a este ativo)**, selecione **Disassociate (Desassociar)** para cada ativo de dispositivo associado a esse ativo da frota de dispositivos. 1. Escolha **Salvar**. **nota** Os ativos do dispositivo não estão mais organizados como uma hierarquia agora. 1. Escolha o ativo do dispositivo (**SiteWise Tutorial Device 1**). 1. Escolha **Excluir**. 1. Na caixa de diálogo de confirmação**Delete**, insira e escolha **Excluir**. 1. Repita as etapas de 4 a 6 para cada ativo de dispositivo e para o ativo da frota de dispositivos (**SiteWise Tutorial Device Fleet 1**). **Para excluir modelos hierárquicos de ativos no AWS IoT SiteWise** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Exclua seu dispositivo e os ativos da frota de dispositivos. 1. No painel de navegação à esquerda, selecione **Modelos**. 1. Escolha o seu modelo de ativos da frota de dispositivos (**SiteWise Tutorial Device Fleet Model**). Não é possível excluir um modelo se você tem ativos que foram criados usando esse modelo. Ao excluir modelos de ativo hierárquicos, comece excluindo o modelo de ativo pai. 1. Escolha **Excluir**. 1. Na caixa de diálogo de confirmação**Delete**, insira e escolha **Excluir**. 1. Repita as etapas de 4 a 6 para o modelo de ativo do dispositivo (**SiteWise Tutorial Device Model**). **Para desativar ou excluir uma regra no AWS IoT Core** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/). 1. **No painel de navegação esquerdo, escolha **Roteamento de mensagens e, em** seguida, escolha Regras.** 1. Selecione sua regra e escolha **Excluir**. 1. Na caixa de diálogo de confirmação, insira o nome da regra e selecione **Delete**. **Para excluir um bucket do Amazon S3** 1. Acesse o [console do Amazon S3](https://console.aws.amazon.com/s3/). 1. No painel de navegação esquerdo, escolha **Compartimento de uso geral**. 1. Na lista de compartimentos, selecione o botão de opção ao lado do compartimento que você criou e escolha **Esvaziar** na parte superior da página. 1. Na caixa de diálogo de confirmação, confirme a exclusão e escolha **Esvaziar**. 1. Depois que o bucket estiver vazio, escolha **Excluir** para excluir o bucket. 1. Na caixa de diálogo de confirmação, insira o nome do seu bucket para confirmar a exclusão. 1. Escolha **Excluir bucket**. **Para excluir um gateway SiteWise Edge** 1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. No painel de navegação esquerdo, escolha **Edge gateways**. 1. Em Gateways, escolha o gateway que você criou para este tutorial. Por exemplo, .`SiteWise Tutorial Device Gateway` 1. Escolha **Excluir**. 1. Para confirmar que você deseja excluir o gateway, digite **Delete** na caixa de diálogo de confirmação e escolha **Excluir** na janela que aparece. **Para excluir sua coisa de IoT** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot/). 1. No painel de navegação esquerdo, escolha **Gerenciar** e, em seguida, escolha **Coisas**. 1. Selecione a coisa de IoT que você criou para este tutorial. Por exemplo, .`SiteWiseTutorialDevice1` 1. Escolha **Excluir**. 1. Na caixa de diálogo de confirmação, insira o nome da coisa e escolha **Excluir**. **Para desinstalar o AWS IoT Greengrass Core** Desinstale o software AWS IoT Greengrass Core do seu dispositivo local. Para obter instruções detalhadas, consulte [Desinstalar o software AWS IoT Greengrass principal](https://docs.aws.amazon.com/greengrass/v2/developerguide/uninstall-greengrass-core-v2.html) no *Guia do AWS IoT Greengrass desenvolvedor, versão 2*. **Importante** A desinstalação do Greengrass remove todas as configurações e dados locais. Certifique-se de ter feito backup de todas as informações importantes antes de continuar. **(Opcional) Para excluir recursos de terceiros** Depois de concluir este tutorial, considere desligar todos os recursos externos que você criou. Isso ajuda a evitar cobranças de fornecedores terceirizados. ## Recursos adicionais do Consulte os seguintes recursos para obter mais informações: + [Interaja com outros AWS serviços](interact-with-other-services.md) + [Use gateways AWS IoT SiteWise Edge](gateways.md) + [Solução de problemas de um gateway SiteWise Edge](troubleshooting-gateway.md) + [Melhores práticas de segurança para AWS IoT SiteWise](security-best-practices.md) + [AWS Preços de IoT](https://aws.amazon.com/iot-sitewise/pricing/) + [Ingerir dados para AWS IoT SiteWise](industrial-data-ingestion.md) + [Use tags em AWS IoT SiteWise](tag-basics.md)