Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Reenviador de registros del sistema
<a name="system-log-forwarder-component"></a>

El reenviador de registros del sistema (`aws.greengrass.SystemLogForwarder`) carga los registros activos del sistema directamente a Amazon CloudWatch mediante la API CloudWatch HTTPS.

**importante**  
Este componente solo reenviará los registros de systemd-journald generados durante el tiempo de ejecución. Para obtener más información sobre los registros de systemd-journald, consulte [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) y [journalctl](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#).

**nota**  
Este componente requiere permisos específicos para crear y administrar grupos de CloudWatch registros y transmisiones.

**Topics**
+ [Versiones](#system-log-forwarder-component-versions)
+ [Tipo](#system-log-forwarder-component-type)
+ [Sistema operativo](#system-log-forwarder-component-os-support)
+ [Requisitos](#system-log-forwarder-component-requirements)
+ [Puntos de conexión y puertos](#system-log-forwarder-component-endpoints)
+ [Dependencias](#system-log-forwarder-component-dependencies)
+ [Configuración](#system-log-forwarder-component-configuration)
+ [Registros de cambios](#system-log-forwarder-component-changelog)

## Versiones
<a name="system-log-forwarder-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 2.1.x
+ 2.0.x

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

<a name="public-component-type-generic"></a>Este <a name="public-component-type-generic-phrase"></a>componente es un componente genérico (`aws.greengrass.generic`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta los scripts del ciclo de vida del componente.

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

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

Este componente debe instalarse en sistemas Linux basados en systemd.

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

Este componente tiene los siguientes requisitos:

El componente requiere acceso para crear grupos de registros y transmisiones CloudWatch , así como permiso para realizar la llamada PutLogEvents HTTP. Debe agregar, como mínimo, los siguientes permisos de política al alias de rol de su dispositivo de 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 obtener más información, consulte la página de [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) del reenviador de registros del sistema.

## Puntos de conexión y puertos
<a name="system-log-forwarder-component-endpoints"></a>

Este componente debe poder realizar solicitudes salientes a los siguientes puntos de conexión y puertos, además de a los puntos de conexión y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte [Cómo permitir el tráfico del dispositivo a través de un proxy o firewall](allow-device-traffic.md).


| punto de enlace | Puerto | Obligatorio | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | No |  Es obligatorio si escribes CloudWatch registros en Logs.  | 

## Dependencias
<a name="system-log-forwarder-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#system-log-forwarder-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 2.1.x ]

La siguiente tabla muestra las dependencias de la versión 2.1.x de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | Mayor or igual a 2.0.0 | Rígido | 
| [Versión lite del núcleo de Greengrass](greengrass-nucleus-lite-component.md) | >=2.3.0 | Flexible | 

------
#### [ 2.0.x ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.x de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Servicio de intercambio de token](token-exchange-service-component.md) | Mayor or igual a 2.0.0 | Rígido | 

------

## Configuración
<a name="system-log-forwarder-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

------
#### [ 2.0.x-2.1.x ]

`maxUploadIntervalSec`  
El periodo máximo durante el cual el reenviador de registros del sistema intentará cargar los registros. Dado que el reenviador de registros cargará los registros cuando la memoria se llene, es posible que siga cargando con más frecuencia que la cadencia máxima configurada.

`maxRetriesCount`  
Cantidad de veces que el reenviador de registros del sistema intentará volver a intentar un error HTTP transitorio.

`bufferCapacity`  
Tamaño del búfer circular para el almacenamiento de registros en memoria.

`logGroup`  
La ruta de inicio de sesión. CloudWatch

`logStream`  
El CloudWatch LogStream.

`filters`  
Mapa de configuraciones de filtros para el dispositivo principal.    
`services`  
Lista de filtros de nombres de servicio que el reenviador de registros del sistema utilizará para determinar los registros que se cargarán. Un registro solo se cargará si el servicio desde el que se originó coincide con al menos uno de los filtros de esta lista. Los filtros de esta lista pueden ser una cadena con la que el nombre del servicio debe coincidir, o puede ser una cadena que termina en \$1, lo que significa que el prefijo debe coincidir.  
Valor predeterminado: `[ggl.*]`  
Un registro solo se cargará si el servicio desde el que se originó coincide con al menos uno de los filtros de esta lista.
Si se utiliza el valor \$1, se incluirán todos los servicios disponibles.

**Example Ejemplo de configuración:**  
El siguiente ejemplo filtrará los registros por todos los servicios incluidos en la versión lite del núcleo de Greengrass.  

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

------

## Registros de cambios
<a name="system-log-forwarder-component-changelog"></a>

En la siguiente tabla, se describen los cambios en cada versión del componente.


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Versión inicial.  |