

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 de CloudWatch métricas con AWS Batch
<a name="using_cloudwatch_metrics"></a>

AWS Batch publica métricas de empleos en Amazon CloudWatch para monitorear las transiciones de estado y la duración de los trabajos a medida que avanzan en su ciclo de vida. AWS Batch publica estas métricas en el espacio de `AWS/Batch` nombres sin coste adicional.

Las métricas se emiten a medida que los trabajos pasan de un estado a otro y a medida que se completan los intentos de trabajo. Las métricas de transición estatal registran cuántos empleos ingresaron en un estado determinado, y las métricas de duración registran cuánto tiempo pasaron los trabajos o intentos de trabajo moviéndose de un estado a otro. Usa estas métricas para crear CloudWatch paneles, configurar CloudWatch alarmas y establecer puntos de referencia de rendimiento para tus cargas de trabajo. Para obtener más información, consulte [ Uso de CloudWatch métricas ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) y [ Uso de CloudWatch alarmas ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la Guía del * usuario de Amazon. CloudWatch *

El comportamiento de generación de informes de [Trabajos de matrices](array_jobs.md) los trabajos de un solo nodo [Multi-node trabajos paralelos](multi-node-parallel-jobs.md) es diferente al suyo. En la ** columna sobre el comportamiento de los ** informes de la tabla siguiente se indican estos casos y se [Métricas para trabajos de matrices y trabajos paralelos de varios nodos](#cloudwatch_metrics_array_mnp) describe detalladamente el comportamiento de las matrices y los MNP.

**nota**  
AWS Batch emite estas métricas para los trabajos enviados a una cola de trabajos. Todas las métricas se publican con la `JobQueueName` dimensión. Puede usar esta dimensión para agrupar y filtrar los datos de las métricas según la cola de trabajos a la que se envió un trabajo.

**importante**  
Estas métricas se proporcionan en la medida de lo posible y están destinadas a la supervisión y la observabilidad, en lugar de a la facturación, la auditoría o la conciliación. Dado que las transiciones entre los estados de los trabajos están impulsadas por eventos, es posible que, en ocasiones, se omita una métrica. Por ejemplo, si un trabajo comienza a ejecutarse y, a continuación, se ejecuta correctamente o falla casi de inmediato, es posible que la transición al `RUNNING` estado no se observe antes de que el trabajo alcance su estado terminal. En ese caso, AWS Batch no emite las métricas asociadas a la `RUNNING` transición para ese trabajo. Diseñe las alarmas o los paneles de forma que toleren las brechas ocasionales y no se base en los recuentos exactos derivados de estas métricas.

## AWS Batch CloudWatch métricas
<a name="cloudwatch_metrics_available"></a>

AWS Batch envía las siguientes métricas de trabajo a CloudWatch. Las métricas de transición de estado utilizan la `Count` unidad y las métricas de duración utilizan la `Milliseconds` unidad.

Las siguientes métricas se aplican a los AWS Batch trabajos independientemente del tipo.


| Métrica | Description (Descripción) | Unidades | Notificación de comportamiento | 
| --- | --- | --- | --- | 
| `JobsSubmitted` | El número de trabajos que se enviaron a la cola de trabajos. | Recuento | Se emite cuando se envía un trabajo por primera vez (entra en el `SUBMITTED` estado). Para un trabajo de matriz, el valor es el tamaño de la matriz. | 
| `JobsMovedToPending` | La cantidad de trabajos que se mudaron al `PENDING` estado. | Recuento | Se emite cuando un trabajo se traslada a`PENDING`. Por lo general`PENDING`, un trabajo está en espera de una dependencia del trabajo. | 
| `JobsMovedToRunnable` | La cantidad de empleos que se mudaron al `RUNNABLE` estado. | Recuento | Se emite cuando un trabajo se traslada`RUNNABLE`, ya sea por primera vez o como resultado de un reintento. | 
| `JobsMovedToStarting` | La cantidad de empleos que se trasladaron al `STARTING` estado. | Recuento | Se emite cuando un trabajo se traslada a`STARTING`. | 
| `JobsMovedToRunning` | La cantidad de empleos que se mudaron al `RUNNING` estado. | Recuento | Se emite cuando un trabajo se traslada a`RUNNING`. | 
| `JobsMovedToSucceeded` | El número de trabajos que se completaron correctamente. | Recuento | Se emite cuando un trabajo se traslada a`SUCCEEDED`. | 
| `JobsMovedToFailed` | La cantidad de empleos que se mudaron al `FAILED` estado. | Recuento | Se emite cuando un trabajo entra en el `FAILED` estado. Incluye los trabajos que se cancelaron o terminaron. | 
| `JobsCancelled` | El número de trabajos que se cancelaron. | Recuento | Se emite cuando un trabajo entra en el `FAILED` estado como resultado de una solicitud de cancelación (antes de que el trabajo comience a ejecutarse). | 
| `JobsTerminated` | El número de trabajos que se cancelaron. | Recuento | Se emite cuando un trabajo entra en `FAILED` estado como resultado de una solicitud de finalización. | 
| `JobsRetried` | El número de intentos de trabajo que se reintentaron. | Recuento | Se emite cuando un intento de trabajo falla y el trabajo vuelve `RUNNABLE` a intentarlo. | 
| `JobSubmittedToRunnableDuration` | El tiempo que tardó un trabajo en pasar de `SUBMITTED` a`RUNNABLE`. | Milisegundos | Se emite cuando entra el trabajo`RUNNABLE`. En el caso de un trabajo secundario de matriz, mide el tiempo transcurrido desde que se envió el trabajo principal hasta que se convirtió en el trabajo secundario`RUNNABLE`. | 
| `JobAttemptStartingToRunningDuration` | El tiempo que pasó un intento de trabajo `STARTING` antes de que comenzara a ejecutarse. | Milisegundos | Se emite por intento cuando se inicia el trabajo`RUNNING`. Un trabajo reintentado emite un punto de datos por cada intento que alcanza. `RUNNING` | 
| `JobAttemptExecutionDuration` | El tiempo que pasó ejecutándose un intento de trabajo, medido desde el momento en que comenzó hasta el momento en que se detuvo. | Milisegundos | Se emite cuando se completa un intento de trabajo y se mide desde el momento en que el intento comenzó a ejecutarse hasta el momento en que se detuvo. | 
| `JobAttemptDuration` | El tiempo total que duró un intento de trabajo, medido desde el momento en que entró `STARTING` hasta que finalizó el intento. | Milisegundos | Se emite cuando finaliza un intento. El intento finaliza cuando el trabajo alcanza un estado terminal (`SUCCEEDED`o`FAILED`) o cuando vuelve `RUNNABLE` a intentarlo. | 

Las siguientes métricas solo se aplican a los trabajos de AWS Batch procesamiento.


| Métrica | Description (Descripción) | Unidades | Notificación de comportamiento | 
| --- | --- | --- | --- | 
| `JobSubmittedToFirstStartingDuration` | El tiempo que tardó un trabajo en pasar `SUBMITTED` a su primera entrada`STARTING`. | Milisegundos | Se emite en el primer intento, cuando el trabajo entra por primera vez`STARTING`.  | 
| `JobAttemptRunnableToStartingDuration` | El tiempo que tardó un intento de trabajo `RUNNABLE` antes de que comenzara. | Milisegundos | Se emite cuando se inicia el trabajo`STARTING`. | 

Las siguientes métricas se aplican únicamente a[Empleos de servicio en AWS Batch](service-jobs.md).


| Métrica | Description (Descripción) | Unidades | Notificación de comportamiento | 
| --- | --- | --- | --- | 
| `JobsMovedToScheduled` | La cantidad de empleos que se mudaron al `SCHEDULED` estado. | Recuento | Se emite para los trabajos de servicio cuando el trabajo se traslada por primera vez y se emite nuevamente cada vez que el trabajo se traslada `SCHEDULED` después de una preferencia. `SCHEDULED` | 
| `JobSubmittedToFirstScheduledDuration` | El tiempo que tardó en llegar un trabajo de servicio `SUBMITTED` a su primera vez. `SCHEDULED` | Milisegundos | Se emite para trabajos de servicio cuando el trabajo se traslada por primera vez a`SCHEDULED`. | 
| `JobAttemptRunnableToScheduledDuration` | El tiempo que duró un intento de trabajo `RUNNABLE` antes de pasar a`SCHEDULED`. | Milisegundos | Se emite por intento cuando se traslada un trabajo de servicio`SCHEDULED`, tanto la primera vez que se traslada el trabajo como cada vez que se traslada `SCHEDULED` después de una preferencia. `SCHEDULED` | 
| `JobAttemptScheduledToStartingDuration` | El tiempo que transcurre en un intento de trabajo de servicio entre la primera vez que se traslada `SCHEDULED` y el momento en que se traslada. `STARTING` | Milisegundos | Se emite para trabajos de servicio cuando el trabajo pasa de `SCHEDULED` a`STARTING`. | 
| `JobsPreempted` | El número de trabajos a los que se ha dado prioridad. | Recuento | Se emite para los trabajos de administración de cuotas cada vez que se reemplaza el trabajo. | 

## Métricas para trabajos de matrices y trabajos paralelos de varios nodos
<a name="cloudwatch_metrics_array_mnp"></a>

AWS Batch representa [Trabajos de matrices](array_jobs.md) y [Multi-node trabajos paralelos](multi-node-parallel-jobs.md) como un * trabajo * principal que rastrea uno o más * trabajos * secundarios. Para que un solo trabajo lógico no se cuente dos veces, AWS Batch emite métricas de solo uno de estos dos registros, según el tipo de trabajo.

Trabajos de matrices  
La tarea principal de la matriz no emite métricas, a excepción de`JobsSubmitted`. En cambio, cada trabajo secundario de matriz emite estas métricas de forma independiente a medida que avanza en el ciclo de vida del trabajo, por lo que los recuentos de métricas reflejan el número de trabajos secundarios en lugar del número de trabajos de matriz enviados.  
La `JobsSubmitted` métrica se emite una vez para el trabajo principal de la matriz en el momento de la presentación, y su valor es el tamaño de la matriz (la cantidad de trabajos secundarios). Por ejemplo, al enviar un trabajo de matriz con 1000 elementos secundarios, se publica un único punto de `JobsSubmitted` datos con un valor de`1000`.  
Las métricas de duración que miden el tiempo transcurrido desde el envío (por ejemplo`JobSubmittedToRunnableDuration`) se emiten por trabajo secundario de la matriz y miden desde el momento en que se envió la matriz principal hasta el momento en que ese hijo alcanzó el estado en cuestión.

Multi-node trabajos paralelos (MNP)  
Las métricas del MNP provienen del trabajo principal del MNP, que representa el trabajo en su conjunto. Los trabajos secundarios (nodos) individuales del MNP no emiten estas métricas. Como resultado, un trabajo de MNP se cuenta una vez, independientemente del número de nodos que utilice.

## Dimensiones para AWS Batch CloudWatch métricas
<a name="cloudwatch_metrics_dimensions"></a>

AWS Batch métricas de trabajo en CloudWatch uso de una sola dimensión:`JobQueueName`. Todos los datos métricos se agrupan y filtran por el nombre de la cola de trabajos a la que se envió un trabajo.

## Visualización AWS Batch CloudWatch métricas
<a name="viewing-batch-cloudwatch-metrics"></a>

Puedes ver las métricas de los AWS Batch trabajos en la AWS Batch consola o en la CloudWatch consola, en el espacio de `AWS/Batch` nombres.

**importante**  
La visualización de las métricas en la consola conlleva gastos estándar CloudWatch . Puedes desactivar la visualización de las métricas en cualquier momento para detener los cargos. Para obtener más información, consulta los CloudWatch precios de [ Amazon](https://aws.amazon.com/cloudwatch/pricing/).

**Para ver las métricas en el panel de métricas por lotes **

1. Abra la [consola de AWS Batch](https://console.aws.amazon.com/batch).

1. En el panel de navegación, selecciona ** Panel de control ** y, a continuación, elige la ** pestaña de métricas ** por lotes.

1. Activa ** Mostrar CloudWatch métricas**.

1. En ** Filtrar métricas**, selecciona hasta cinco colas de ** trabajos ** y las ** métricas ** que quieres graficar.

1. Selecciona ** Aplicar filtros**. La consola muestra un gráfico por métrica, con una línea por cola de trabajos.

1. Para volver a empezar, elija ** Borrar filtros ** para eliminar sus selecciones o ** Restablecer filtros ** para restaurar los valores predeterminados.

1. (Opcional) Para reutilizar una combinación de colas de trabajos y métricas, utilice un conjunto de filtros guardado. Los conjuntos de filtros se guardan según tus preferencias de AWS usuario, por lo que permanecen en todas las sesiones, y puedes guardar hasta cinco. Gestiónalos desde el menú ** desplegable Conjuntos de filtros ** guardados y desde el menú de flechas del ** botón ** Borrar filtros y, a continuación, selecciona una de las siguientes opciones:
   + **Guardar**: selecciona las colas de trabajos y las métricas y, a continuación, selecciona ** Guardar como nuevo conjunto de filtros. ** Introduzca un nombre único y, si lo desea, márquelo como predeterminado.
   + **Aplicar**: elige un conjunto en el ** menú desplegable Conjuntos de filtros ** guardados y, a continuación, selecciona ** Aplicar filtros**.
   + **Actualizar**: con un conjunto seleccionado, cambia tus selecciones y elige ** Actualizar el conjunto ** de filtros actual.
   + **Establecer como predeterminado**: con un conjunto seleccionado, elige ** Configuración y**, a continuación, ** Establecer como predeterminado**. El conjunto predeterminado se carga automáticamente al abrir la pestaña.
   + **Eliminar**: con un conjunto seleccionado, elija ** Eliminar el conjunto de filtros actual**.

**Para ver las métricas de una sola cola de trabajos **

1. En el panel de navegación, selecciona Colas de ** trabajos y, a continuación**, elige una cola de trabajos.

1. Elija la pestaña **Monitorización**.

1. Activa ** Mostrar métricas. CloudWatch **

1. En las ** secciones ** Métricas de transición de ** estados**, métricas de eventos del ** ciclo de vida y métricas de ** duración, usa cada selector de métricas para elegir qué métricas representar gráficamente.

Las métricas que se muestran corresponden a esta cola de trabajos. Sus selecciones se guardan por cola de trabajos y se mantienen en todas las sesiones.

Para trabajar directamente con estas métricas CloudWatch (por ejemplo, para crear paneles o configurar alarmas), abre la [ CloudWatch consola ](https://console.aws.amazon.com/cloudwatch) y elige el `AWS/Batch` espacio de nombres.