Acesse os registros do sistema de arquivos CloudWatch Registros de acesso Acesse os registros de serviços do sistema Habilitar o registro em CloudWatch registros Configurar o registro em log para o AWS IoT Greengrass Logs do AWS CloudTrail

Monitore AWS IoT Greengrass os registros

O AWS IoT Greengrass consiste no serviço em nuvem e no software do AWS IoT Greengrass Core. 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 log do AWS IoT Greengrass incluem um time stamp, nível de log 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 registros 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 ter mais informações, consulte Habilitar o registro em CloudWatch registros.

Tópicos

Acesse os registros do sistema de arquivos
CloudWatch Registros de acesso
Acesse os registros de serviços do sistema
Habilitar o registro em CloudWatch registros
Configurar o registro em log para o AWS IoT Greengrass
Logs do AWS CloudTrail

Acesse os registros 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 registros tem a seguinte estrutura.


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

greengrass.log— O arquivo de log do software AWS IoT Greengrass principal. Use esse arquivo de log para visualizar informações em tempo real sobre componentes e implantações. Esse arquivo de log inclui registros do núcleo Greengrass, que é o núcleo do software AWS IoT Greengrass Core, e componentes de plug-in, como gerenciador de registros e gerenciador secreto.
ComponentName.log— Arquivos de log do componente Greengrass. Use arquivos de log de componentes para visualizar informações em tempo real sobre um componente do Greengrass que é executado no dispositivo principal. Os componentes genéricos e os componentes do Lambda gravam a saída padrão (stdout) e o erro padrão (stderr) nesses arquivos de log.
main.log— O arquivo de log do main serviço que manipula os ciclos de vida dos componentes. Esse arquivo de log estará sempre vazio.

Para obter mais informações sobre as diferenças entre componentes de plug-in, genéricos e Lambda, consulte. Tipos de componentes

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

Permissões de usuário root

É necessário ter permissões raiz para ler logs do AWS IoT Greengrass 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 registro de cada componente no componente do gerenciador de registros.

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 type comando 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. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz e substitua com.example. HelloWorldcom o 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 registros 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 obter mais informações, consulte logs e Interface de linha de comando do Greengrass.

CloudWatch Registros de acesso

Você pode implantar o componente do gerenciador de registros para configurar o dispositivo principal para gravar CloudWatch nos registros. Para ter 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 registros


/aws/greengrass/componentType/region/componentName

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

componentType— O tipo do componente, que pode ser um dos seguintes:
- GreengrassSystemComponent— Esse grupo de registros inclui registros para o núcleo e os componentes do plug-in, que são executados na mesma JVM que o núcleo do Greengrass. O componente faz parte do núcleo do Greengrass.
- UserComponent— Esse grupo de registros inclui registros de componentes genéricos, componentes Lambda e outros aplicativos no dispositivo. O componente não faz parte do núcleo do Greengrass.
Para ter mais informações, consulte Tipos de componentes.
region— A AWS região que o dispositivo principal usa.
componentName— O nome do componente. Para registros do sistema, esse valor éSystem.

Nome do fluxo de log


/date/thing/thingName

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

date— A data do registro, como2020/12/15. O componente do gerenciador de registros usa o yyyy/MM/dd formato.
thingName— O nome do dispositivo principal.

nota

Se o nome de uma coisa contiver dois pontos (:), o gerenciador de registros 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 registro

nota
Recomendamos que você atualize para a versão 2.3.0 do gerenciador de registros, 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 anterior) do componente gerenciador de registros processa e carrega registros 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 de tamanho de arquivo de log para fazer com que os arquivos de log girem 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 posterior) do componente gerenciador de registros processa e carrega todos os registros. Quando você grava um novo registro, a versão 2.3.0 (e posterior) do gerenciador de registros processa e carrega diretamente esse arquivo de log ativo em vez de esperar que ele seja rotacionado. Isso significa que você pode visualizar o novo registro em 5 minutos ou menos.

O componente gerenciador de registros carrega novos registros periodicamente. Por padrão, o componente do gerenciador de registros carrega novos registros 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 registros podem ser carregados quase em tempo real a partir do mesmo sistema de arquivos do Greengrass. Se você precisar observar os registros em tempo real, considere usar os registros do sistema de arquivos.

nota
Se você estiver usando sistemas de arquivos diferentes para gravar registros, o gerenciador de registros retornará ao comportamento nas versões 2.2.8 e anteriores do componente do gerenciador de registros. Para obter informações sobre como acessar registros do sistema de arquivos, consulte Acessar registros do sistema de arquivos.
Inclinaçã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 registros 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 registros de serviços do sistema (CLI)

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
```
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 registros de erros 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 o aplicativo Visualizador de Eventos para visualizar os registros de serviços do sistema.

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

Abra o aplicativo Visualizador de Eventos.
Selecione Registros do Windows para expandi-lo.
Escolha Aplicativo para visualizar os registros do serviço do aplicativo.
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 registros de componentes incluem registros 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 ter mais informações, consulte Configurar o registro em log para o AWS IoT Greengrass.

Configurar o registro em log para o AWS IoT Greengrass

Você pode configurar as seguintes opções para personalizar o registro 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 registros.

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 registros. Para ter mais informações, consulte Habilitar o registro em CloudWatch registros.
Excluindo 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 deleteLogFileAfterCloudUpload parâmetro do componente gerenciador de registros, que você pode especificar para os registros AWS IoT Greengrassdo software principal e os registros de componentes.
Registrar limites de espaço em disco

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 greengrass.log arquivos rotacionados. Para obter mais informações, consulte o parâmetro do componente Greengrass nucleus e o logging.totalLogsSizeKB parâmetro do componente gerenciador de registros, que você pode especificar para os registros do diskSpaceLimitsoftware AWS IoT Greengrass principal e os registros 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 registros processa e carrega todos os registros em vez de esperar que eles sejam alternados. Para obter mais informações, consulte o parâmetro de limite de tamanho do arquivo de log do componente Greengrass nucleus (). logging.fileSizeKB
Níveis mínimos de registro

Você pode configurar o nível mínimo de registro que o componente nucleus do Greengrass grava nos registros do sistema de arquivos. Por exemplo, você pode especificar registros de DEBUG nível para ajudar na solução de problemas ou pode especificar registros de ERROR nível para reduzir a quantidade de registros que um dispositivo principal cria. Para obter mais informações, consulte o parâmetro de nível de log do componente Greengrass nucleus (). 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 registro mais alto para reduzir os custos de registro. Para obter mais informações, consulte o minimumLogLevel parâmetro do componente gerenciador de registros, que você pode especificar para os registros AWS IoT Greengrassdo software principal e os registros 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 registros 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 registros (periodicUploadIntervalSec).
Formato de registro

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 registros ou escolha o formato JSON se usar um aplicativo para ler ou analisar registros. Para obter mais informações, consulte o parâmetro de formato de log do componente Greengrass nucleus (). logging.format
Pasta de registros do sistema de arquivos local

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

Logs do AWS CloudTrail

AWS IoT Greengrassintegra-se comAWS 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) emAWS IoT Greengrass. Para ter mais informações, consulte Registre AWS IoT Greengrass V2 API chamadas com AWS CloudTrail.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Registrar em log e monitoramento

Registre API chamadas com CloudTrail