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. # Uso del controlador de registros awslogs De forma predeterminada, AWS Batch permite que el controlador de `awslogs` registro envíe información de registro a CloudWatch Logs. Puede usar esta característica para ver distintos registros desde sus contenedores en una ubicación cómoda y evitar que los registros de contenedor ocupen espacio en disco en sus instancias de contenedor. Este tema le ayuda a configurar el controlador de registro `awslogs` en sus definiciones de trabajo. **nota** En la AWS Batch consola, puede configurar el controlador de `awslogs` registro en la sección **Configuración de registros** al crear una definición de trabajo. **nota** El tipo de información que registran los contenedores del trabajo depende en gran medida del comando `ENTRYPOINT`. De forma predeterminada, los registros que se capturan muestran el resultado del comando que normalmente se ve en una terminal interactiva si se ejecuta el contenedor de forma local, que son las `STDERR` I/O transmisiones `STDOUT` y. El controlador de `awslogs` registros simplemente pasa estos registros de Docker a CloudWatch Logs. Para obtener más información acerca de cómo se procesan los registros de Docker, incluidas formas alternativas de capturar diferentes datos de archivo o flujos, consulte la página sobre cómo [Ver los registros de un contenedor o servicio](https://docs.docker.com/config/containers/logging/) en la documentación de Docker. Para enviar los registros del sistema de sus instancias de contenedor a CloudWatch Logs, consulte[Uso CloudWatch de registros con AWS Batch](using_cloudwatch_logs.md). Para obtener más información sobre CloudWatch los registros, consulte [Supervisión de los archivos de registro](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) y [las cuotas de CloudWatch registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) en la *Guía del usuario de Amazon CloudWatch Logs*. ## opciones del controlador de registro de awslogs en el tipo de datos AWS Batch JobDefiniton El controlador de `awslogs` registro admite las siguientes opciones en las definiciones de AWS Batch trabajos. Para obtener más información, consulte el [controlador de registro de CloudWatch registros](https://docs.docker.com/config/containers/logging/awslogs/) en la documentación de Docker. `awslogs-region` Obligatorio: no Especifique la región a la que el controlador de registros `awslogs` debe enviarle sus registros de Docker. De forma predeterminada, la región que se utiliza es la misma que la del trabajo. Puede optar por enviar todos los registros de los trabajos de distintas regiones a una sola región en CloudWatch los registros. De este modo, podrá verlos todos desde una misma ubicación. Como alternativa, puede separarlos por región para obtener un enfoque más detallado. Sin embargo, cuando elija esta opción, asegúrese de que los grupos de registro especificados existan en la región que especifique. `awslogs-group` Obligatorio: opcional Con la opción de `awslogs-group`, puede especificar el grupo de registro al que el controlador de registro `awslogs` envía sus flujos de registro. Si esto campo no está especificado, se utiliza `aws/batch/job`. `awslogs-stream-prefix` Obligatorio: opcional Con `awslogs-stream-prefix` esta opción, puede asociar un flujo de registro al prefijo especificado y al ID de tarea de Amazon ECS del AWS Batch trabajo al que pertenece el contenedor. Si especifica un prefijo con esta opción, entonces el flujo de registros adopta el siguiente formato: ``` prefix-name/default/ecs-task-id ``` `awslogs-datetime-format` Obligatorio: no Esta opción define un patrón de inicio de varias líneas en formato `strftime` de Python. Un mensaje de registro consta de una línea que coincide con el patrón y de líneas siguientes que no coinciden con el patrón. Por tanto, la línea coincidente es el delimitador entre los mensajes de registro. Un ejemplo de caso de uso de este formato es para analizar la salida como un volcado de pila, que de lo contrario podría registrarse en varias entradas. El patrón correcto permite capturarla en una sola entrada. Para obtener más información, consulte [awslogs-datetime-format](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-datetime-format). Esta opción siempre tiene prioridad si ambos `awslogs-datetime-format` y `awslogs-multiline-pattern` están configurados. El registro de varias líneas realiza análisis de las expresiones regulares y correspondencia de todos los mensajes de registro. Esto puede tener un impacto negativo sobre el rendimiento de registro. `awslogs-multiline-pattern` Obligatorio: no Esta opción define un patrón de inicio de varias líneas con una expresión regular. Un mensaje de registro consta de una línea que coincide con el patrón y de líneas siguientes que no coinciden con el patrón. Por tanto, la línea coincidente es el delimitador entre los mensajes de registro. Para obtener más información, consulte [awslogs-multiline-pattern](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-multiline-pattern)la documentación de Docker. Esta opción se pasa por alto si también se ha configurado `awslogs-datetime-format`. El registro de varias líneas realiza análisis de las expresiones regulares y correspondencia de todos los mensajes de registro. Esto puede tener un impacto negativo sobre el rendimiento de registro. `awslogs-create-group` Obligatorio: no Especifique si desea que el grupo de registros se cree automáticamente. Si no se especifica esta opción, el valor predeterminado es `false`. No se recomienda esta opción. Le recomendamos que cree el grupo de CloudWatch registros con antelación mediante la acción de la [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)API Logs, ya que cada trabajo intenta crear el grupo de registros, lo que aumenta las probabilidades de que el trabajo falle. Su política de IAM para la ejecución de rol debe incluir el permiso `logs:CreateLogGroup` antes de intentar utilizar `awslogs-create-group`. ## Especificación de una configuración de registro en la definición de trabajo De forma predeterminada, AWS Batch habilita el controlador de `awslogs` registro. En esta sección, se describe cómo personalizar la configuración de registro `awslogs` de un trabajo. Para obtener más información, consulte [Creación de una definición de trabajo de un solo nodo](create-job-definition.md). Los siguientes fragmentos de JSON de configuración de registro tienen un objeto `logConfiguration` especificado para cada trabajo. Una es para un WordPress trabajo que envía registros a un grupo de registros llamado `awslogs-wordpress` y otra es para un contenedor MySQL que envía registros a un grupo de registros llamado`awslogs-mysql`. Ambos contenedores utilizan el prefijo de flujo de registros `awslogs-example`. ``` "logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-group": "awslogs-wordpress", "awslogs-stream-prefix": "awslogs-example" } } ``` ``` "logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-group": "awslogs-mysql", "awslogs-stream-prefix": "awslogs-example" } } ``` En la AWS Batch consola, se especifica la configuración de registro para la definición del `wordpress` trabajo, como se muestra en la imagen siguiente. ![\[Log configuration interface showing awslogs driver with group and stream prefix options.\]](http://docs.aws.amazon.com/es_es/batch/latest/userguide/images/awslogs-console-config.png) Tras registrar una definición de tarea con el controlador de `awslogs` registro en una configuración de registro de definición de trabajos, puede enviar un trabajo con esa definición de trabajo para empezar a enviar CloudWatch registros a Logs. Para obtener más información, consulte [Tutorial: envío de un trabajo](submit_job.md).