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 registros 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 núcleo do Greengrass executa os scripts do ciclo de vida do componente.

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

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. Você deve, no mínimo, adicionar as seguintes permissões de política ao alias de função do seu dispositivo 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.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.

v2.0.x

maxUploadIntervalSec

O período máximo em que o encaminhador de registros do sistema tentará carregar os registros. Como o encaminhador de registros carregará 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 registros do sistema tentará repetir um erro HTTP transitório.

bufferCapacity

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

logGroup

O caminho de registro em CloudWatch.

logStream

O CloudWatch LogStream.

filters

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

services

Uma lista de filtros de nomes de serviços que o System Log Forwarder usará para determinar quais registros serão carregados. Um registro só será carregado 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 registro só será carregado 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 registros 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.