Questo documento spiega come visualizzare le attività e i job batch.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta Inizia a utilizzare Batch e abilita Batch completando i prerequisiti per progetti e utenti.
-
Per ottenere le autorizzazioni necessarie per visualizzare job e attività, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore job batch (
roles/batch.jobsViewer
) o Editor job batch (roles/batch.jobsEditor
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Visualizza le tue offerte di lavoro
Per visualizzare i job, seleziona uno dei seguenti metodi:
Per visualizzare tutti i job nel progetto, visualizza un elenco dei tuoi job.
Per vedere tutti i dettagli di configurazione di un job specifico, visualizza i dettagli di un job.
Visualizzare un elenco delle offerte di lavoro
Puoi visualizzare un elenco di job nel progetto corrente utilizzando la console Google Cloud, gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare un elenco dei job nel progetto corrente utilizzando la console Google Cloud, vai alla pagina Elenco job.
L'elenco dei job potrebbe essere composto da più pagine. Se devi passare alla pagina successiva, fai clic su
Avanti nella parte inferiore dello schermo.(Facoltativo) Se vuoi filtrare l'elenco dei job, fai clic su
Filtra. Poi digita o seleziona una proprietà e un valore.Ad esempio, per filtrare l'elenco in modo che includa solo i job in uno stato specifico, inserisci quanto segue:
Status:JOB_STATE
Sostituisci
JOB_STATE
con uno stato job, ad esempioFAILED
.
gcloud
Visualizza tutti i job
Per visualizzare un elenco dei job nel progetto attuale utilizzando gcloud CLI, utilizza il comando gcloud batch jobs list
.
gcloud batch jobs list
Visualizza un elenco filtrato di job
Facoltativamente, puoi aggiungere uno o più flag per visualizzare un elenco filtrato di job:
Per visualizzare solo le offerte di lavoro in una località specifica, includi il flag
--location
.Per visualizzare solo i job in base a un'espressione di filtro, specifica il flag
--filter
.
Ad esempio, utilizza il seguente comando:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Sostituisci quanto segue:
LOCATION
: la località in cui esistono uno o più job.FILTER_EXPRESSION
: un'espressione di filtro che definisce i job da elencare. L'espressione di filtro deve definire una o più coppie proprietà-valore separate da zero o più operatori booleani (AND
,OR
eNOT
).Ad esempio, vedi le seguenti espressioni di filtro:
Filtra in base allo stato del job: per visualizzare solo i job in uno stato specifico, utilizza la seguente espressione di filtro:
status.state="JOB_STATE"
Sostituisci
JOB_STATE
con uno stato job, ad esempioFAILED
.Filtra in base a etichette: supponi che il progetto abbia definito le seguenti etichette personalizzate:
Per indicare i job e le relative risorse creati dal tuo team di ricerca quando visualizzi i report di fatturazione Cloud, alcuni dei job e le relative risorse hanno un'etichetta
team
impostata suresearch
.Per indicare carichi di lavoro sensibili al tempo, alcuni job hanno un'etichetta
deadline
, impostata su vari valori.Per indicare gli elementi eseguibili testati correttamente dal team di sviluppo, alcuni hanno un'etichetta
tested
impostata sutrue
.
Successivamente, puoi specificare la seguente espressione di filtro:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Questa espressione di filtro elenca solo i job che soddisfano tutti i seguenti criteri:
Job appartenenti al team di ricerca, che hanno un'etichetta
team
nel criterio di allocazione del job impostato suresearch
.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadline
sul job impostata su qualsiasi valore.I job con almeno un eseguibile che è stato testato correttamente, ovvero job per i quali almeno uno eseguibile con un'etichetta
tested
impostata sutrue
.
API
Visualizza tutti i job
Per visualizzare un elenco di job nel progetto attuale per una località specifica utilizzando
l'API Batch, effettua una richiesta GET
al
metodo jobs.list
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto corrente.LOCATION
: la località in cui si trovano i job.
Visualizza un elenco filtrato di job
Facoltativamente, puoi specificare il parametro di query filter
per visualizzare un elenco filtrato di job in base a un'espressione di filtro.
Ad esempio, effettua la seguente richiesta GET
:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Sostituisci FILTER_EXPRESSION
con un'espressione di filtro che utilizza la codifica degli URL.
L'espressione di filtro deve definire una o più coppie proprietà-valore separate da zero o più operatori booleani (AND
, OR
e NOT
).
Ad esempio, vedi le seguenti espressioni di filtro:
Filtra in base allo stato del job: per visualizzare solo i job in uno stato specifico, utilizza la seguente espressione di filtro:
status.state="JOB_STATE"
Sostituisci
JOB_STATE
con uno stato job, ad esempioFAILED
.Filtra in base a etichette: supponi che il progetto abbia definito le seguenti etichette personalizzate:
Per indicare i job e le relative risorse creati dal tuo team di ricerca quando visualizzi i report di fatturazione Cloud, alcuni dei job e le relative risorse hanno un'etichetta
team
impostata suresearch
.Per indicare carichi di lavoro sensibili al tempo, alcuni job hanno un'etichetta
deadline
, impostata su vari valori.Per indicare gli elementi eseguibili testati correttamente dal team di sviluppo, alcuni hanno un'etichetta
tested
impostata sutrue
.
Successivamente, puoi specificare la seguente espressione di filtro:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
Questa espressione di filtro elenca solo i job che soddisfano tutti i seguenti criteri:
Job appartenenti al team di ricerca, che hanno un'etichetta
team
nel criterio di allocazione del job impostato suresearch
.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadline
sul job impostata su qualsiasi valore.I job con almeno un eseguibile che è stato testato correttamente, ovvero job per i quali almeno uno eseguibile con un'etichetta
tested
impostata sutrue
.
Go
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i dettagli di un job
Puoi visualizzare i dettagli di un job nel progetto corrente utilizzando la console Google Cloud, gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare i dettagli di un job nel progetto attuale utilizzando la console Google Cloud, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Elenco job.
Nella colonna Nome job, fai clic sul nome di un job.
Si apre la pagina Dettagli job.
La scheda Dettagli è aperta per impostazione predefinita. Per saperne di più, fai clic su altre schede.
gcloud
Per visualizzare i dettagli di un job nel progetto corrente utilizzando gcloud CLI, utilizza il comando gcloud batch jobs describe
con il flag --location
.
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
Sostituisci quanto segue:
JOB_NAME
: il nome di un job esistente.LOCATION
: la località in cui si trova il job.
API
Per visualizzare i dettagli di un job nel progetto corrente utilizzando
l'API Batch, effettua una richiesta GET
al
metodo jobs.get
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto corrente.LOCATION
: la località in cui si trova il job.JOB_NAME
: il nome di un job esistente.
Go
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizza le attività
Per visualizzare le attività per uno dei tuoi job, seleziona uno dei seguenti metodi:
Per visualizzare tutte le attività in un job o nel gruppo di attività di un job, visualizza un elenco delle attività di un job.
Per vedere tutti i dettagli di configurazione di un'attività specifica, visualizza i dettagli di un'attività.
Visualizza un elenco delle attività di un lavoro
Puoi visualizzare un elenco delle attività in un job o in un gruppo di attività di un job utilizzando la console Google Cloud, gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Se vuoi filtrare un elenco di attività in un job o in un gruppo di attività di un job, ad esempio per elencare solo le attività terminate correttamente in esecuzione, devi utilizzare gcloud CLI o l'API Batch.
Console
Per visualizzare un riepilogo delle attività di un job utilizzando la console Google Cloud, visualizza i dettagli di un job per aprire la pagina Dettagli job. Quindi, consulta la sezione Dettagli attività.
gcloud
Per visualizzare un elenco delle attività in un gruppo di attività di un job utilizzando gcloud CLI, utilizza il comando gcloud batch tasks list
con i seguenti flag:
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
Sostituisci quanto segue:
JOB_NAME
: il nome di un job esistente.LOCATION
: la località in cui si trova il job.
Se vuoi, puoi aggiungere il flag --filter
per visualizzare un elenco filtrato di attività in un gruppo di attività di un job in base a un'espressione di filtro.
Ad esempio, utilizza il seguente comando:
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
Sostituisci FILTER_EXPRESSION
con un'espressione di filtro.
Ad esempio, puoi specificare la seguente espressione di filtro per visualizzare solo le attività di un gruppo di attività di un job in esecuzione o che sono state eseguite correttamente:
STATE=RUNNING OR STATE=SUCCEEDED
API
Per visualizzare un elenco di attività in un gruppo di attività di un job utilizzando
l'API Batch, effettua una richiesta GET
al
metodo tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto corrente.LOCATION
: la località in cui si trova il job.JOB_NAME
: il nome di un job esistente.TASK_GROUP_NAME
: il nome del gruppo di attività di cui vuoi visualizzare i dettagli. Il valore deve essere impostato sugroup0
.
Se vuoi, puoi specificare il parametro di query filter
per visualizzare un elenco filtrato di attività in un gruppo di attività di un job in base a un'espressione di filtro.
Ad esempio, effettua la seguente richiesta GET
:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
Sostituisci FILTER_EXPRESSION
con un'espressione di filtro che utilizza la codifica degli URL.
Ad esempio, puoi specificare la seguente espressione di filtro per visualizzare solo le attività di un gruppo di attività di un job in esecuzione o che sono state eseguite correttamente:
STATE=RUNNING%20OR%20STATE=SUCCEEDED
Tieni presente che l'espressione di filtro con codifica URL rappresenta la seguente espressione di filtro decodificata:
STATE=RUNNING OR STATE=SUCCEEDED
Go
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i dettagli di un'attività
Puoi visualizzare i dettagli di un'attività utilizzando la console Google Cloud, gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare i dettagli di un'attività utilizzando la console Google Cloud, visualizza i dettagli di un job per aprire la pagina Dettagli job. Quindi, consulta la sezione Dettagli attività.
gcloud
Per visualizzare i dettagli di un'attività utilizzando gcloud CLI, utilizza il comando gcloud batch tasks describe
con i seguenti flag:
gcloud batch tasks describe TASK_INDEX \
--location=LOCATION \
--job=JOB_NAME \
--task_group=TASK_GROUP_NAME
Sostituisci quanto segue:
TASK_INDEX
: l'indice dell'attività di cui vuoi visualizzare i dettagli. In un gruppo di attività, l'indice delle attività inizia da 0 per la prima attività e aumenta di 1 a ogni attività aggiuntiva. Ad esempio, un gruppo di attività contenente quattro attività ha gli indici0
,1
,2
e3
.TASK_GROUP_NAME
: il nome del gruppo di attività che contiene l'attività di cui vuoi visualizzare i dettagli. Il valore deve essere impostato sugroup0
.JOB_NAME
: il nome di un job esistente.LOCATION
: la località in cui si trova il job.
API
Per visualizzare i dettagli di un'attività utilizzando l'API Batch, effettua una
richiesta GET
al
metodo tasks.get
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto del progetto corrente.LOCATION
: la località in cui si trova il job.JOB_NAME
: il nome di un job esistente.TASK_GROUP_NAME
: il nome del gruppo di attività che contiene l'attività di cui vuoi visualizzare i dettagli. Il valore deve essere impostato sugroup0
.TASK_INDEX
: l'indice dell'attività di cui vuoi visualizzare i dettagli. In un gruppo di attività, l'indice delle attività inizia da 0 per la prima attività e aumenta di 1 a ogni attività aggiuntiva. Ad esempio, un gruppo di attività contenente quattro attività ha gli indici0
,1
,2
, un,3
.
Go
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ Batch.
Per eseguire l'autenticazione in modalità batch, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Scopri come monitorare e analizzare i job:
Visualizza la cronologia degli eventi relativi allo stato di un job.
Monitorare e ottimizzare le risorse del job visualizzando le metriche.
Se hai configurato i log per un job, puoi analizzare un job utilizzando i log.
Se hai configurato le notifiche di stato, puoi monitorare un job utilizzando le notifiche Pub/Sub e analizzare le notifiche utilizzando BigQuery.
Scopri come organizzare le risorse utilizzando le etichette.
Scopri come eliminare ed esportare i job.