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á. # CloudWatch Conector de métricas O [conector CloudWatch ](connectors.md) Metrics publica métricas personalizadas dos dispositivos Greengrass na Amazon. CloudWatch O conector fornece uma infraestrutura centralizada para publicação de CloudWatch métricas, que você pode usar para monitorar e analisar o ambiente principal do Greengrass e atuar em eventos locais. Para obter mais informações, consulte [Usando CloudWatch métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) no *Guia CloudWatch do usuário da Amazon*. Esse conector recebe dados de métrica como mensagens MQTT. O conector agrupa métricas que estão no mesmo namespace e as publica em intervalos regulares. CloudWatch Esse conector tem as seguintes versões. | Versão | ARN | | --- | --- | | 5 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/5` | | 4 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/4` | | 3 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/3` | | 2 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/2` | | 1 | `arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/1` | Para obter informações sobre alterações de versão, consulte o [Changelog](#cloudwatch-metrics-connector-changelog). ## Requisitos Esse conector tem os seguintes requisitos: ------ #### [ Version 3 - 5 ] + AWS IoT Greengrass Software principal v1.9.3 ou posterior. + [Python](https://www.python.org/), versão 3.7 ou 3.8, instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH. **nota** Para usar o Python 3.8, execute o comando a seguir para criar um symblink da pasta de instalação padrão do Python 3.7 para os binários instalados do Python 3.8. ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` Isso configura seu dispositivo para atender ao requisito Python para AWS IoT Greengrass. + A [função de grupo do Greengrass](group-role.md) configurada para permitir a ação `cloudwatch:PutMetricData`, conforme mostrado no seguinte exemplo de política do AWS Identity and Access Management (IAM). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Para o requisito de função de grupo, você deve configurar a função para conceder as permissões necessárias e certificar-se de que a função tenha sido adicionada ao grupo. Para acessar mais informações, consulte [Gerenciar a função de grupo do Greengrass (console)](group-role.md#manage-group-role-console) ou [Gerenciar a função de grupo do Greengrass (CLI)](group-role.md#manage-group-role-cli). Para obter mais informações sobre CloudWatch permissões, consulte a [referência de CloudWatch permissões da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) no *Guia do usuário do IAM*. ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Software principal v1.7 ou posterior. + [Python](https://www.python.org/) versão 2.7 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH. + A [função de grupo do Greengrass](group-role.md) configurada para permitir a ação `cloudwatch:PutMetricData`, conforme mostrado no seguinte exemplo de política do AWS Identity and Access Management (IAM). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Stmt1528133056761", "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Para o requisito de função de grupo, você deve configurar a função para conceder as permissões necessárias e certificar-se de que a função tenha sido adicionada ao grupo. Para acessar mais informações, consulte [Gerenciar a função de grupo do Greengrass (console)](group-role.md#manage-group-role-console) ou [Gerenciar a função de grupo do Greengrass (CLI)](group-role.md#manage-group-role-cli). Para obter mais informações sobre CloudWatch permissões, consulte a [referência de CloudWatch permissões da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) no *Guia do usuário do IAM*. ------ ## Parâmetros do conector Esse conector oferece os seguintes parâmetros: ------ #### [ Versions 4 - 5 ] `PublishInterval` O número máximo de segundos de espera antes de publicar métricas em lote para um determinado namespace. O valor máximo é 900. Para configurar o conector a fim de publicar métricas conforme são recebidas (sem agrupamento em lotes), especifique 0. O conector publica CloudWatch após receber 20 métricas no mesmo namespace ou após o intervalo especificado. O conector não garante a ordem de publicação de eventos. Nome de exibição no AWS IoT console: **intervalo de publicação** Obrigatório: `true` Digite: `string` Valores válidos: `0 - 900` Padrão válido: `[0-9]|[1-9]\d|[1-9]\d\d|900` `PublishRegion` O Região da AWS para publicar CloudWatch métricas em. Esse valor substitui a região padrão de métricas do Greengrass. É necessário apenas ao publicar métricas entre regiões. Nome de exibição no AWS IoT console: **região de publicação** Obrigatório: `false` Digite: `string` Padrão válido: `^$|([a-z]{2}-[a-z]+-\d{1})` `MemorySize` A memória (em KB) de alocação no conector. Nome de exibição no AWS IoT console: **Tamanho da memória** Obrigatório: `true` Digite: `string` Padrão válido: `^[0-9]+$` `MaxMetricsToRetain` O número máximo de métricas em todos os namespaces para salvar na memória antes que sejam substituídas por novas métricas. O valor mínimo é 2000. Esse limite aplica-se quando não há conexão com a Internet, e o conector começa a armazenar as métricas em buffer para publicar posteriormente. Quando o buffer está cheio, as métricas mais antigas são substituídas por novas métricas. As métricas em um determinado namespace são substituídas apenas por métricas no mesmo namespace. As métricas não são salvas se o processo de host do conector é interrompido. Por exemplo, essa interrupção pode ocorrer durante a implantação do grupo ou quando o dispositivo é reiniciado. Nome de exibição no AWS IoT console: **Métricas máximas a serem retidas** Obrigatório: `true` Digite: `string` Padrão válido: `^([2-9]\d{3}|[1-9]\d{4,})$` `IsolationMode` O modo de [conteinerização](connectors.md#connector-containerization) para este conector. O padrão é`GreengrassContainer`, o que significa que o conector é executado em um ambiente de execução isolado dentro do AWS IoT Greengrass contêiner. A configuração padrão de conteinerização para o grupo não se aplica aos conectores. Nome de exibição no AWS IoT console: **modo de isolamento de contêiner** Obrigatório: `false` Digite: `string` Valores válidos: `GreengrassContainer` ou `NoContainer` Padrão válido: `^NoContainer$|^GreengrassContainer$` ------ #### [ Versions 1 - 3 ] `PublishInterval` O número máximo de segundos de espera antes de publicar métricas em lote para um determinado namespace. O valor máximo é 900. Para configurar o conector a fim de publicar métricas conforme são recebidas (sem agrupamento em lotes), especifique 0. O conector publica CloudWatch após receber 20 métricas no mesmo namespace ou após o intervalo especificado. O conector não garante a ordem de publicação de eventos. Nome de exibição no AWS IoT console: **intervalo de publicação** Obrigatório: `true` Digite: `string` Valores válidos: `0 - 900` Padrão válido: `[0-9]|[1-9]\d|[1-9]\d\d|900` `PublishRegion` O Região da AWS para publicar CloudWatch métricas em. Esse valor substitui a região padrão de métricas do Greengrass. É necessário apenas ao publicar métricas entre regiões. Nome de exibição no AWS IoT console: **região de publicação** Obrigatório: `false` Digite: `string` Padrão válido: `^$|([a-z]{2}-[a-z]+-\d{1})` `MemorySize` A memória (em KB) de alocação no conector. Nome de exibição no AWS IoT console: **Tamanho da memória** Obrigatório: `true` Digite: `string` Padrão válido: `^[0-9]+$` `MaxMetricsToRetain` O número máximo de métricas em todos os namespaces para salvar na memória antes que sejam substituídas por novas métricas. O valor mínimo é 2000. Esse limite aplica-se quando não há conexão com a Internet, e o conector começa a armazenar as métricas em buffer para publicar posteriormente. Quando o buffer está cheio, as métricas mais antigas são substituídas por novas métricas. As métricas em um determinado namespace são substituídas apenas por métricas no mesmo namespace. As métricas não são salvas se o processo de host do conector é interrompido. Por exemplo, essa interrupção pode ocorrer durante a implantação do grupo ou quando o dispositivo é reiniciado. Nome de exibição no AWS IoT console: **Métricas máximas a serem retidas** Obrigatório: `true` Digite: `string` Padrão válido: `^([2-9]\d{3}|[1-9]\d{4,})$` ------ ### Exemplo de criação de conector (AWS CLI) O comando CLI a seguir cria um `ConnectorDefinition` com uma versão inicial que contém o conector CloudWatch Metrics. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyCloudWatchMetricsConnector", "ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/CloudWatchMetrics/versions/4", "Parameters": { "PublishInterval" : "600", "PublishRegion" : "us-west-2", "MemorySize" : "16", "MaxMetricsToRetain" : "2500", "IsolationMode" : "GreengrassContainer" } } ] }' ``` No AWS IoT Greengrass console, você pode adicionar um conector na página **Conectores** do grupo. Para obter mais informações, consulte [Conceitos básicos de conectores do Greengrass (console)](connectors-console.md). ## Dados de entrada Esse conector aceita métricas em um tópico do MQTT e publica as métricas em. CloudWatch As mensagens de entrada devem estar no formato JSON. **Filtro de tópico na assinatura** `cloudwatch/metric/put` **Propriedades de mensagens** `request` Informações sobre a métrica nesta mensagem. O objeto de solicitação contém os dados de métrica para publicação no CloudWatch. Os valores de métrica devem atender às especificações de API [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html). Apenas o `namespace`, `metricData.metricName` e as propriedades `metricData.value` são necessários. Obrigatório: `true` Tipo: `object` que inclui as seguintes propriedades: `namespace` O namespace definido pelo usuário para os dados métricos nessa solicitação. CloudWatch usa namespaces como contêineres para pontos de dados métricos. Você não pode especificar um namespace que comece com a string reservada `AWS/`. Obrigatório: `true` Digite: `string` Padrão válido: `[^:].*` `metricData` Os dados para a métrica. Obrigatório: `true` Tipo: `object` que inclui as seguintes propriedades: `metricName` O nome da métrica. Obrigatório: `true` Digite: `string` `dimensions` As dimensões associadas com a métrica. As dimensões fornecem mais informações sobre a métrica e seus dados. Uma métrica pode definir até 10 dimensões. Esse conector inclui, automaticamente, uma dimensão chamada `coreName`, em que o valor é o nome do núcleo. Obrigatório: `false` Tipo: `array` de objetos de dimensão que incluem as seguintes propriedades: `name` O nome da dimensão. Obrigatório: `false` Digite: `string` `value` O valor da dimensão. Obrigatório: `false` Digite: `string` `timestamp` O horário em que os dados da métrica foram recebidos, expresso em segundos desde `Jan 1, 1970 00:00:00 UTC`. Se esse valor for omitido, o conector usará o horário em que ele recebeu a mensagem. Obrigatório: `false` Digite: `timestamp` Se você usar entre as versões 1 e 4 desse conector, recomendamos que você recupere o timestamp separadamente para cada métrica ao enviar várias métricas de uma única fonte. Não use uma variável para armazenar o timestamp. `value` O valor para a métrica. CloudWatch rejeita valores muito pequenos ou muito grandes. Os valores devem estar no intervalo de `8.515920e-109` a `1.174271e+108` (Base 10) ou `2e-360` a `2e360` (Base 2). Os valores especiais (por exemplo, `NaN`, `+Infinity`, `-Infinity`) não são compatíveis. Obrigatório: `true` Digite: `double` `unit` A unidade da métrica. Obrigatório: `false` Digite: `string` Valores válidos: `Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None` Limites Todos os limites impostos pela CloudWatch [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)API se aplicam às métricas ao usar esse conector. É especialmente importante observar os limites a seguir: + Limite de 40 KB na carga da API + 20 métricas por solicitação de API + 150 transações por segundo (TPS) para a API `PutMetricData` Para obter mais informações, consulte [CloudWatch os limites](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) no *Guia CloudWatch do usuário da Amazon*. **Exemplo de entrada** ``` { "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } } ``` ## Dados de saída O conector publica informações de status como dados de saída em um tópico MQTT. **Filtro de tópico na assinatura** `cloudwatch/metric/put/status` **Exemplo de resultado: sucesso** A resposta inclui o namespace dos dados métricos e o `RequestId` campo da CloudWatch resposta. ``` { "response": { "cloudwatch_rid":"70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status":"success" } } ``` **Exemplo de resultado: falha** ``` { "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message":"cw metric is invalid", "status":"fail" } } ``` Se o conector detectar um erro que pode ser repetido (por exemplo, erros de conexão), ele tentará publicar novamente no próximo lote. ## Exemplo de uso Use as seguintes etapas de alto nível para configurar um exemplo de função do Lambda Python 3.7 que pode ser usado para testar o conector. **nota** Se você usar outros tempos de execução do Python, poderá criar um link simbólico para Python3.x o Python 3.7. Os tópicos [Conceitos básicos de conectores (console)](connectors-console.md) e [Conceitos básicos de conectores (CLI)](connectors-cli.md) contêm etapas detalhadas que mostram como configurar e implantar um exemplo do conector de notificações do Twilio. 1. Certifique-se de cumprir os [requisitos](#cloudwatch-metrics-connector-req) para o conector. Para o requisito de função de grupo, você deve configurar a função para conceder as permissões necessárias e certificar-se de que a função tenha sido adicionada ao grupo. Para acessar mais informações, consulte [Gerenciar a função de grupo do Greengrass (console)](group-role.md#manage-group-role-console) ou [Gerenciar a função de grupo do Greengrass (CLI)](group-role.md#manage-group-role-cli). 1. Crie e publique uma função do Lambda que envie dados de entrada para o conector. Salve o [código de exemplo](#cloudwatch-metrics-connector-usage-example) como arquivo PY. Baixe e descompacte o [SDK do AWS IoT Greengrass Core para Python](lambda-functions.md#lambda-sdks-core). Crie então um pacote zip que contenha o arquivo PY e a pasta `greengrasssdk` no nível raiz. Este pacote zip é o pacote de implantação que você transfere por upload para o AWS Lambda. Depois de criar a função do Lambda Python 3.7, publique uma versão de função e crie um alias. 1. Configure o grupo do Greengrass. 1. Adicione a função do Lambda pelo seu alias (recomendado). Configure o ciclo de vida do Lambda como de longa duração (ou `"Pinned": true` na CLI). 1. Adicione o conector e configure seus [parâmetros](#cloudwatch-metrics-connector-param). 1. Adicione assinaturas que permitam que o conector receba [dados de entrada](#cloudwatch-metrics-connector-data-input) e envie [dados de saída](#cloudwatch-metrics-connector-data-output) em filtros de tópico compatíveis. + Defina a função do Lambda como origem, o conector como destino e use um filtro de tópico de entrada compatível. + Defina o conector como origem, o AWS IoT Core como destino, e use um filtro de tópico de saída compatível. Você usa essa assinatura para visualizar mensagens de status no AWS IoT console. 1. Implante o grupo. 1. No AWS IoT console, na página **Teste**, inscreva-se no tópico de dados de saída para ver as mensagens de status do conector. A função de exemplo do Lambda é de longa duração e começa a enviar mensagens imediatamente após o grupo ser implantado. Ao finalizar o teste, você pode definir o ciclo de vida do Lambda como sob demanda (ou `"Pinned": false` na CLI) e implantar o grupo. Isso impede o envio de mensagens pela função. ### Exemplo O exemplo a seguir da função do Lambda envia uma mensagem de entrada para o conector. ``` import greengrasssdk import time import json iot_client = greengrasssdk.client('iot-data') send_topic = 'cloudwatch/metric/put' def create_request_with_all_fields(): return { "request": { "namespace": "Greengrass_CW_Connector", "metricData": { "metricName": "Count1", "dimensions": [ { "name": "test", "value": "test" } ], "value": 1, "unit": "Seconds", "timestamp": time.time() } } } def publish_basic_message(): messageToPublish = create_request_with_all_fields() print("Message To Publish: ", messageToPublish) iot_client.publish(topic=send_topic, payload=json.dumps(messageToPublish)) publish_basic_message() def lambda_handler(event, context): return ``` ## Licenças O conector CloudWatch Metrics inclui os seguintes terceiros software/licensing: + [AWS SDK para Python (Boto3)](https://pypi.org/project/boto3/)/Licença Apache 2.0 + [botocore](https://pypi.org/project/botocore/)/Licença Apache 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/Licença PSF + [docutils](https://pypi.org/project/docutils/)/Licença BSD, GNU Licença pública geral (GPL), Licença Python Software Foundation, Domínio público + [jmespath](https://pypi.org/project/jmespath/)/Licença MIT + [s3transfer](https://pypi.org/project/s3transfer/)/Licença Apache 2.0 + [urllib3](https://pypi.org/project/urllib3/)/Licença MIT Esse conector é liberado de acordo com o [Contrato de licença de software do Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog A tabela a seguir descreve as alterações em cada versão do conector. | Versão | Alterações | | --- | --- | | 5 | Correção para adicionar suporte para timestamps duplicados nos dados de entrada. | | 4 | Adicionado o parâmetro `IsolationMode` para configurar o modo de conteinerização para o conector. | | 3 | Atualização do runtime do Lambda para Python 3.7, o que altera o requisito de runtime. | | 2 | Corrija para reduzir o registro excessivo. | | 1 | Versão inicial. | Um grupo do Greengrass só pode conter uma versão do conector por vez. Para obter informações sobre como fazer upgrade de uma versão do conector, consulte [Atualizar a versões do conector](connectors.md#upgrade-connector-versions). ## Consulte também + [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md) + [Conceitos básicos de conectores do Greengrass (console)](connectors-console.md) + [Conceitos básicos de conectores do Greengrass (CLI)](connectors-cli.md) + [Usando CloudWatch métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) no *Guia do CloudWatch usuário da Amazon* + [ PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)na *Amazon CloudWatch API Reference*