Receptores - Amazon CloudWatch
Requisitos y limitaciones

Receptores

Los receptores definen el destino al que se envían los datos de registros procesados. Cada canalización debe tener exactamente un receptor. Actualmente, solo se admite el receptor de Registros de CloudWatch.

Comportamiento del receptor por tipo de origen
Tipo de origen Configuración del grupo de registro Comportamiento
Registros de CloudWatch Debe usar @original Los eventos se devuelven a su grupo de registro original
S3 Ruta del grupo de registro personalizada Los eventos se envían al grupo de registro especificado
API de terceros Ruta del grupo de registro personalizada Los eventos se envían al grupo de registro especificado
Configuración

Configure el receptor con los siguientes parámetros:

ejemplo Configuración de orígenes que no son de Registros de CloudWatch
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
ejemplo Configuración de orígenes de Registros de CloudWatch
sink:
  cloudwatch_logs:
    log_group: "@original"
Parameters
log_group (obligatorio)

El nombre del grupo de registro de registros de CloudWatch al que se enviarán los eventos procesados. Para las canalizaciones con orígenes que no son cloudwatch_logs, debe ser el nombre de un grupo de registro existente. Para las canalizaciones con el origen cloudwatch_logs, el ÚNICO valor permitido es @original.

Requisitos y limitaciones

Existencia del grupo de registro

Si se creó con la Consola de administración de AWS, CloudWatch intentará crear el grupo de registro especificado y la política de recursos adecuada si no existe cuando se utiliza un origen que no sea Registros de CloudWatch. De lo contrario, el grupo de registro especificado debe existir antes de crear la canalización.

Tamaño de eventos

Cada evento de registro no puede superar los 256 KB de tamaño después de su procesamiento.

Retención del grupo de registro

La canalización utiliza los ajustes de retención configurados en el grupo de registro de destino.

Política de recursos del grupo de registros

Las políticas de recursos de Registros de CloudWatch son obligatorias para canalizaciones que escriben en grupos de registro, excepto para las canalizaciones que utilizan el origen cloudwatch_logs. Cuando utilice la Consola de administración de AWS para configurar la canalización, CloudWatch intentará agregar la política de recursos si es necesario. Si va a crear la canalización mediante la AWS CLI o una API, debe crear la política manualmente y agregarla mediante la solicitud logs:PutResourcePolicy. Para obtener más información, consulte Políticas de recursos.

Compatibilidad entre regiones

El grupo de registro de destino y la canalización deben estar en la misma región.

importante

Para las canalizaciones que utilizan el tipo de origen cloudwatch_logs:

  • Debe usar @original como valor del grupo de registro.

  • Los eventos siempre se devuelven a su grupo de registro original.

  • El grupo de registro original debe existir durante todo el ciclo de vida de la canalización.

  • Las canalizaciones con procesadores mutan los eventos de registro en el grupo de registro original de CloudWatch desde el que se interceptan para obtener registros de servicios de AWS.

nota

Los eventos de registro están sujetos a las cuotas y limitaciones de Registros de CloudWatch.