Auftragsverlauf über Statusereignisse aufrufen

In diesem Dokument wird erläutert, wie Sie Statusereignisse für Batchjobs und -aufgaben aufrufen. Statusereignisse stellen einen Verlauf bereit, mit dem Sie Jobs analysieren können. Außerdem enthalten sie häufig nützliche Fehlermeldungen zur Fehlerbehebung.

Jeder Job und jede seiner Aufgaben haben Statusereignisse, die von Batch automatisch erstellt werden, während der Job ausgeführt wird. Jedes dieser Statusereignisse beschreibt eine Statusänderung und gibt Details darüber an, warum der jeweilige Status erreicht wurde. Weitere Informationen zu Job- und Aufgabenstatus finden Sie unter Joblebenszyklus. Optional können Sie einen Job auch mit benutzerdefinierten Statusereignissen konfigurieren, die den Fortschritt von Runnables beschreiben. Weitere Informationen zu benutzerdefinierten Statusereignissen finden Sie unter Benutzerdefinierte Statusereignisse konfigurieren.

Hinweise

  • Wenn Sie Batch noch nicht verwendet haben, lesen Sie Erste Schritte mit Batch. Aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.

  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Batch Job Viewer“ (roles/batch.jobsViewer) oder „Batch Job Editor“ (roles/batch.jobsEditor) für das Projekt zu gewähren, damit Sie die erforderlichen Berechtigungen zum Ansehen von Jobs und Aufgaben erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

    Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Statusereignisse ansehen

In der folgenden Anleitung wird erläutert, wie Sie Statusereignisse mit der Google Cloud Console, der gcloud CLI und der Batch API aufrufen. Wenn Sie eine Clientbibliothekssprache verwenden möchten, führen Sie die Schritte zum Anzeigen der Details eines Jobs oder zum Aufrufen der Details einer Aufgabe und zum Prüfen des entsprechenden Felds statusEvents[] aus.

Statusereignisse eines Jobs ansehen

Console

So rufen Sie die Statusereignisse eines Jobs im aktuellen Projekt über die Google Cloud Console auf:

  1. Rufen Sie in der Google Cloud Console die Seite Jobliste auf.

    Zur Jobliste

  2. Klicken Sie in der Spalte Jobname auf den Namen eines Jobs.

    Die Seite Jobdetails wird aufgerufen.

    Der Tab Details ist standardmäßig geöffnet.

  3. Klicken Sie auf den Tab Events (Ereignisse).

gcloud

Zum Aufrufen der Statusereignisse eines Jobs über die gcloud CLI verwenden Sie den Befehl gcloud batch jobs describe und sehen Sie sich dann das Feld statusEvents[] an.

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • LOCATION: der Standort, an dem sich der Job befindet.

API

Zum Aufrufen der Statusereignisse eines Jobs mit der Batch API senden Sie eine GET-Anfrage an die Methode jobs.get und sehen Sie sich das Feld statusEvents[] an.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des aktuellen Projekts.

  • LOCATION: der Standort, an dem sich der Job befindet.

  • JOB_NAME: der Name eines vorhandenen Jobs.

Statusereignisse einer Aufgabe ansehen

Console

gcloud

Zum Aufrufen der Statusereignisse einer Aufgabe über die gcloud CLI verwenden Sie den Befehl gcloud batch tasks describe und sehen Sie sich dann das Feld statusEvents[] an.

gcloud batch tasks describe TASK_INDEX \
  --location=LOCATION \
  --job=JOB_NAME \
  --task_group=TASK_GROUP_NAME

Ersetzen Sie Folgendes:

  • TASK_INDEX: Der Index der Aufgabe, deren Details Sie sich ansehen möchten. In einer Aufgabengruppe beginnt der Aufgabenindex für die erste Aufgabe bei 0 und erhöht sich mit jeder weiteren Aufgabe um 1. Eine Aufgabengruppe, die vier Aufgaben enthält, hat beispielsweise die Indexe 0, 1, 2 und 3.

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • LOCATION: der Standort, an dem sich der Job befindet.

  • TASK_GROUP_NAME: der Name der Aufgabengruppe mit der Aufgabe, deren Details Sie sich ansehen möchten. Der Wert muss auf group0 festgelegt sein.

API

Zum Aufrufen der Statusereignisse einer Aufgabe mit der Batch API senden Sie eine GET-Anfrage an die Methode tasks.get und sehen sich dann das Feld statusEvents[] an.

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des aktuellen Projekts.

  • LOCATION: der Standort, an dem sich der Job befindet.

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • TASK_GROUP_NAME: der Name der Aufgabengruppe mit der Aufgabe, deren Details Sie sich ansehen möchten. Der Wert muss auf group0 festgelegt sein.

  • TASK_INDEX: Der Index der Aufgabe, deren Details Sie sich ansehen möchten. In einer Aufgabengruppe beginnt der Aufgabenindex für die erste Aufgabe bei 0 und erhöht sich mit jeder weiteren Aufgabe um 1. Eine Aufgabengruppe, die vier Aufgaben enthält, hat beispielsweise die Indexe 0, 1, 2 und 3.

Nächste Schritte