

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.

# Monitoreo de registros de canalización
<a name="monitoring-pipeline-logs"></a>

Puede habilitar el registro de las canalizaciones de Amazon OpenSearch Ingestion para exponer los mensajes de error y advertencia que se generen durante las operaciones de canalización y la actividad de ingestión. OpenSearch Ingestion publica todos los registros en *Amazon CloudWatch Logs*. CloudWatch Los registros pueden monitorear la información de los archivos de registro y notificarle cuando se alcanzan ciertos umbrales. También se pueden archivar los datos del registro en un almacenamiento de larga duración. Para obtener más información, consulta la [Guía del usuario CloudWatch de Amazon Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).

Los registros de OpenSearch Ingestion pueden indicar un error en el procesamiento de las solicitudes, errores de autenticación desde el origen hasta el receptor y otras advertencias que pueden resultar útiles para solucionar problemas. Para sus registros, OpenSearch Ingestion utiliza los niveles de registro de`INFO`, `WARN``ERROR`, y. `FATAL` Recomendamos habilitar la publicación de registros en todas las canalizaciones.

## Permisos necesarios
<a name="monitoring-pipeline-logs-permissions"></a>

Para permitir que OpenSearch Ingestion envíe CloudWatch registros a Logs, debe iniciar sesión como usuario con determinados permisos de IAM. 

Necesita los siguientes permisos de CloudWatch registro para crear y actualizar los recursos de entrega de registros:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Resource": "*",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:PutResourcePolicy",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:DescribeResourcePolicies",
                "logs:GetLogDelivery",
                "logs:ListLogDeliveries"
            ]
        }
    ]
}
```

------

## Habilitación de la publicación de registros
<a name="monitoring-pipeline-logs-enable"></a>

Puede habilitar la publicación de registros en las canalizaciones existentes o mientras crea una canalización. Para ver los pasos para habilitar la publicación de registros durante la creación de la canalización, consulte [Creación de canalizaciones](creating-pipeline.md#create-pipeline).

### Consola
<a name="monitoring-pipeline-logs-enable-console"></a>

**Cómo habilitar la publicación de registros en una canalización existente**

1. Inicia sesión en la consola de Amazon OpenSearch Service en [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Estarás en la página de Pipelines.

1. Abra la canalización en la que desea habilitar los registros y, a continuación, seleccione **Acciones** y **Editar las opciones de publicación de registros**.

1. Habilita **Publicar en CloudWatch registros**.

1. Cree un grupo de registro nuevo o seleccione uno que ya exista. Se recomienda formatear el nombre como una ruta, por ejemplo`/aws/vendedlogs/OpenSearchIngestion/pipeline-name/audit-logs`. Este formato facilita la aplicación de una política de CloudWatch acceso que conceda permisos a todos los grupos de registros en una ruta específica, por ejemplo`/aws/vendedlogs/OpenSearchIngestion`.
**importante**  
Debe incluir el prefijo `vendedlogs` en el nombre del grupo de registro; de lo contrario, se producirá un error en la creación.

1. Seleccione **Save**.

### CLI
<a name="monitoring-pipeline-logs-enable-cli"></a>

Para habilitar la publicación de registros mediante el AWS CLI, envíe la siguiente solicitud:

```
aws osis update-pipeline \
  --pipeline-name my-pipeline \
  --log-publishing-options  IsLoggingEnabled=true,CloudWatchLogDestination={LogGroup="/aws/vendedlogs/OpenSearchIngestion/pipeline-name"}
```