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 Batch trabajos y tareas. Los eventos de estado proporcionan un historial que puede utilizar para analizar trabajos y, a menudo, contienen mensajes de error útiles que puedes usar y la solución de problemas.

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

Antes de comenzar

Ver eventos de estado

A nivel del trabajo, pueden aparecer diferentes eventos de estado (Campo statusEvents[] para el trabajo) y a nivel de la tarea (Campo statusEvents[] para cada tarea).

En las siguientes instrucciones, se explica cómo ver los eventos de estado con la la consola de Google Cloud, gcloud CLI y la API de Batch. Si deseas 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.

Consulta los eventos de estado de un trabajo

Console

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

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

    Ir a 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 el gcloud CLI, usa el Comando gcloud batch jobs describe, y, luego, verás 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. dónde existe el trabajo.

API

Para ver los eventos de estado de un trabajo con el API de Batch, realiza una solicitud GET al Método jobs.get, y, luego, verás el campo statusEvents[].

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto del proyecto actual.

  • LOCATION: Es la ubicación. dónde 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 la Comando gcloud batch tasks describe, y, luego, verás el campo statusEvents[].

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

Reemplaza lo siguiente:

  • TASK_INDEX: El índice de la tarea que deseas ver los detalles. En un grupo de tareas, el índice de tareas comienza en 0 para la primera tarea y aumenta en 1 con cada tarea adicional. Por ejemplo, una tarea 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 de que el trabajo exista.

  • TASK_GROUP_NAME: Es el nombre del grupo de tareas que contiene la tarea de la que deseas ver los detalles. El valor debe ser Se establece en group0.

API

Para ver los eventos de estado de una tarea con la API de Batch, haz lo siguiente: realiza una solicitud GET al Método tasks.get, y, luego, verás 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: el ID del proyecto del proyecto actual.

  • LOCATION: Es la ubicación. dónde 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 de la que deseas ver los detalles. El valor debe ser Se establece en group0.

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

¿Qué sigue?