AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

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 logs do AWS IoT Greengrass

O AWS IoT Greengrass consiste no serviço em nuvem e no software do AWS IoT Greengrass Core. O software AWS IoT Greengrass Core pode gravar logs no Amazon CloudWatch e no sistema de arquivos local do dispositivo de núcleo. As funções e conectores do Lambda executados no núcleo também podem gravar logs no CloudWatch Logs e no sistema de arquivos local. Você pode usar os logs para monitorar eventos e solucionar problemas. Todas as entradas de log do AWS IoT Greengrass incluem um time stamp, nível de log 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 em log para o AWS IoT Greengrass.

Acessando logs do CloudWatch Logs

Se você configurar o registro em log do CloudWatch, você poderá visualizar os logs na página Logs do console do Amazon CloudWatch. Grupos de log para logs do AWS IoT Greengrass 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 seguintes considerações se aplicam ao usar o CloudWatch Logs::

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

As seguintes considerações se aplicam ao usar logs de sistema de arquivos:

Configuração de registro em log padrão

Se as configurações de registro em log não estiverem explicitamente configuradas, o AWS IoT Greengrass usará a seguinte configuração de registro em log padrão após a primeira implantação do grupo.

Configurar o registro em log para o AWS IoT Greengrass

Você pode usar o console do AWS IoT ou as APIs do AWS IoT Greengrass para configurar o registro em log do AWS IoT Greengrass.

Configurar o registro em log (console)

Você pode configurar o registro de log na página Settings (Configurações) do grupo.

Configurar o registro em log (API)

Você pode usar as APIs do registrador do AWS IoT Greengrass para configurar o registro em log de forma programática. Por exemplo, use a ação CreateLoggerDefinition para criar uma definição de registrador com base em uma carga útil LoggerDefinitionVersion, 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 Logger que tem as seguintes propriedades:

Exemplo de configuração

O exemplo a seguir LoggerDefinitionVersion especifica uma configuração de registro de log que:

{
  "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.

Limitações de registro em log

O AWS IoT Greengrass apresenta as seguintes limitações de registro em log.

Transações por segundo

Quando o registro em log no CloudWatch é habilitado, o componente de registro em log cria lotes de eventos de log localmente antes de enviá-los ao CloudWatch, de modo que você possa criar um registro a uma taxa maior que cinco solicitações por segundo em cada fluxo de logs.

Memória

Se o AWS IoT Greengrass for configurado para enviar logs ao CloudWatch e uma função do Lambda registrar mais de 5 MB/segundo por um período prolongado, o pipeline de processamento interno acabará sendo preenchido. O pior caso teórico é 6 MB por função do Lambda.

Distorção do relógio

Quando o registro em log no CloudWatch é habilitado, o componente de registro assina solicitações no CloudWatch usando o processo normal do Signature versão 4. Se o horário do sistema no dispositivo do núcleo AWS IoT Greengrass ficar fora de sincronia por mais de 15 minutos, 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:

Perda de log

Se o dispositivo do núcleo AWS IoT Greengrass estiver configurado para registrar somente no CloudWatch e não houver conexão com a Internet, você não terá como recuperar os logs que estão na memória no momento.

Quando as funções do Lambda forem encerradas (por exemplo, durante a implantação), alguns segundos dos logs não serão gravados no CloudWatch.

Logs do CloudTrail

O AWS IoT Greengrass é executado com o AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um serviço da AWS no AWS IoT Greengrass. Para ter mais informações, consulte Registrar em log chamadas de API do AWS IoT Greengrass com o AWS CloudTrail.