Visualizzare la cronologia di un job tramite gli eventi di stato

Questo documento spiega come visualizzare gli eventi di stato per i job e le attività Batch. Gli eventi di stato forniscono una cronologia che puoi utilizzare per analizzare i job e spesso contengono messaggi di errore utili che puoi utilizzare per la risoluzione dei problemi.

Ogni job e ciascuna delle relative attività hanno eventi di stato creati automaticamente da Batch durante l'esecuzione del job. Ciascuno di questi eventi di stato descrive una variazione di stato e i dettagli sul motivo per cui è stato raggiunto. Per scoprire di più sugli stati dei job e delle attività, consulta Ciclo di vita dei job. Facoltativamente, puoi anche configurare un job in modo che abbia eventi di stato personalizzati, che descriveno l'avanzamento dei runnable. Per saperne di più sugli eventi di stato personalizzati, consulta Configurare gli eventi di stato personalizzati.

Prima di iniziare

  1. Se non hai mai utilizzato Batch, consulta la guida introduttiva all'utilizzo di Batch e attivalo completando i prerequisiti per progetti e utenti.

  2. Per ottenere le autorizzazioni necessarie per visualizzare job e attività, chiedi all'amministratore di concederti il ruolo IAM visualizzatore di job batch (roles/batch.jobsViewer) o editor di job batch (roles/batch.jobsEditor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizzare gli eventi di stato

Potrebbero essere visualizzati diversi eventi di stato a livello di job (campo statusEvents[] per il job) e a livello di attività (campo statusEvents[] per ogni attività).

Le istruzioni riportate di seguito spiegano come visualizzare gli eventi di stato utilizzando la consoleGoogle Cloud , l'interfaccia a riga di comando gcloud CLI'API Batch. Per utilizzare un linguaggio della libreria client, segui i passaggi per visualizzare i dettagli di un job o visualizzare i dettagli di un'attività e poi visualizza il campo statusEvents[] corrispondente.

Visualizzare gli eventi di stato di un job

Console

Per visualizzare gli eventi di stato di un job nel progetto corrente utilizzando la consoleGoogle Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Elenco di job.

    Vai all'elenco di job

  2. Nella colonna Nome job, fai clic sul nome di un job.

    Viene visualizzata la pagina Dettagli job.

    La scheda Dettagli è aperta per impostazione predefinita.

  3. Fai clic sulla scheda Eventi.

gcloud

Per visualizzare gli eventi di stato di un job utilizzando gcloud CLI, utilizza il comando gcloud batch jobs describe e poi controlla il campo statusEvents[].

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 gli eventi di stato di un job utilizzando l'API Batch, effettua una richiesta GET al metodo jobs.get e poi controlla il campo statusEvents[].

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

Sostituisci quanto segue:

  • PROJECT_ID: il ID progetto del progetto corrente.

  • LOCATION: la posizione in cui esiste il lavoro.

  • JOB_NAME: il nome di un job esistente.

Visualizzare gli eventi di stato di un'attività

gcloud

Per visualizzare gli eventi di stato di un'attività utilizzando gcloud CLI, utilizza il comando gcloud batch tasks describe, e poi controlla il campo statusEvents[].

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 con ogni attività aggiuntiva. Ad esempio, un gruppo di attività che contiene quattro attività ha gli indici 0, 1, 2 e 3.

  • JOB_NAME: il nome di un job esistente.

  • LOCATION: la posizione in cui esiste il job.

  • TASK_GROUP_NAME: il nome del gruppo di attività che contiene l'attività di cui vuoi visualizzare i dettagli. Il valore deve essere impostato su group0.

API

Per visualizzare gli eventi di stato di un'attività utilizzando l'API Batch, effettua una richiesta GET al metodo tasks.get, e poi controlla il campo statusEvents[].

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: il 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 su group0.

  • 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 con ogni attività aggiuntiva. Ad esempio, un gruppo di attività che contiene quattro attività ha gli indici 0, 1, 2 e 3.

Passaggi successivi