Consulta el historial de un trabajo a través de eventos de estado

En este documento, se explica cómo ver los eventos de estado de los trabajos y las tareas de Batch. Los eventos de estado proporcionan un historial que puedes usar para analizar trabajos y, a menudo, contienen mensajes de error útiles que puedes usar para solucionar problemas.

Cada trabajo y cada una de sus tareas tienen eventos de estado que Batch crea automáticamente mientras se ejecuta el trabajo. Cada uno de estos eventos de estado describe un cambio de estado y detalles sobre por qué se alcanzó ese estado. Para obtener información sobre los estados de los trabajos y las tareas, consulta Ciclo de vida del trabajo. De manera opcional, también puedes configurar un trabajo para que tenga eventos de estado personalizados, que describen el progreso de los elementos ejecutables. Para obtener más información sobre los eventos de estado personalizados, consulta Cómo configurar eventos de estado personalizados.

Antes de comenzar

1. Si nunca usaste Batch, revisa Cómo comenzar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.

2. Para obtener los permisos que necesitas para ver trabajos y tareas, pídele a tu administrador que te otorgue el rol de IAM de visualizador de trabajos por lotes (roles/batch.jobsViewer) o editor de trabajos por lotes (roles/batch.jobsEditor) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

   También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Cómo ver eventos de estado

Pueden aparecer diferentes eventos de estado a nivel del trabajo (campo statusEvents[] del trabajo) y a nivel de la tarea (campo statusEvents[] de cada tarea).

En las siguientes instrucciones, se explica cómo ver los eventos de estado con laGoogle Cloud consola, gcloud CLI y la API de Batch. Para usar un lenguaje de biblioteca cliente, sigue los pasos para ver los detalles de un trabajo o ver los detalles de una tarea y, luego, consulta el campo statusEvents[] correspondiente.

Visualiza los eventos de estado de un trabajo

Console

Nota: La consola de Google Cloud solo muestra eventos de estado a nivel del trabajo.

Para ver los eventos de estado de un trabajo en el proyecto actual con la consola deGoogle Cloud , sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Lista de trabajos.

   Ir a la lista de trabajos

2. En la columna Nombre del trabajo, haz clic en el nombre de un trabajo.

   Se abrirá la página Detalles del trabajo.

   La pestaña Detalles se abre de forma predeterminada.

3. Haz clic en la pestaña Eventos.

gcloud

Para ver los eventos de estado de un trabajo con gcloud CLI, usa el comando gcloud batch jobs describe y, luego, consulta el campo statusEvents[].

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Reemplaza lo siguiente:

• JOB_NAME: Es el nombre de un trabajo existente.

• LOCATION: Es la ubicación en la que existe el trabajo.

API

Para ver los eventos de estado de un trabajo con la API de Batch, haz una solicitud GET al método jobs.get y, luego, consulta el campo statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del proyecto actual.

• LOCATION: Es la ubicación en la que existe el trabajo.

• JOB_NAME: Es el nombre de un trabajo existente.

Visualiza los eventos de estado de una tarea

gcloud

Para ver los eventos de estado de una tarea con gcloud CLI, usa el comando gcloud batch tasks describe y, luego, consulta el campo statusEvents[].

gcloud batch tasks describe TASK_INDEX \
  --location=LOCATION \
  --job=JOB_NAME \
  --task_group=TASK_GROUP_NAME

Reemplaza lo siguiente:

• TASK_INDEX: Es el índice de la tarea cuyos detalles deseas ver. En un grupo de tareas, el índice de la tarea comienza en 0 para la primera tarea y aumenta en 1 con cada tarea adicional. Por ejemplo, un grupo de tareas que contiene cuatro tareas tiene los índices 0, 1, 2 y 3.

• JOB_NAME: Es el nombre de un trabajo existente.

• LOCATION: Es la ubicación en la que existe el trabajo.

• TASK_GROUP_NAME: Es el nombre del grupo de tareas que contiene la tarea cuyos detalles deseas ver. El valor debe establecerse en group0.

API

Para ver los eventos de estado de una tarea con la API de Batch, realiza una solicitud GET al método tasks.get y, luego, consulta el campo statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del proyecto actual.

• LOCATION: Es la ubicación en la que existe el trabajo.

• JOB_NAME: Es el nombre de un trabajo existente.

• TASK_GROUP_NAME: Es el nombre del grupo de tareas que contiene la tarea cuyos detalles deseas ver. El valor debe establecerse en group0.

• TASK_INDEX: Es el índice de la tarea cuyos detalles deseas ver. En un grupo de tareas, el índice de la tarea comienza en 0 para la primera tarea y aumenta en 1 con cada tarea adicional. Por ejemplo, un grupo de tareas que contiene cuatro tareas tiene los índices 0, 1, 2 y 3.

¿Qué sigue?

• Para comprender los eventos de estado de Batch que describen errores, consulta Solución de problemas.

• Si deseas un historial más detallado de tu trabajo, como eventos de estado para cuando se inician y finalizan los ejecutables, configura eventos de estado personalizados.

• Aprende a analizar un trabajo con registros.