Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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á. # Coleta de dados de telemetria de integridade do sistema de dispositivos principais AWS IoT Greengrass Os dados de telemetria da integridade do sistema são dados de diagnóstico que podem ajudá-lo a monitorar a performance de operações críticas em seus dispositivos de Greengrass nucleus. O agente de telemetria no núcleo do Greengrass coleta dados de telemetria locais e os publica na Amazon sem exigir nenhuma interação com o cliente. EventBridge Os dispositivos principais publicam dados de telemetria com EventBridge base no melhor esforço. Por exemplo, os dispositivos de núcleo podem falhar em fornecer dados de telemetria quando estão off-line. **nota** EventBridge A Amazon é um serviço de ônibus de eventos que você pode usar para conectar seus aplicativos a dados de várias fontes, como dispositivos principais do Greengrass e notificações de [implantação](deployment-notifications.md). Para obter mais informações, consulte [O que é a Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) no *Guia do EventBridge usuário da Amazon*. É possível criar projetos e aplicações para recuperar, analisar, transformar e relatar dados de telemetria de seus dispositivos de borda. Especialistas em domínio, como engenheiros de processo, podem usar essas aplicações para obter informações sobre a integridade da frota. Para garantir que os componentes do Greengrass edge funcionem adequadamente, AWS IoT Greengrass use os dados para fins de desenvolvimento e melhoria da qualidade. Esse recurso também ajuda a informar recursos de ponta novos e aprimorados. AWS IoT Greengrass só retém dados de telemetria por até sete dias. Esse recurso está disponível no software AWS IoT Greengrass Core v1.11.0 e é ativado por padrão para todos os núcleos do Greengrass, incluindo os núcleos existentes. Você começa a receber dados automaticamente assim que atualiza para o software AWS IoT Greengrass Core v1.11.0 ou posterior. Para obter informações sobre como acessar ou gerenciar dados de telemetria publicados, consulte [Fazendo a assinatura para receber dados de telemetria](#subscribe-for-telemetry-data). O atendente de telemetria coleta e publica as seguintes métricas do sistema. **Métricas de telemetria** | Name (Nome) | Description | Fonte | | --- | --- | --- | | `SystemMemUsage` | A quantidade de memória atualmente em uso por todos os aplicativos no dispositivo de núcleo do Greengrass, incluindo o sistema operacional. | Sistema | | `CpuUsage` | A quantidade de CPU atualmente em uso por todos os aplicativos no dispositivo de núcleo do Greengrass, incluindo o sistema operacional. | Sistema | | `TotalNumberOfFDs` | O número de descritores de arquivo armazenados pelo sistema operacional do dispositivo de núcleo do Greengrass. Um descritor de arquivo identifica exclusivamente um arquivo aberto. | Sistema | | `LambdaOutOfMemory` | O número de execuções que resultam na falta de memória da função do Lambda. | Sistema | | `DroppedMessageCount` | O número de mensagens descartadas que são destinadas a AWS IoT Core. | Componente do sistema do `GGCloudSpooler` | | `LambdaTimeout` | O número de tempos limite para execução da função do Lambda definida pelo usuário. | Função Nuvem AWS e sistema Lambda definidos pelo usuário | | `LambdaUngracefullyKilled` | O número de execuções que a função do Lambda definida pelo usuário não consegue concluir. | Função Nuvem AWS e sistema Lambda definidos pelo usuário | | `LambdaError` | O número de execuções que resultam na gravação de registros de erros da função do Lambda definida pelo usuário. | Função Nuvem AWS e sistema Lambda definidos pelo usuário | | `BytesAppended` | O número de bytes de dados anexados ao gerenciador de fluxo. | Componente do sistema do `GGStreamManager` | | `BytesUploadedToIoTAnalytics` | O número de bytes de dados que o gerenciador de fluxo exporta para os canais em AWS IoT Analytics. | Componente do sistema do `GGStreamManager` | | `BytesUploadedToKinesis` | O número de bytes de dados que o gerenciador de fluxos exporta para streams no Amazon Kinesis Data Streams. | Componente do sistema do `GGStreamManager` | | `BytesUploadedToIoTSiteWise` | O número de bytes de dados que o gerenciador de fluxo exporta para as propriedades do ativo AWS IoT SiteWise. | Componente do sistema do `GGStreamManager` | | `BytesUploadedToS3ExportTaskExecutor` | O número de bytes de dados que o gerenciador de fluxos exporta para objetos no Amazon S3. | Componente do sistema do `GGStreamManager` | | `BytesUploadedToHTTP` | O número de bytes de dados que o gerenciador de fluxos exporta para HTTP. | Componente do sistema do `GGStreamManager` | ## Definindo configurações de telemetria A telemetria do Greengrass usa as seguintes configurações: + O atendente de telemetria agrega dados de telemetria a cada hora. + O atendente de telemetria publica uma mensagem de telemetria a cada 24 horas. **nota** As configurações são imutáveis. Você pode habilitar ou desabilitar o atributo de telemetria para um dispositivo de núcleo do Greengrass. AWS IoT Greengrass usa [sombras](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) para gerenciar a configuração de telemetria. Suas alterações entram em vigor imediatamente quando o núcleo tem uma conexão com AWS IoT Core o. O atendente de telemetria publica dados usando o protocolo MQTT com um nível de qualidade de serviço (QoS) de 0. Isso significa que ele não confirma a entrega nem repete as tentativas de publicação. As mensagens de telemetria compartilham uma conexão MQTT com outras mensagens para assinatura destinadas a AWS IoT Core. Além dos custos do link de dados, a transferência de dados do núcleo para o AWS IoT Core é gratuita. Isso ocorre porque o agente publica em um tópico AWS reservado. No entanto, dependendo do seu caso de uso, você pode incorrer em custos ao receber ou processar os dados. ### Requisitos Os requisitos a seguir se aplicam quando você define as configurações de telemetria: + Você deve usar o software AWS IoT Greengrass Core v1.11.0 ou posterior. **nota** Se você estiver executando uma versão anterior e não desejar usar telemetria, você não precisará executar ações nesse momento. + Você deve fornecer permissões do IAM para atualizar a sombra principal (coisa) e chamar a configuração APIs antes de atualizar as configurações de telemetria. O exemplo de política do IAM a seguir permite gerenciar a configuração de sombra e de runtime de um núcleo específico: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowManageShadow", "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow", "iot:DescribeThing" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name-*" ] }, { "Sid": "AllowManageRuntimeConfig", "Effect": "Allow", "Action": [ "greengrass:GetCoreRuntimeConfiguration", "greengrass:UpdateCoreRuntimeConfiguration" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name" ] } ] } ``` ------ Você pode conceder acesso granular ou condicional aos recursos, por exemplo, usando um esquema de nomeação `*` curinga. Para obter mais informações, consulte [Adicionando e removendo políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) no *Guia do usuário do IAM*. ### Defina as configurações de telemetria (console) A seguir, mostramos como atualizar as configurações de telemetria de um núcleo do Greengrass no console. AWS IoT Greengrass 1. No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1). 1. Em **Grupos do Greengrass**, selecione seu grupo alvo. 1. Na página de configuração do núcleo, na seção **Visão geral**, selecione seu **Greengrass core**. 1. Na página de configuração do núcleo, selecione a guia **Telemetria**. 1. Na seção **Telemetria da integridade do sistema**, selecione **Configure**. 1. Em **Configurar telemetria**, selecione Telemetry para ativar ou desativar o status de telemetria. **Importante** Por padrão, o recurso de telemetria está habilitado para o software AWS IoT Greengrass Core v1.11.0 ou posterior. As alterações entram em vigor no runtime. Não é necessário implantar o grupo. ### Defina as configurações de telemetria (CLI) Na AWS IoT Greengrass API, o `TelemetryConfiguration` objeto representa as configurações de telemetria de um núcleo do Greengrass. Esse objeto faz parte do objeto `RuntimeConfiguration` associado ao núcleo. Você pode usar a AWS IoT Greengrass API ou o AWS SDK para gerenciar a telemetria do Greengrass. AWS CLI Os exemplos desta seção usam a AWS CLI. **Para verificar as configurações de telemetria** O comando a seguir obtém as configurações de telemetria de um núcleo do Greengrass. + *core-thing-name*Substitua pelo nome do núcleo de destino. Para obter o nome da coisa, você usa o [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. O comando retorna o ARN da coisa que contém o nome da coisa. ``` aws greengrass get-thing-runtime-configuration --thing-name core-thing-name ``` O comando retorna um objeto `GetCoreRuntimeConfigurationResponse` na resposta JSON. Por exemplo: ``` { "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } } ``` **Para definir as configurações de telemetria** O comando a seguir atualiza as configurações de telemetria para um núcleo do Greengrass. + *core-thing-name*Substitua pelo nome do núcleo de destino. Para obter o nome da coisa, você usa o [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. O comando retorna o ARN da coisa que contém o nome da coisa. ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration '{ "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "InSync", "Telemetry": "Off" } } } ``` ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration "{\"TelemetryConfiguration\":{\"ConfigurationSyncStatus\":\"InSync\",\"Telemetry\":\"Off\"}}" ``` As alterações nas configurações de telemetria serão aplicadas, se `ConfigurationSyncStatus` for `InSync`. As alterações entram em vigor no runtime. Não é necessário implantar o grupo. #### TelemetryConfiguration objeto O objeto `TelemetryConfiguration` tem as seguintes propriedades: `ConfigurationSyncStatus` Verifica se as configurações de telemetria estão sincronizadas. Talvez você não faça alterações nessa propriedade. Tipo: string Valores válidos: `InSync` ou `OutOfSync` `Telemetry` Ativa ou desativa a telemetria. O padrão é `On`. Tipo: string Valores válidos: `On` ou `Off` ## Fazendo a assinatura para receber dados de telemetria Você pode criar regras na Amazon EventBridge que definam como processar dados de telemetria publicados a partir do dispositivo principal do Greengrass. Quando EventBridge recebe os dados, ele invoca as ações-alvo definidas em suas regras. Por exemplo, crie regras de eventos que enviem notificações, armazenem informações, tomem medidas corretivas ou invoquem outros eventos. ### Evento de telemetria O evento para uma alteração no estado da implantação, incluindo os dados de telemetria, usa o seguinte formato: ``` { "version": "0", "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a", "detail-type": "Greengrass Telemetry Data", "source": "aws.greengrass", "account": "123456789012", "time": "2020-07-28T20:45:53Z", "region": "us-west-1", "resources": [], "detail": { "ThingName": "CoolThing", "Schema": "2020-06-30", "ADP": [ { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToKinesis", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToHTTP", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTAnalytics", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTSiteWise", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaTimeout", "Sum": 15, "U": "Count" } ] }, { "TS": 123231546, "NS": "CloudSpooler", "M": [ { "N": "DroppedMessageCount", "Sum": 15, "U": "Count" } ] }, { "TS": 1593727692, "NS": "SystemMetrics", "M": [ { "N": "SystemMemUsage", "Sum": 11.23, "U": "Megabytes" }, { "N": "CpuUsage", "Sum": 35.63, "U": "Percent" }, { "N": "TotalNumberOfFDs", "Sum": 416, "U": "Count" } ] }, { "TS": 1593727692, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaOutOfMemory", "Sum": 12, "U": "Count" }, { "N": "LambdaUngracefullyKilled", "Sum": 100, "U": "Count" }, { "N": "LambdaError", "Sum": 7, "U": "Count" } ] } ] } } ``` A matriz `ADP` contém uma lista de pontos de dados agregados que têm as seguintes propriedades: `TS` Obrigatório. O timestamp de quando os dados foram agregados. `NS` Obrigatório. O namespace do sistema. `M` Obrigatório. Lista de métricas. Uma métrica contém as seguintes propriedades: `N` O nome da [métrica](#telemetry-metrics). `Sum` O valor agregado da métrica. Oatendente de telemetria adiciona novos valores ao total anterior, então a soma é um valor cada vez maior. Você pode usar o timestamp para encontrar o valor de uma agregação específica. Por exemplo, para encontrar o valor agregado mais recente, subtraia o valor com timestamp anterior do valor com timestamp mais recente. `U` A unidade do valor da métrica. `ThingName` Obrigatório. O nome da coisa que você tem como alvo. ### Pré-requisitos para criar regras EventBridge Antes de criar uma EventBridge regra para AWS IoT Greengrass, você deve fazer o seguinte: + Familiarize-se com eventos, regras e metas em EventBridge. + Crie e configure os [alvos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) invocados por suas EventBridge regras. As regras podem invocar vários tipos de destinos, como streams, funções AWS Lambda , tópicos do Amazon SNS e filas do Amazon SQS. Sua EventBridge regra e os alvos associados devem estar no Região da AWS local em que você criou seus recursos do Greengrass. Para obter mais informações, consulte [Endpoints e cotas do serviço](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) na *Referência geral da AWS*. Para obter mais informações, consulte [O que é a Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) e [Introdução à Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) no *Guia do EventBridge usuário da Amazon*. ### Crie uma regra de evento para obter dados de telemetria (console) Use as etapas a seguir para usar o Console de gerenciamento da AWS para criar uma EventBridge regra que receba dados de telemetria publicados pelo núcleo do Greengrass. Isso permite que servidores web, endereços de e-mail e outros assinantes de tópicos respondam ao evento. Para obter mais informações, consulte [Criação de uma EventBridge regra que é acionada em um evento a partir de um AWS recurso no Guia](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) do * EventBridge usuário da Amazon*. 1. Abra o [ EventBridgeconsole da Amazon](https://console.aws.amazon.com/events/) e escolha **Criar regra**. 1. Em **Name and description (Nome e descrição)**, insira um nome e uma descrição para a regra. 1. Selecione **Barramento de eventos** e ative a regra no barramento de eventos selecionado. 1. Selecione o **Tipo de regra** e, em seguida selecione **Rule with an event pattern (Regra com um padrão de eventos)**. 1. Escolha **Próximo**. 1. Em **Origem do evento**, escolha **AWS eventos ou eventos de EventBridge parceiros**. 1. Em **Exemplo de evento**, selecione **AWS events ** e, em seguida selecione **Dados de telemetria do Greengrass**. 1. Para **Padrão de eventos**, faça as seguintes seleções: 1. Em **Event source** (Origem do evento), selecione **AWS services** (Serviços da ). 1. Em ** Serviço da AWS **, selecione **Greengrass**. 1. Em **Tipo de evento**, selecione **Dados de telemetria do Greengrass**. 1. Selecione **Next** (Próximo). 1. Em **Destino 1**, selecione** serviço da AWS **. 1. Em **Selecionar um destino**, selecione **Fila SQS**. 1. Em **Fila**, selecione seu perfil. ### Crie uma regra de evento para obter dados de telemetria (CLI) Use as etapas a seguir para usar o AWS CLI para criar uma EventBridge regra que receba dados de telemetria publicados pelo núcleo do Greengrass. Isso permite que servidores web, endereços de e-mail e outros assinantes de tópicos respondam ao evento. 1. Crie a regra. + *thing-name*Substitua pelo nome da coisa do núcleo. Para obter o nome da coisa, você usa o [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. O comando retorna o ARN da coisa que contém o nome da coisa. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` As propriedades que são omitidas do padrão são ignoradas. 1. Adicione o tópico como um destino de regra. O exemplo a seguir usa o Amazon SQS, mas você pode configurar outros tipos de destino. + *queue-arn*Substitua pelo ARN da sua fila do Amazon SQS. ``` aws events put-targets \ --rule TestRule \ --targets "Id"="1","Arn"="queue-arn" ``` **nota** Para permitir que EventBridge a Amazon invoque sua fila de destino, você deve adicionar uma política baseada em recursos ao seu tópico. Para obter mais informações, consulte as [permissões do Amazon SQS no Guia EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sqs-permissions) *do usuário da Amazon*. Para obter mais informações, consulte [Eventos e padrões de eventos EventBridge no](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Guia do EventBridge usuário da Amazon*. ## Solução de problemas de AWS IoT Greengrass telemetria Use as informações a seguir para ajudar a solucionar problemas com a configuração da telemetria. AWS IoT Greengrass ### Erro: A resposta contém "ConfigurationStatus“:" OutOfSync "depois de executar o get-thing-runtime-configuration comando **Soluções:** + O serviço AWS IoT Device Shadow leva tempo para processar as atualizações de configuração em tempo de execução e entregar as atualizações ao dispositivo principal do Greengrass. Você pode esperar e verificar se as configurações de telemetria estão sincronizadas posteriormente. + Verifique se dispositivo de núcleo está online. + Ative o [Amazon CloudWatch Logs in AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html#viewing-logs) para monitorar a sombra. + Use as [métricas AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/monitoring-cloudwatch.html) para monitorar sua coisa.