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 ogni sua attività hanno eventi di stato creati automaticamente da Batch durante l'esecuzione del job. Ciascuno di questi eventi di stato descrive una modifica dello stato e i dettagli sul motivo per cui è stato raggiunto. Per scoprire di più sugli stati di job e attività, consulta la sezione Ciclo di vita del job. Se vuoi, puoi anche configurare un job in modo che abbia eventi di stato personalizzati, che descrivono 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 sezione Guida introduttiva a Batch e attiva Batch 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 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 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 , gcloud CLI e l'API Batch. Per utilizzare una lingua 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 , procedi nel seguente modo:

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

    Vai all'elenco di job

  2. 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.

  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, quindi consulta 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, invia una richiesta GET al metodo jobs.get e poi visualizza 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 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 visualizza 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 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 indici 0, 1, 2 e 3.

  • JOB_NAME: il nome di un job esistente.

  • LOCATION: la posizione in cui esiste il lavoro.

  • 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, invia una richiesta GET al metodo tasks.get e poi visualizza 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 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 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 indici 0, 1, 2 e 3.

Passaggi successivi