Monitore AWS IoT Greengrass os registros - AWS IoT Greengrass
Acessar os logs do sistema de arquivos CloudWatch Registros de acessoAcesse os logs de serviços do sistemaHabilitar o registro em CloudWatch registrosConfigurar o registro para AWS IoT GreengrassAWS CloudTrail troncos

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á.

Monitore AWS IoT Greengrass os registros

AWS IoT Greengrass consiste no serviço de nuvem e no software AWS IoT Greengrass principal. O software AWS IoT Greengrass principal pode gravar registros no Amazon CloudWatch Logs e no sistema de arquivos local do dispositivo principal. Os componentes do Greengrass que são executados no dispositivo principal também podem gravar registros no Logs e no sistema de arquivos local. CloudWatch 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.

Por padrão, o software AWS IoT Greengrass Core grava registros somente no sistema de arquivos local. Você pode visualizar os logs do sistema de arquivos em tempo real, para poder depurar os componentes do Greengrass que você desenvolve e implanta. Você também pode configurar um dispositivo principal para gravar registros no CloudWatch Logs, para que você possa solucionar problemas do dispositivo principal sem acessar o sistema de arquivos local. Para obter mais informações, consulte Habilitar o registro em CloudWatch registros.

Acessar os logs do sistema de arquivos

O software AWS IoT Greengrass Core armazena os registros na /greengrass/v2/logs pasta em um dispositivo principal, onde /greengrass/v2 está o caminho para a pasta AWS IoT Greengrass raiz. A pasta de logs tem a estrutura a seguir.

/greengrass/v2
└── logs
    ├── greengrass.log
    ├── greengrass_2021_09_14_15_0.log
    ├── ComponentName.log
    ├── ComponentName_2021_09_14_15_0.log
    └── main.log

Para obter mais informações sobre as diferenças entre plugins, genéricos e do Lambda, consulte Tipos de componente.

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

  • Permissões de usuário root

    Você deve ter permissões de root para ler AWS IoT Greengrass registros no sistema de arquivos.

  • Rotação do arquivo de log

    O software AWS IoT Greengrass Core gira os arquivos de log a cada hora ou quando eles excedem o limite de tamanho do arquivo. Os arquivos de log rotacionados contêm um carimbo de data/hora no nome do arquivo. Por exemplo, um arquivo de log AWS IoT Greengrass do software Core rotacionado pode ser nomeadogreengrass_2021_09_14_15_0.log. O limite de tamanho de arquivo padrão é 1.024 KB (1 MB). Você pode configurar o limite de tamanho do arquivo no componente do núcleo do Greengrass.

  • Exclusão do arquivo de log

    O software AWS IoT Greengrass Core limpa os arquivos de log anteriores quando o tamanho dos arquivos de log do software AWS IoT Greengrass Core ou dos arquivos de log dos componentes do Greengrass, incluindo arquivos de log rotacionados, excede o limite de espaço em disco. O limite de espaço em disco padrão para o log do software AWS IoT Greengrass Core e cada registro de componente é de 10.240 KB (10 MB). Você pode configurar o limite de espaço em disco do log do software AWS IoT Greengrass Core no componente nucleus do Greengrass ou no componente do gerenciador de registros. Você pode configurar o limite de espaço em disco de log de cada componente no componente do gerenciador de logs.

Para visualizar o arquivo de log do software AWS IoT Greengrass principal

  • Execute o comando a seguir para visualizar o arquivo de log em tempo real. /greengrass/v2Substitua pelo caminho para a pasta AWS IoT Greengrass raiz.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\com.example.HelloWorld.log

    O comando type grava o conteúdo do arquivo no terminal. Execute esse comando várias vezes para observar as alterações no arquivo.

    PowerShell
    gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
Para visualizar o arquivo de log de um Componente

  • Execute o comando a seguir para visualizar o arquivo de log em tempo real. C:\greengrass\v2Substitua /greengrass/v2 ou pelo caminho para a pasta AWS IoT Greengrass raiz e com.example.HelloWorld substitua pelo nome do componente.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait

