Visualizzare la cronologia di un job tramite eventi di stato

Questo documento spiega come visualizzare gli eventi di stato per Batch lavori e attività. 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 sue attività hanno eventi di stato che vengono automaticamente creato da Batch durante l'esecuzione del job. Ciascuno di questi eventi di stato descrive uno stato la modifica e i dettagli sul motivo per cui quello è stato raggiunto. Per informazioni sugli stati dei job e delle attività, consulta Ciclo di vita del job. Facoltativamente, puoi anche configurare un job in modo che abbia eventi di stato personalizzati, per descrivere l'avanzamento degli elementi eseguibili. 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, rivedi Inizia a utilizzare Batch e abilita Batch, completando prerequisiti per progetti e utenti.

  2. Per ottenere le autorizzazioni necessarie per visualizzare job e attività, chiedi all'amministratore di concederti Visualizzatore job batch (roles/batch.jobsViewer) o editor job batch (roles/batch.jobsEditor) ruolo IAM per il 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 la ruoli o altri ruoli predefiniti ruoli.

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 console Google Cloud, l'interfaccia a riga di comando gcloud e l'API Batch. Per utilizzare un linguaggio di libreria client, segui i passaggi per visualizzare i dettagli di un'offerta di lavoro oppure visualizza i dettagli di un'attività e vedremo 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 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.

    Viene visualizzata la pagina Dettagli job.

    La scheda Dettagli è aperta per impostazione predefinita.

  3. Fai clic sulla scheda Eventi.

gcloud

Per visualizzare gli eventi relativi allo stato di un job utilizzando gcloud CLI, utilizza Comando gcloud batch jobs describe, e vedremo 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 attuale.

  • LOCATION: la posizione in cui esiste il lavoro.

  • JOB_NAME: il nome di un job esistente.

Visualizzare gli eventi relativi allo 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 dell'attività inizia da 0 per la prima attività e aumenta di 1 con ogni attività aggiuntiva. Ad esempio, un'attività gruppo 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 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 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 dell'attività e aumenta di 1 a ogni attività aggiuntiva. Ad esempio, un gruppo di attività che contiene quattro attività ha gli indici 0, 1, 2 e 3.

Passaggi successivi