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
<a name="system-log-forwarder-component"></a>

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.

**Importante**  
Esse componente encaminhará somente os logs do systemd-journald gerados durante o runtime. Para obter mais informações sobre logs do systemd-journald, consulte [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) e [journalctl](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#).

**nota**  
Esse componente requer permissões específicas para criar e gerenciar grupos e fluxos de CloudWatch registros.

**Topics**
+ [Versões](#system-log-forwarder-component-versions)
+ [Tipo](#system-log-forwarder-component-type)
+ [Sistema operacional](#system-log-forwarder-component-os-support)
+ [Requisitos](#system-log-forwarder-component-requirements)
+ [Endpoints e portas](#system-log-forwarder-component-endpoints)
+ [Dependências](#system-log-forwarder-component-dependencies)
+ [Configuração](#system-log-forwarder-component-configuration)
+ [Changelog](#system-log-forwarder-component-changelog)

## Versões
<a name="system-log-forwarder-component-versions"></a>

Esse componente tem as seguintes versões:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="system-log-forwarder-component-type"></a>

<a name="public-component-type-generic"></a>Esse <a name="public-component-type-generic-phrase"></a>é um componente genérico (`aws.greengrass.generic`). O [Greengrass nucleus](greengrass-nucleus-component.md) executa os scripts do ciclo de vida do componente.

<a name="public-component-type-more-information"></a>Para obter mais informações, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operacional
<a name="system-log-forwarder-component-os-support"></a>

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

## Requisitos
<a name="system-log-forwarder-component-requirements"></a>

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}"
    }
  ]
}
```

------

**nota**  
Para obter mais informações, consulte a página do encaminhador de logs do sistema no [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder).

## Endpoints e portas
<a name="system-log-forwarder-component-endpoints"></a>

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](allow-device-traffic.md).


| Endpoint | Porta | Obrigatório | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | Não |  Obrigatório se você gravar registros em CloudWatch Logs.  | 

## Dependências
<a name="system-log-forwarder-component-dependencies"></a>

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](#system-log-forwarder-component-changelog) 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](https://console.aws.amazon.com//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](token-exchange-service-component.md) | >=2.0.0 | Rígido | 
| [Greengrass nucleus lite](greengrass-nucleus-lite-component.md) | >=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](token-exchange-service-component.md) | >=2.0.0 | Rígido | 

------

## Configuração
<a name="system-log-forwarder-component-configuration"></a>

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 \$1, o que significa que o prefixo deve corresponder.  
Padrão: `[ggl.*]`  
Um log só será transferido se o serviço do qual ele se originou corresponder a pelo menos um dos filtros dessa lista.
O uso do valor \$1 incluirá todos os serviços disponíveis.

**Example 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 name="system-log-forwarder-component-changelog"></a>

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


|  **Versão**  |  **Alterações**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Versão inicial.  |