Você também pode usar o logs comando da CLI do Greengrass para analisar os logs do Greengrass em um dispositivo principal. Para usar o logs comando, você deve configurar o núcleo do Greengrass para gerar arquivos de log no formato JSON. Para ter mais informações, consulte Interface de linha de comando do Greengrass e logs.

CloudWatch Registros de acesso

Você pode implantar o componente do gerenciador de registros para configurar o dispositivo principal para gravar CloudWatch nos registros. Para obter mais informações, consulte Habilitar o registro em CloudWatch registros. Em seguida, você pode visualizar os registros na página Logs do CloudWatch console da Amazon ou usando a API CloudWatch Logs.

Nome do grupo de logs
/aws/greengrass/componentType/region/componentName

O nome do grupo de logs usa as seguintes variáveis:

  • componentType: o tipo do componente, que pode ser um dos seguintes:

    • GreengrassSystemComponent: esse grupo de logs inclui logs do núcleo e dos componentes do plug-in, que são executados na mesma JVM do núcleo do Greengrass. O componente faz parte do núcleo do Greengrass.

    • UserComponent: esse grupo de logs inclui logs de componentes genéricos, componentes Lambda e outras aplicações no dispositivo. O componente faz parte do núcleo do Greengrass.

    Para obter mais informações, consulte Tipos de componente.

  • region— A AWS região que o dispositivo principal usa.

  • componentName: o nome do componente. Para logs do sistema, esse valor é System.

Nome do fluxo de logs
/date/thing/thingName

O nome do fluxo de logs usa as seguintes variáveis:

  • date: a data do log, como 2020/12/15. O componente do gerenciador de logs usa o formato yyyy/MM/dd.

  • thingName: o nome do dispositivo principal.

nota

Se o nome de uma coisa contiver dois pontos (:), o gerenciador de logs substituirá os dois pontos por um sinal de adição (+).

As considerações a seguir se aplicam quando você usa o componente gerenciador de CloudWatch registros para gravar em registros:

  • Atrasos no log

    nota

    Recomendamos que você atualize para a versão 2.3.0 do gerenciador de logs, que reduz os atrasos nos arquivos de log rotacionados e ativos. Ao atualizar para o log manager 2.3.0, recomendamos que você também atualize para o Greengrass nucleus 2.9.1.

    A versão 2.2.8 (e anteriores) do componente gerenciador de logs processa e carrega logs somente de arquivos de log rotacionados. Por padrão, o software AWS IoT Greengrass Core gira os arquivos de log a cada hora ou depois de atingirem 1.024 KB. Como resultado, o componente do gerenciador de registros carrega registros somente depois que o software AWS IoT Greengrass Core ou um componente do Greengrass grava mais de 1.024 KB de registros. Você pode configurar um limite menor para o tamanho dos arquivos de log para que rotacionem com mais frequência. Isso faz com que o componente do gerenciador de registros faça upload de registros para o CloudWatch Logs com mais frequência.

    A versão 2.3.0 (e posteriores) do componente gerenciador de logs processa e carrega todos os logs. Quando você grava um novo log, a versão 2.3.0 (e posteriores) do gerenciador de logs processa e carrega diretamente esse arquivo de log ativo em vez de esperar que ele seja rotacionado. Isso significa que você pode ver o novo log em cinco minutos ou menos.

    O componente do gerenciador de logs carrega novos logs periodicamente. Por padrão, o componente do gerenciador de logs carrega novos logs a cada 5 minutos. Você pode configurar um intervalo de upload menor, para que o componente do gerenciador de registros faça o upload dos CloudWatch registros para o Logs com mais frequência configurando o. periodicUploadIntervalSec Para obter mais informações sobre como configurar esse intervalo periódico, consulte Configuração.

    Os logs podem ser carregados quase em tempo real a partir do mesmo sistema de arquivos do Greengrass. Se você precisar observar os logs em tempo real, verifique se é possível usar os logs do sistema de arquivos.

    nota

    Se você estiver usando sistemas de arquivos diferentes para gravar logs, o gerenciador de logs retornará ao comportamento nas versões 2.2.8 e anteriores. Para obter informações sobre como acessar logs do sistema de arquivos, consulte Acessar logs do sistema de arquivos.

  • Distorção do relógio

    O componente do gerenciador de registros usa o processo de assinatura padrão do Signature versão 4 para criar solicitações de API para o CloudWatch Logs. Se a hora do sistema em um dispositivo principal estiver fora de sincronia por mais de 15 minutos, o CloudWatch Logs rejeitará as solicitações. Para obter mais informações, consulte Processo de assinatura do Signature versão 4 na Referência geral da AWS.

