Visualizzare la cronologia di un job tramite eventi di stato

Questo documento spiega come visualizzare gli eventi di stato per Batch di lavori e attività. Gli eventi di stato forniscono una cronologia che puoi utilizzare per analizzare job e spesso contengono utili messaggi di errore che puoi utilizzare 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 scoprire di più sugli eventi di stato personalizzati, consulta Configurare gli eventi di stato personalizzati.

Prima di iniziare

  • Se non hai mai utilizzato Batch, rivedi Inizia a utilizzare Batch e abilita Batch, completando prerequisiti per progetti e utenti.

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

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

Visualizza gli eventi relativi allo stato

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

Le seguenti istruzioni spiegano come visualizzare gli eventi di stato utilizzando il Console Google Cloud, gcloud CLI e 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 relativi allo stato di un job

Console

Per visualizzare gli eventi di stato di un job nel progetto corrente utilizzando il nella 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 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 località in cui esiste il job.

API

Per visualizzare gli eventi relativi allo stato di un job utilizzando API Batch, effettua una richiesta GET all'API jobs.get, e vedremo il campo statusEvents[].

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

Sostituisci quanto segue:

  • PROJECT_ID: il valore ID progetto del progetto attuale.

  • LOCATION: la località in cui esiste il job.

  • JOB_NAME: il nome di un job esistente.

Visualizzare gli eventi relativi allo stato di un'attività

gcloud

Per visualizzare gli eventi relativi allo stato di un'attività utilizzando gcloud CLI, utilizza Comando gcloud batch tasks describe, e vedremo 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à che 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'attività gruppo che contiene quattro attività ha gli indici 0, 1, 2 e 3.

  • JOB_NAME: il nome di un job esistente.

  • LOCATION: la località in cui se il job esiste.

  • 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 a tasks.get, e vedremo 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 valore ID progetto del progetto attuale.

  • LOCATION: la località in cui esiste 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à che 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'attività gruppo che contiene quattro attività ha gli indici 0, 1, 2 e 3.

Passaggi successivi