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á. # Monitoramento com AWS IoT Greengrass logs AWS IoT Greengrass consiste no serviço de nuvem e no software AWS IoT Greengrass principal. O software AWS IoT Greengrass Core pode gravar registros na Amazon CloudWatch e no sistema de arquivos local do seu dispositivo principal. As funções e conectores Lambda executados no núcleo também podem gravar registros nos CloudWatch registros e no sistema de arquivos local. Você pode usar os logs para monitorar eventos e solucionar problemas. Todas as entradas de AWS IoT Greengrass registro incluem um registro de data e hora, nível de registro e informações sobre o evento. As alterações nas configurações de registro em log entram em vigor após a implantação do grupo. O registro é configurado no nível do grupo. Para obter as etapas que mostram como configurar o registro em log para um grupo do Greengrass, consulte [Configurar o registro para AWS IoT Greengrass](#config-logs). ## Acessando CloudWatch registros Se você configurar o CloudWatch registro, poderá visualizar os registros na página **Logs** do CloudWatch console da Amazon. Os grupos de AWS IoT Greengrass registros para registros usam as seguintes convenções de nomenclatura: ``` /aws/greengrass/GreengrassSystem/{{greengrass-system-component-name}} /aws/greengrass/Lambda/{{aws-region}}/{{account-id}}/{{lambda-function-name}} ``` Cada grupo de log contém fluxos de log que usam a seguinte convenção de nomenclatura: ``` {{date}}/{{account-id}}/{{greengrass-group-id}}/{{name-of-core-that-generated-log}} ``` As considerações a seguir se aplicam quando você usa o CloudWatch Logs: + Os registros são enviados para o CloudWatch Logs com um número limitado de novas tentativas, caso não haja conexão com a Internet. Depois que as novas tentativas são esgotadas, o evento é descartado. + Transação, memória e outras limitações se aplicam. Para obter mais informações, consulte [Limitações de registro em log](#gg-log-limits). + Sua função de grupo do Greengrass deve permitir AWS IoT Greengrass a gravação em registros. CloudWatch Para conceder permissões, [incorpore a seguinte política em linha](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console) em sua função de grupo. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Resource": [ "arn:aws:logs:*:*:*" ] } ] } ``` ------ **nota** Você pode conceder acesso mais granular a seus recursos de log. Para obter mais informações, consulte [Uso de políticas baseadas em identidade (políticas do IAM) para CloudWatch registros no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) *do usuário da Amazon*. A função do grupo é um perfil do IAM que você cria e associa ao grupo do Greengrass. Você pode usar o console ou a AWS IoT Greengrass API para gerenciar a função do grupo.   **Como usar o console** 1. No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1). 1. Selecione o grupo de destino. 1. Selecione **Visualizar configurações** . Em **Função do grupo**, você pode visualizar, associar ou desassociar a função do grupo. Para saber as etapas que mostram como associar a função do grupo, consulte [função do grupo](group-role.md).   **Uso da CLI** + Para localizar a função do grupo, use o comando [get-associated-role](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-associated-role.html). + Para associar a função do grupo, use o comando [associate-role-to-group](https://docs.aws.amazon.com/cli/latest/reference/greengrass/associate-role-to-group.html). + Para remover a função do grupo, use o comando [disassociate-role-from-group](https://docs.aws.amazon.com/cli/latest/reference/greengrass/disassociate-role-from-group.html).   Para saber como obter o ID do grupo para usar com esses comandos, consulte [Obter o ID do grupo](deployments.md#api-get-group-id). ## Acessar os logs do sistema de arquivos Se você configurar o registro em log de sistema de arquivos, os arquivos de log são armazenados em `{{greengrass-root}}/ggc/var/log` no dispositivo de núcleo. A estrutura de diretório a seguir é de alto nível: ``` {{greengrass-root}}/ggc/var/log - crash.log - system - log files for each Greengrass system component - user - {{region}} - {{account-id}} - log files generated by each user-defined Lambda function - aws - log files generated by each connector ``` **nota** Por padrão {{greengrass-root}} é o diretório `/greengrass`. Caso um [diretório de gravação](gg-core.md#write-directory) seja configurado, os logs estão nesse diretório. As seguintes considerações se aplicam ao usar logs de sistema de arquivos: + A leitura de AWS IoT Greengrass registros no sistema de arquivos requer permissões de root. + AWS IoT Greengrass suporta rotação baseada em tamanho e limpeza automática quando a quantidade de dados de registro está próxima do limite configurado. + O arquivo `crash.log` está disponível apenas no sistema de arquivos de logs. Esse registro não é gravado em CloudWatch Registros. + Limitações de uso de disco se aplicam. Para obter mais informações, consulte [Limitações de registro em log](#gg-log-limits). **nota** Os registros AWS IoT Greengrass do software Core v1.0 são armazenados no `{{greengrass-root}}/var/log` diretório. ## Configuração de registro em log padrão Se as configurações de registro não estiverem definidas explicitamente, AWS IoT Greengrass usa a seguinte configuração de registro padrão após a primeira implantação em grupo. AWS IoT Greengrass Componentes do sistema + Digite - `FileSystem` + Componente - `GreengrassSystem` + Nível - `INFO` + Espaço - `128 KB` User-defined Funções Lambda + Digite - `FileSystem` + Componente - `Lambda` + Nível - `INFO` + Espaço - `128 KB` **nota** Antes da primeira implantação, apenas os componentes do sistema gravam logs ao sistema de arquivos porque não há funções do Lambda definidas pelo usuário que são implantadas. ## Configurar o registro para AWS IoT Greengrass Você pode usar o AWS IoT console ou as [AWS IoT Greengrass APIs](#config-logs-api) para configurar o AWS IoT Greengrass registro. **nota** Para permitir AWS IoT Greengrass a gravação de registros em CloudWatch registros, sua função de grupo deve permitir as [ações de CloudWatch registros necessárias](#gg-logs-cloudwatch-perms). ### Configurar o registro em log (console) Você pode configurar o registro de log na página **Settings (Configurações)** do grupo. 1. No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1). 1. Selecione o grupo no qual você deseja configurar o registro em log. 1. Na página de configuração do grupo, selecione a guia **Logs**. 1. Selecione o registro local, da seguinte forma: + Para configurar o CloudWatch registro, para **configuração de CloudWatch registros**, escolha **Editar**. + Para configurar o registro do sistema de arquivo, para **Local logs configuration** (Configuração de registro local), selecione **Edit** (Editar). Você pode configurar o registro de um local ou em ambos os locais. 1. No modal de configuração de edição de logs, selecione o **nível de logs do sistema Greengrass** ou o **nível de logs das funções do usuário do Lambda**. Você pode escolher um componente ou ambos os componentes. 1. Selecione o nível mais baixo de eventos que você deseja registrar. Os eventos abaixo desse limite serão excluídos e não serão armazenados. 1. Selecione **Salvar**. As alterações entrarão em vigor após a implantação do grupo. ### Configurar o registro em log (API) Você pode usar as APIs do AWS IoT Greengrass registrador para configurar o registro programaticamente. Por exemplo, use a ação [https://docs.aws.amazon.com/greengrass/v1/apireference/createloggerdefinition-post.html](https://docs.aws.amazon.com/greengrass/v1/apireference/createloggerdefinition-post.html) para criar uma definição de registrador com base em uma carga útil [https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-loggerdefinitionversion.html](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-loggerdefinitionversion.html), que usa a seguinte sintaxe: ``` { "Loggers": [ { "Id": "string", "Type": "FileSystem|AWSCloudWatch", "Component": "GreengrassSystem|Lambda", "Level": "DEBUG|INFO|WARN|ERROR|FATAL", "Space": "integer" }, { "Id": "string", ... } ] } ``` `LoggerDefinitionVersion` é um conjunto de um ou mais objetos de [https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html) que tem as seguintes propriedades: `Id` Um identificador de registrador. `Type` O mecanismo de armazenamento para eventos de log. Quando `AWSCloudWatch` usado, os eventos de registro são enviados para o CloudWatch Logs. Quando `FileSystem` é usado, os eventos de log são armazenados no sistema de arquivos local. Valores válidos: `AWSCloudWatch`, `FileSystem` `Component` A origem do evento de log. Quando `GreengrassSystem` é usado, os eventos de componentes do sistema Greengrass são registrados em log. Quando `Lambda` é usado, os eventos das funções do Lambda definidos pelo usuário são registrados em log. Valores válidos: `GreengrassSystem`, `Lambda` `Level` O limiar no nível de log. Os eventos de log que estiverem abaixo desse limite serão excluídos e não serão armazenados. Valores válidos: `DEBUG`, `INFO` (recomendado), `WARN`, `ERROR`, `FATAL` `Space` A quantidade máxima de armazenamento local, em KB, a ser usado para armazenamento de logs. Este campo é aplicável somente quando `Type` é definido como `FileSystem`. ### Exemplo de configuração O exemplo a seguir `LoggerDefinitionVersion` especifica uma configuração de registro de log que: + Ativa o sistema de arquivos `ERROR` e versões posteriores do registro para componentes AWS IoT Greengrass do sistema. + Ativa o arquivo do sistema `INFO` e superior fazendo o registro em log para funções do Lambda definidas pelo usuário. + Ativa CloudWatch `INFO` (e superior) o registro em log para funções Lambda definidas pelo usuário. ``` { "Name": "LoggingExample", "InitialVersion": { "Loggers": [ { "Id": "1", "Component": "GreengrassSystem", "Level": "ERROR", "Space": 10240, "Type": "FileSystem" }, { "Id": "2", "Component": "Lambda", "Level": "INFO", "Space": 10240, "Type": "FileSystem" }, { "Id": "3", "Component": "Lambda", "Level": "INFO", "Type": "AWSCloudWatch" } ] } } ``` Depois de criar uma versão de definição de registrador, você pode usar o ARN da versão para criar uma versão de grupo antes de [implantar o grupo](deployments.md). ## Limitações de registro em log AWS IoT Greengrass tem as seguintes limitações de registro. ### Transações por segundo Quando o login CloudWatch está ativado, o componente de registro agrupa os eventos de log localmente antes de enviá-los para CloudWatch, para que você possa fazer login a uma taxa superior a cinco solicitações por segundo por stream de log. ### Memória Se AWS IoT Greengrass estiver configurado para enviar registros para CloudWatch e uma função Lambda registrar mais de 5 MB/second por um período prolongado de tempo, o pipeline de processamento interno eventualmente será preenchido. O pior caso teórico é 6 MB por função do Lambda. ### Distorção do relógio Quando o login CloudWatch está ativado, o componente de registro assina solicitações CloudWatch usando o processo normal de assinatura do Signature Version 4. Se o horário do sistema no dispositivo do núcleo AWS IoT Greengrass ficar fora de sincronia por mais de [15 minutos](https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html), as solicitações serão rejeitadas. ### Uso do disco Use a fórmula a seguir para calcular a quantidade total máxima de uso do disco para registro. ``` {{greengrass-system-component-space}} * 8 // 7 if automatic IP detection is disabled + 128KB // the internal log for the local logging component + {{lambda-space}} * {{lambda-count}} // different versions of a Lambda function are treated as one ``` Em que: `greengrass-system-component-space` A quantidade máxima de armazenamento local para os registros dos componentes AWS IoT Greengrass do sistema. `lambda-space` A quantidade máxima de armazenamento local para logs de função do Lambda. `lambda-count` O número de funções do Lambda implantadas. ### Perda de log Se seu dispositivo AWS IoT Greengrass principal estiver configurado para fazer login somente CloudWatch e não houver conexão com a Internet, você não terá como recuperar os registros atualmente na memória. Quando as funções do Lambda são encerradas (por exemplo, durante a implantação), alguns segundos de registros não são gravados. CloudWatch ## CloudTrail troncos AWS IoT Greengrass é executado com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço em AWS IoT Greengrass. Para obter mais informações, consulte [Registro em log AWS IoT Greengrass Chamadas de API com AWS CloudTrail](logging-using-cloudtrail.md).