Acesse os logs de serviços do sistema

Se você configurar o software AWS IoT Greengrass Core como um serviço do sistema, poderá visualizar os registros do serviço do sistema para solucionar problemas, como a falha na inicialização do software.

Para visualizar os logs de serviços do sistema (CLI)

  1. Execute o comando a seguir para visualizar os registros de serviços do sistema de software AWS IoT Greengrass principal.

    Linux or Unix (systemd)
    sudo journalctl -u greengrass.service
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.wrapper.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.wrapper.log

  2. Em dispositivos Windows, o software AWS IoT Greengrass Core cria um arquivo de log separado para erros de serviço do sistema. Execute o comando a seguir para visualizar os logs de erro do serviço do sistema.

    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.err.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.err.log

Em dispositivos Windows, você também pode usar a aplicação Event Viewer para visualizar os logs de serviços do sistema.

Para visualizar os logs de serviços do Windows (Visualizador de eventos)

  1. Abra a aplicação Visualizador de Eventos.

  2. Selecione Logs do Windows para expandi-lo.

  3. Escolha Aplicação para visualizar os logs do serviço da aplicação.

  4. Encontre e abra registros de eventos cuja fonte é greengrass.

Habilitar o registro em CloudWatch registros

Você pode implantar o componente do gerenciador de registros para configurar um dispositivo principal para gravar registros no CloudWatch Logs. Você pode ativar CloudWatch os registros para os registros do software AWS IoT Greengrass principal e pode habilitar CloudWatch os registros para componentes específicos do Greengrass.

nota

A função de troca de tokens do dispositivo principal do Greengrass deve permitir que o dispositivo principal grave nos CloudWatch registros, conforme mostrado no exemplo de política do IAM a seguir. Se você instalou o software AWS IoT Greengrass Core com provisionamento automático de recursos, seu dispositivo principal tem essas permissões.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

Para configurar um dispositivo principal para gravar registros AWS IoT Greengrass do software principal no CloudWatch Logs, crie uma implantação que especifique uma atualização de configuração definida uploadToCloudWatch true para o aws.greengrass.LogManager componente. AWS IoT Greengrass Os principais registros do software incluem registros do núcleo do Greengrass e dos componentes do plug-in.

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true"
    }
  }
}

Para configurar um dispositivo principal para gravar os registros de um componente do Greengrass em Logs, crie uma implantação que especifique uma atualização de configuração que adicione o componente à lista de configurações de CloudWatch registro de componentes. Quando você adiciona um componente a essa lista, o componente do gerenciador de registros grava seus registros em CloudWatch Logs. Os logs de componentes incluem logs de componentes genéricos e componentes Lambda.

{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
      
      }
    }
  }
}

Ao implantar o componente do gerenciador de registros, você também pode configurar os limites de espaço em disco e se o dispositivo principal excluirá os arquivos de log depois de gravá-los no CloudWatch Logs. Para obter mais informações, consulte Configurar o registro para AWS IoT Greengrass.

Configurar o registro para AWS IoT Greengrass

