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

Encaminhador de logs do sistema

O encaminhador de registros do sistema (aws.greengrass.SystemLogForwarder) carrega os registros ativos do sistema diretamente para a Amazon CloudWatch usando a API CloudWatch HTTPS.

Versões

Esse componente tem as seguintes versões:

Tipo

Esse é um componente genérico (aws.greengrass.generic). O Greengrass nucleus executa os scripts do ciclo de vida do componente.

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

Sistema operacional

Esse componente deve ser instalado em sistemas Linux baseados em systemd.

Requisitos

Esse componente tem os seguintes requisitos:

O componente requer acesso para criar grupos de log e stream CloudWatch , bem como permissão para realizar a chamada PutLogEvents HTTP. É necessário, no mínimo, adicionar as permissões de política a seguir ao alias de perfil do seu dispositivo do Greengrass:

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogGroup"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
    },
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
    }
  ]
}

Endpoints e portas

Esse componente precisa ser capaz de realizar solicitações de saída para os endpoints e portas a seguir, além dos endpoints e portas necessários para a operação básica. Para obter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.

2.1.x

A tabela a seguir lista as dependências da versão 2.1.x desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Token Exchange Service	>=2.0.0	Rígido
Greengrass nucleus lite	>=2.3.0	Flexível

2.0.x

A seguinte tabela lista as dependências da versão 2.0.x desse componente.

Dependência	Versões compatíveis	Tipo de dependência
Token Exchange Service	>=2.0.0	Rígido

Configuração

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

2.0.x-2.1.x

maxUploadIntervalSec

O período máximo em que o encaminhador de logs do sistema tentará transferir os logs. Como o encaminhador de logs transferirá os registros quando a memória estiver cheia, ele ainda poderá ser carregado com mais frequência do que a cadência máxima configurada.

maxRetriesCount

Número de vezes que o encaminhador de logs do sistema tentará repetir um erro de HTTP transitório.

bufferCapacity

O tamanho do buffer em anel para armazenamento de logs na memória.

logGroup

O caminho de registro em CloudWatch.

logStream

O CloudWatch LogStream.

filters

Um mapa das configurações de filtro do dispositivo principal.

services

Uma lista de filtros de nomes de serviços que o encaminhador de logs do sistema usará para determinar quais logs serão transferidos. Um log só será transferido se o serviço do qual ele se originou corresponder a pelo menos um dos filtros dessa lista. Os filtros nessa lista podem ser uma string à qual o nome do serviço deve corresponder totalmente ou uma string terminada com *, o que significa que o prefixo deve corresponder.

Padrão: [ggl.*]

Importante

Um log só será transferido se o serviço do qual ele se originou corresponder a pelo menos um dos filtros dessa lista.

nota

O uso do valor * incluirá todos os serviços disponíveis.

exemplo Exemplo de configuração:

O exemplo abaixo filtrará os logs por todos os serviços incluídos no Greengrass nucleus lite.

{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.