Visualizzare la cronologia di un job tramite eventi di stato

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

Ogni job e ciascuna delle sue attività presentano eventi di stato creati automaticamente da Batch durante l'esecuzione del job. Ciascuno di questi eventi di stato descrive una modifica di stato e i dettagli sul motivo per cui tale stato è stato raggiunto. Per saperne 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 descrivono l'avanzamento degli elementi eseguibili. Per scoprire di più sugli eventi di stato personalizzati, consulta Configurare gli eventi di stato personalizzati.

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 gli eventi relativi allo stato

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

Le seguenti istruzioni spiegano come visualizzare gli eventi di stato utilizzando la console Google Cloud, gcloud CLI e l'API Batch. Per utilizzare un linguaggio di libreria client, segui i passaggi per visualizzare i dettagli di un job o visualizzare i dettagli di un'attività, quindi vedi il campo statusEvents[] corrispondente.

Visualizzare gli eventi relativi allo stato di un job

Console

Per visualizzare gli eventi di stato di un job nel progetto attuale utilizzando la console Google Cloud, segui questi passaggi:

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

    Vai all'elenco dei job

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

    Si apre 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 CLId, utilizza il comando gcloud batch jobs describe e osserva il campo statusEvents[].

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

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.

Visualizzare gli eventi relativi allo stato di un'attività

gcloud

Per visualizzare gli eventi dello stato di un'attività utilizzando gcloud CLI, utilizza il comando gcloud batch tasks describe, quindi osserva 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 a ogni attività aggiuntiva. Ad esempio, un gruppo di attività contenente quattro attività ha gli indici 0, 1, 2 e 3.

  • JOB_NAME: il nome di un job esistente.

  • LOCATION: la località in cui si trova 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 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: 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 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 a ogni attività aggiuntiva. Ad esempio, un gruppo di attività contenente quattro attività ha gli indici 0, 1, 2 e 3.

Passaggi successivi