Você pode configurar as seguintes opções para personalizar o log nos dispositivos principais do Greengrass. Para configurar essas opções, crie uma implantação que especifique uma atualização de configuração para os componentes do Greengrass nucleus ou do gerenciador de logs.

  • Gravando registros em CloudWatch registros

    Para solucionar problemas remotamente nos dispositivos principais, você pode configurar os dispositivos principais para gravar registros de software e componentes AWS IoT Greengrass principais nos registros. CloudWatch Para fazer isso, implante e configure o componente do gerenciador de logs. Para obter mais informações, consulte Habilitar o registro em CloudWatch registros.

  • Excluir arquivos de log enviados

    Para reduzir o uso do espaço em disco, você pode configurar os dispositivos principais para excluir arquivos de log depois de gravá-los em CloudWatch Logs. Para obter mais informações, consulte o parâmetro deleteLogFileAfterCloudUpload do componente gerenciador de logs, que você pode especificar para os logs do software AWS IoT Greengrass Core e os logs de componentes.

  • Limites de espaço em disco para logs

    Para limitar o uso do espaço em disco, você pode configurar o espaço máximo em disco para cada log, incluindo seus arquivos de log rotacionados, em um dispositivo principal. Por exemplo, você pode configurar o espaço máximo combinado em disco para greengrass.log e arquivos greengrass.log rotacionados. Para obter mais informações, consulte o parâmetro logging.totalLogsSizeKB do componente Greengrass nucleus e o parâmetro diskSpaceLimit do componente gerenciador de logs, que você pode especificar para os logs do software AWS IoT Greengrass Core e os logs de componentes.

  • Limite de tamanho do arquivo de log

    Você pode configurar o tamanho máximo de arquivo para cada arquivo de log. Depois que um arquivo de log excede esse limite de tamanho de arquivo, o software AWS IoT Greengrass Core cria um novo arquivo de log. A versão 2.28 (e anterior) do componente gerenciador de registros grava somente arquivos de log rotacionados em CloudWatch Logs, então você pode especificar um limite menor de tamanho de arquivo para gravar registros em Logs com mais CloudWatch frequência. A versão 2.3.0 (e posterior) do componente gerenciador de logs processa e carrega todos os logs em vez de esperar que eles sejam alternados. Para obter mais informações, consulte o parâmetro de limite de tamanho de log do núcleo do Greengrass nucleus (logging.fileSizeKB).

  • Níveis mínimos de log

    Você pode configurar o nível mínimo de log que o componente nucleus do Greengrass grava nos logs do sistema de arquivos. Por exemplo, você pode especificar logs de DEBUG nível para ajudar na solução de problemas ou pode especificar logs de ERROR nível para reduzir a quantidade de logs que um dispositivo principal cria. Para obter mais informações, consulte o parâmetro de nível de log do núcleo do Greengrass (logging.level).

    Você também pode configurar o nível mínimo de registro que o componente gerenciador de registros grava CloudWatch nos registros. Por exemplo, você pode especificar um nível de log mais alto para reduzir os custos de log. Para obter mais informações, consulte o parâmetro minimumLogLevel do componente gerenciador de logs, que você pode especificar para os logs do software AWS IoT Greengrass Core e os logs de componentes.

  • Intervalo para verificar os registros para gravar CloudWatch nos registros

    Para aumentar ou diminuir a frequência com que o componente do gerenciador de registros grava CloudWatch registros em registros, você pode configurar o intervalo em que ele verifica a gravação de novos arquivos de log. Por exemplo, você pode especificar um intervalo menor para visualizar CloudWatch registros em Registros mais cedo do que faria com o intervalo padrão de 5 minutos. Você pode especificar um intervalo maior para reduzir custos, porque o componente do gerenciador de logs agrupa os arquivos de log em menos solicitações. Para obter mais informações, consulte o parâmetro de intervalo de upload do componente gerenciador de logs (periodicUploadIntervalSec).

  • Formato do log

    Você pode escolher se o software AWS IoT Greengrass Core grava registros no formato texto ou JSON. Escolha o formato de texto se você ler logs ou escolha o formato JSON se usar uma aplicação para ler ou analisar logs. Para obter mais informações, consulte o parâmetro de formato de log componente de núcleo do Greengrass (logging.format).

  • Pasta de logs do sistema de arquivos local

    Você pode alterar a pasta de logs /greengrass/v2/logs para outra pasta no dispositivo principal. Para obter mais informações, consulte o parâmetro de diretório de saída do componente de núcleo do Greengrass (logging.outputDirectory).

AWS CloudTrail troncos

AWS IoT Greengrass integra-se com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS service (Serviço da AWS) em AWS IoT Greengrass. Para obter mais informações, consulte Registre chamadas de AWS IoT Greengrass V2 API com AWS CloudTrail.