Ver 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 las tareas y los trabajos por lotes. Los eventos de estado proporcionan un historial que puede usar para analizar trabajos y, a menudo, contienen mensajes de error útiles que puede 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 los detalles sobre por qué se ha alcanzado ese estado. Para obtener información sobre los estados de los trabajos y las tareas, consulta Ciclo de vida de los trabajos. También puede 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, consulte Configurar eventos de estado personalizados.

Antes de empezar

  1. Si no has usado Batch antes, consulta el artículo Empezar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.

  2. Para obtener los permisos que necesitas para ver los trabajos y las tareas, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Lector de trabajos de Batch (roles/batch.jobsViewer) o Editor de trabajos de Batch (roles/batch.jobsEditor) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Ver eventos de estado

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

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

Ver los eventos de estado de un trabajo

Consola

Para ver los eventos de estado de un trabajo del proyecto actual mediante la consolaGoogle Cloud , sigue estos pasos:

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

    Ir a la lista de tareas

  2. En la columna Nombre del trabajo, haga 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. Haga clic en la pestaña Eventos.

gcloud

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

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Haz los cambios siguientes:

  • JOB_NAME: el nombre de un trabajo.

  • LOCATION: la ubicación donde se encuentra el trabajo.

API

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

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del proyecto actual.

  • LOCATION: la ubicación donde se encuentra el trabajo.

  • JOB_NAME: el nombre de un trabajo.

Ver los eventos de estado de una tarea

gcloud

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

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

Haz los cambios siguientes:

  • TASK_INDEX: el índice de la tarea de la que quieres ver los detalles. En un grupo de tareas, el índice de tareas empieza por 0 en 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: el nombre de un trabajo.

  • LOCATION: la ubicación donde se encuentra el trabajo.

  • TASK_GROUP_NAME: el nombre del grupo de tareas que contiene la tarea de la que quieres ver los detalles. El valor debe ser group0.

API

Para ver los eventos de estado de una tarea mediante la API Batch, haz una solicitud GET al método tasks.get y, a continuación, 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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del proyecto actual.

  • LOCATION: la ubicación donde se encuentra el trabajo.

  • JOB_NAME: el nombre de un trabajo.

  • TASK_GROUP_NAME: el nombre del grupo de tareas que contiene la tarea de la que quieres ver los detalles. El valor debe ser group0.

  • TASK_INDEX: el índice de la tarea de la que quieres ver los detalles. En un grupo de tareas, el índice de tareas empieza por 0 en 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.

Siguientes pasos