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

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

Versiones

Este componente tiene las siguientes versiones:

Tipo

Este componente es un componente genérico (aws.greengrass.generic). El núcleo de Greengrass ejecuta los scripts del ciclo de vida del componente.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

Este componente debe instalarse en sistemas Linux basados en systemd.

Requisitos

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

Puntos de conexión y puertos

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.

Dependencias

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 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. 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	Mayor or igual a 2.0.0	Rígido
Versión lite del núcleo de Greengrass	>=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	Mayor or igual a 2.0.0	Rígido

Configuración

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 *, lo que significa que el prefijo debe coincidir.

Valor predeterminado: [ggl.*]

importante

Un registro solo se cargará si el servicio desde el que se originó coincide con al menos uno de los filtros de esta lista.

nota

Si se utiliza el valor *, se incluirán todos los servicios disponibles.

ejemplo 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

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