Questo documento spiega come visualizzare i job e le attività Batch.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta la sezione Guida introduttiva a Batch e attiva 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 Gestisci l'accesso a progetti, cartelle e organizzazioni.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Visualizzare i tuoi job
Per visualizzare i tuoi job, seleziona uno dei seguenti metodi:
Per visualizzare tutti i lavori nel tuo progetto, visualizza un elenco dei tuoi lavori.
Per visualizzare tutti i dettagli di configurazione di un job specifico, visualizza i dettagli di un job.
Visualizzare un elenco dei tuoi lavori
Puoi visualizzare un elenco di job nel progetto corrente utilizzando la consoleGoogle Cloud , gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare un elenco di job nel progetto corrente utilizzando la consoleGoogle Cloud , vai alla pagina Elenco job.
L'elenco dei lavori 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 lavori, fai clic su
Filtra. Poi, digita o seleziona una proprietà e un valore.Ad esempio, per filtrare l'elenco in modo da includere solo i job in uno stato specifico, inserisci quanto segue:
Status:JOB_STATE
Sostituisci
JOB_STATE
con uno stato del job, ad esempioFAILED
.
gcloud
Visualizza tutti i job
Per visualizzare un elenco di job nel progetto corrente utilizzando
gcloud CLI, utilizza il
comando gcloud batch jobs list
.
gcloud batch jobs list
Visualizzare un elenco filtrato di job
(Facoltativo) Puoi aggiungere uno o più flag per visualizzare un elenco filtrato di lavori:
Per visualizzare solo i lavori 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 posizione in cui esistono uno o più lavori.FILTER_EXPRESSION
: un'espressione di filtro che definisce i lavori che vuoi 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 del job, ad esempioFAILED
.Filtra in base alle etichette: Supponiamo che il tuo 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 tuoi job e delle relative risorse hanno un'etichetta
team
impostata suresearch
.Per indicare i carichi di lavoro sensibili al tempo, alcuni job hanno un'etichetta
deadline
, impostata su vari valori.Per indicare i runnable che il tuo team di sviluppo ha testato correttamente, alcuni runnable hanno un'etichetta
tested
impostata sutrue
.
A questo punto, 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 del team di ricerca con un'etichetta
team
nella norma di allocazione del job impostata suresearch
.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadline
sul job impostata su qualsiasi valore.Job con almeno un eseguibile testato correttamente, ovvero job con almeno un eseguibile con un'etichetta
tested
impostata sutrue
.
API
Visualizza tutti i job
Per visualizzare un elenco di job nel progetto corrente per una località specifica utilizzando
l'API Batch, invia 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 tuo progetto attuale.LOCATION
: la posizione in cui esistono i lavori.
Visualizzare un elenco filtrato di job
(Facoltativo) Puoi specificare il parametro di query filter
per visualizzare un elenco filtrato di job in base a un'espressione di filtro.
Ad esempio, invia 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 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 del job, ad esempioFAILED
.Filtra in base alle etichette: Supponiamo che il tuo 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 tuoi job e delle relative risorse hanno un'etichetta
team
impostata suresearch
.Per indicare i carichi di lavoro sensibili al tempo, alcuni job hanno un'etichetta
deadline
, impostata su vari valori.Per indicare i runnable che il tuo team di sviluppo ha testato correttamente, alcuni runnable hanno un'etichetta
tested
impostata sutrue
.
A questo punto, 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 del team di ricerca con un'etichetta
team
nella norma di allocazione del job impostata suresearch
.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadline
sul job impostata su qualsiasi valore.Job con almeno un eseguibile testato correttamente, ovvero job con almeno un eseguibile con un'etichetta
tested
impostata sutrue
.
Vai
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Go.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Java.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Node.js.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Python.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per C++.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura 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 consoleGoogle Cloud , gcloud CLI, Batch API, Go, Java, Node.js, Python o C++.
Console
Per visualizzare i dettagli di un job nel progetto corrente utilizzando la consoleGoogle Cloud , segui questi passaggi:
Nella console Google Cloud , vai alla pagina Elenco dei job.
Nella colonna Nome job, fai clic sul nome di un job.
Viene visualizzata la pagina Dettagli job.
Per impostazione predefinita, viene visualizzata la scheda Dettagli. Per ulteriori informazioni, fai clic sulle 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 posizione in cui esiste il lavoro.
API
Per visualizzare i dettagli di un job nel progetto corrente utilizzando l'API Batch, invia 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 posizione in cui esiste il lavoro.JOB_NAME
: il nome di un job esistente.
Vai
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Go.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Java.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Node.js.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Python.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per C++.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Visualizza le attività
Per visualizzare le attività di uno dei tuoi lavori, 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 visualizzare tutti i dettagli di configurazione di un'attività specifica, visualizza i dettagli di un'attività.
Visualizzare un elenco delle attività di un job
Puoi visualizzare un elenco delle attività in un job o nel gruppo di attività di un job utilizzando la consoleGoogle 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à che sono state completate correttamente, devi utilizzare gcloud CLI o l'API Batch.
Console
Per visualizzare un riepilogo delle attività di un job utilizzando la consoleGoogle Cloud , visualizza i dettagli di un job per aprire la pagina Dettagli job. Poi, consulta la sezione Dettagli dell'attività.
gcloud
Per visualizzare un elenco delle attività nel 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 posizione in cui esiste il lavoro.
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à nel gruppo di attività di un job che sono in esecuzione o che sono state eseguite correttamente:
STATE=RUNNING OR STATE=SUCCEEDED
API
Per visualizzare un elenco di attività nel gruppo di attività di un job utilizzando l'API Batch, invia 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 posizione in cui esiste il lavoro.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à nel gruppo di attività di un lavoro in base a un'espressione di filtro.
Ad esempio, invia 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 URL.
Ad esempio, puoi specificare la seguente espressione di filtro per visualizzare solo le attività nel gruppo di attività di un job che sono 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
Vai
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Go.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Java.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Node.js.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Python.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per C++.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i dettagli di un'attività
Puoi visualizzare i dettagli di un'attività utilizzando la consoleGoogle Cloud , gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare i dettagli di un'attività utilizzando la consoleGoogle Cloud , visualizza i dettagli di un job per aprire la pagina Dettagli job. Poi, consulta la sezione Dettagli dell'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 dell'attività inizia da 0 per la prima attività e aumenta di 1 per ogni attività aggiuntiva. Ad esempio, un gruppo di attività che contiene 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 posizione in cui esiste il lavoro.
API
Per visualizzare i dettagli di un'attività utilizzando l'API Batch, invia 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 posizione in cui esiste il lavoro.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 dell'attività inizia da 0 per la prima attività e aumenta di 1 per ogni attività aggiuntiva. Ad esempio, un gruppo di attività che contiene quattro attività ha gli indici0
,1
,2
e3
.
Vai
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Go.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Java.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Node.js.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per Python.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
C++
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Batch per C++.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Scopri di più sulla risoluzione dei problemi.
Scopri come monitorare e analizzare i job:
Monitora e ottimizza le risorse dei 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 gestire i lavori: