En este documento se explica cómo ver las tareas y los trabajos de Batch.
Antes de empezar
- 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.
-
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 tus trabajos
Para ver tus trabajos, selecciona uno de los siguientes métodos:
Para ver todos los trabajos de tu proyecto, consulta la lista de tus trabajos.
Para ver todos los detalles de configuración de un trabajo específico, consulta los detalles de un trabajo.
Ver una lista de tus trabajos
Puedes ver una lista de las tareas del proyecto actual mediante laGoogle Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.
Consola
Para ver una lista de los trabajos del proyecto actual mediante la consola deGoogle Cloud , ve a la página Lista de trabajos.
La lista de tareas puede ocupar varias páginas. Si necesitas ir a la página siguiente, haz clic en
Siguiente en la parte inferior de la pantalla.Opcional: Si quieres filtrar la lista de trabajos, haz clic en
Filtrar. A continuación, escribe o selecciona una propiedad y un valor.Por ejemplo, para filtrar la lista de forma que solo se incluyan los trabajos de un estado específico, introduce lo siguiente:
Status:JOB_STATE
Sustituye
JOB_STATE
por un estado del trabajo, por ejemplo,FAILED
.
gcloud
Ver todas las tareas
Para ver una lista de las tareas del proyecto actual con gcloud CLI, usa el comando gcloud batch jobs list
.
gcloud batch jobs list
Ver una lista filtrada de trabajos
También puedes añadir una o varias marcas para ver una lista filtrada de ofertas de empleo:
Para ver solo los empleos de una ubicación específica, incluye la marca
--location
.Para ver solo los trabajos que coincidan con una expresión de filtro, especifica la marca
--filter
.
Por ejemplo, usa el siguiente comando:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Haz los cambios siguientes:
LOCATION
: la ubicación en la que se encuentran uno o varios puestos.FILTER_EXPRESSION
: una expresión de filtro que define los trabajos que quieres mostrar. La expresión de filtro debe definir uno o varios pares de propiedad y valor separados por cero o más operadores booleanos (AND
,OR
yNOT
).Por ejemplo, consulta las siguientes expresiones de filtro:
Filtrar por estado de la tarea: para ver solo las tareas que se encuentran en un estado específico, utilice la siguiente expresión de filtro:
status.state="JOB_STATE"
Sustituye
JOB_STATE
por un estado del trabajo, por ejemplo,FAILED
.Filtrar por etiquetas: Supongamos que en tu proyecto se han definido las siguientes etiquetas personalizadas:
Para indicar las tareas y sus recursos que ha creado tu equipo de investigación al consultar los informes de Facturación de Cloud, algunas de tus tareas y sus recursos tienen la etiqueta
team
definida comoresearch
.Para indicar las cargas de trabajo urgentes, algunos trabajos tienen una etiqueta
deadline
con varios valores.Para indicar los ejecutables que tu equipo de desarrollo ha probado correctamente, algunos ejecutables tienen una etiqueta
tested
con el valortrue
.
A continuación, puede especificar la siguiente expresión de filtro:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Esta expresión de filtro solo muestra los trabajos que cumplen todos los criterios siguientes:
Los trabajos del equipo de investigación que tienen la etiqueta
team
en la política de asignación del trabajo, que está definida comoresearch
.Trabajos que cumplan al menos uno de los siguientes criterios:
Los trabajos que tienen un plazo, que tienen la etiqueta
deadline
en el trabajo que se ha definido con cualquier valor.Tareas que tengan al menos un elemento ejecutable que se haya probado correctamente. Es decir, tareas que tengan al menos un elemento ejecutable con la etiqueta
tested
definida comotrue
.
API
Ver todas las tareas
Para ver una lista de trabajos del proyecto actual en una ubicación específica mediante la API Batch, haz una solicitud GET
al método jobs.list
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Haz los cambios siguientes:
PROJECT_ID
: el ID de proyecto de tu proyecto actual.LOCATION
: la ubicación donde se encuentran los trabajos.
Ver una lista filtrada de trabajos
También puede especificar el parámetro de consulta filter
para ver una lista filtrada de trabajos en función de una expresión de filtro.
Por ejemplo, haz la siguiente solicitud GET
:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Sustituye FILTER_EXPRESSION
por una expresión de filtro que use la codificación de URLs.
La expresión de filtro debe definir uno o varios pares de propiedad y valor separados por cero o más operadores booleanos (AND
, OR
y NOT
).
Por ejemplo, consulta las siguientes expresiones de filtro:
Filtrar por estado de la tarea: para ver solo las tareas que se encuentran en un estado específico, utilice la siguiente expresión de filtro:
status.state="JOB_STATE"
Sustituye
JOB_STATE
por un estado del trabajo, por ejemplo,FAILED
.Filtrar por etiquetas: Supongamos que en tu proyecto se han definido las siguientes etiquetas personalizadas:
Para indicar las tareas y sus recursos que ha creado tu equipo de investigación al consultar los informes de Facturación de Cloud, algunas de tus tareas y sus recursos tienen la etiqueta
team
definida comoresearch
.Para indicar las cargas de trabajo urgentes, algunos trabajos tienen una etiqueta
deadline
con varios valores.Para indicar los ejecutables que tu equipo de desarrollo ha probado correctamente, algunos ejecutables tienen una etiqueta
tested
con el valortrue
.
A continuación, puede especificar la siguiente expresión de filtro:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
Esta expresión de filtro solo muestra los trabajos que cumplen todos los criterios siguientes:
Los trabajos del equipo de investigación que tienen la etiqueta
team
en la política de asignación del trabajo, que está definida comoresearch
.Trabajos que cumplan al menos uno de los siguientes criterios:
Los trabajos que tienen un plazo, que tienen la etiqueta
deadline
en el trabajo que se ha definido con cualquier valor.Tareas que tengan al menos un elemento ejecutable que se haya probado correctamente. Es decir, tareas que tengan al menos un elemento ejecutable con la etiqueta
tested
definida comotrue
.
Go
Go
Para obtener más información, consulta la documentación de referencia de la API Batch Go.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la documentación de referencia de la API Batch Java.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Node.js
Para obtener más información, consulta la documentación de referencia de la API Batch Node.js.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API Batch Python.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la documentación de referencia de la API Batch C++.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Ver los detalles de un trabajo
Puedes ver los detalles de una tarea del proyecto actual mediante laGoogle Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.
Consola
Para ver los detalles de un trabajo del proyecto actual mediante la consolaGoogle Cloud , sigue estos pasos:
En la Google Cloud consola, ve a la página Lista de tareas.
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. Para obtener más información, haz clic en otras pestañas.
gcloud
Para ver los detalles de una tarea del proyecto actual con la CLI de gcloud, usa el comando gcloud batch jobs describe
con la marca --location
.
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 detalles de un trabajo del proyecto actual mediante la API Batch, haz una solicitud GET
al método jobs.get
.
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.
Go
Go
Para obtener más información, consulta la documentación de referencia de la API Batch Go.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la documentación de referencia de la API Batch Java.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Node.js
Para obtener más información, consulta la documentación de referencia de la API Batch Node.js.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API Batch Python.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la documentación de referencia de la API Batch C++.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Ver tareas
Para ver las tareas de uno de tus trabajos, selecciona uno de los siguientes métodos:
Para ver todas las tareas de un trabajo o de un grupo de tareas de un trabajo, consulta la lista de tareas de un trabajo.
Para ver todos los detalles de configuración de una tarea específica, consulta los detalles de una tarea.
Ver la lista de tareas de un trabajo
Puedes ver una lista de las tareas de un trabajo o del grupo de tareas de un trabajo mediante laGoogle Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.
Si quieres filtrar una lista de tareas de un trabajo o de un grupo de tareas de un trabajo (por ejemplo, para mostrar solo las tareas que se han completado correctamente), debes usar gcloud CLI o la API Batch.
Consola
Para ver un resumen de las tareas de un trabajo con la consolaGoogle Cloud , consulta los detalles de un trabajo para abrir la página Detalles del trabajo. A continuación, consulta la sección Detalles de la tarea.
gcloud
Para ver una lista de las tareas de un grupo de tareas de un trabajo con gcloud CLI, usa el comando gcloud batch tasks list
con las siguientes marcas:
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
Haz los cambios siguientes:
JOB_NAME
: el nombre de un trabajo.LOCATION
: la ubicación donde se encuentra el trabajo.
También puedes añadir la marca --filter
para ver una lista filtrada de tareas
en el grupo de tareas de un trabajo en función de una expresión de filtro.
Por ejemplo, usa el siguiente comando:
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
Sustituye FILTER_EXPRESSION
por una expresión de filtro.
Por ejemplo, puede especificar la siguiente expresión de filtro para ver solo las tareas de un grupo de tareas de un trabajo que se estén ejecutando o que se hayan completado correctamente:
STATE=RUNNING OR STATE=SUCCEEDED
API
Para ver una lista de tareas de un grupo de tareas de un trabajo mediante la API Batch, haz una solicitud GET
al método tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
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 del que quieres ver los detalles. El valor debe sergroup0
.
También puede especificar el parámetro de consulta filter
para ver una lista filtrada de tareas del grupo de tareas de un trabajo en función de una expresión de filtro.
Por ejemplo, haz la siguiente solicitud GET
:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
Sustituye FILTER_EXPRESSION
por una expresión de filtro que use la codificación de URLs.
Por ejemplo, puede especificar la siguiente expresión de filtro para ver solo las tareas de un grupo de tareas de un trabajo que se estén ejecutando o que se hayan completado correctamente:
STATE=RUNNING%20OR%20STATE=SUCCEEDED
Tenga en cuenta que la expresión de filtro codificada como URL representa la siguiente expresión de filtro decodificada:
STATE=RUNNING OR STATE=SUCCEEDED
Go
Go
Para obtener más información, consulta la documentación de referencia de la API Batch Go.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la documentación de referencia de la API Batch Java.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Node.js
Para obtener más información, consulta la documentación de referencia de la API Batch Node.js.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API Batch Python.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la documentación de referencia de la API Batch C++.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Ver los detalles de una tarea
Puedes ver los detalles de una tarea mediante laGoogle Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.
Consola
Para ver los detalles de una tarea con la consolaGoogle Cloud , consulta los detalles de un trabajo para abrir la página Detalles del trabajo. A continuación, consulta la sección Detalles de la tarea.
gcloud
Para ver los detalles de una tarea con la CLI de gcloud, usa el comando gcloud batch tasks describe
con las siguientes marcas:
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 índices0
,1
,2
y3
.TASK_GROUP_NAME
: el nombre del grupo de tareas que contiene la tarea de la que quieres ver los detalles. El valor debe sergroup0
.JOB_NAME
: el nombre de un trabajo.LOCATION
: la ubicación donde se encuentra el trabajo.
API
Para ver los detalles de una tarea mediante la API Batch, envía una solicitud GET
al método tasks.get
:
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 sergroup0
.TASK_INDEX
: el índice de la tarea de la que quieres ver los detalles. En un grupo de tareas, el índice de la tarea empieza 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 índices0
,1
,2
y3
.
Go
Go
Para obtener más información, consulta la documentación de referencia de la API Batch Go.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la documentación de referencia de la API Batch Java.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Node.js
Node.js
Para obtener más información, consulta la documentación de referencia de la API Batch Node.js.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API Batch Python.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la documentación de referencia de la API Batch C++.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local.
Siguientes pasos
Consulta información sobre la solución de problemas.
Consulta cómo monitorizar y analizar trabajos:
Monitoriza y optimiza los recursos de los trabajos consultando las métricas.
Si has configurado los registros de un trabajo, puedes analizarlo mediante los registros.
Si has configurado notificaciones de estado, puedes monitorizar un trabajo mediante notificaciones de Pub/Sub y analizar las notificaciones con BigQuery.
Consulta cómo gestionar trabajos: