Verlauf eines Jobs über Statusereignisse ansehen

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

Jeder Job und jede seiner Aufgaben haben Statusereignisse, die während der Ausführung des Jobs automatisch von Batch erstellt werden. Jedes dieser Statusereignisse beschreibt eine Statusänderung und Details darüber, warum dieser Status erreicht wurde. Informationen zum 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 den Abschnitt Erste Schritte mit Batch und 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, um die erforderlichen Berechtigungen zum Ansehen von Jobs und Aufgaben zu 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

Auf Jobebene (Feld statusEvents[] für den Job) und Aufgabenebene (Feld statusEvents[] für jede Aufgabe) können unterschiedliche Statusereignisse angezeigt werden.

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 Sprache der Clientbibliothek verwenden möchten, führen Sie die Schritte zum Aufrufen der Details eines Jobs oder zum Aufrufen der Details einer Aufgabe und dann zum entsprechenden Feld 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

Verwenden Sie zum Aufrufen der Statusereignisse eines Jobs über die gcloud CLI 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

Wenn Sie die Statusereignisse eines Jobs mit der Batch API aufrufen möchten, senden Sie eine GET-Anfrage an die Methode jobs.get und sehen Sie sich dann das Feld statusEvents[] an.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID ist 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

gcloud

Verwenden Sie zum Aufrufen der Statusereignisse einer Aufgabe über die gcloud CLI 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 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 mit vier Aufgaben 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, die die Aufgabe enthält, deren Details Sie ansehen möchten. Der Wert muss auf group0 festgelegt sein.

API

Wenn Sie die Statusereignisse einer Aufgabe mit der Batch API aufrufen möchten, stellen Sie eine GET-Anfrage an die Methode tasks.get und sehen Sie 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 ist 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, die die Aufgabe enthält, deren Details Sie ansehen möchten. Der Wert muss auf group0 festgelegt sein.

  • TASK_INDEX: der Index der Aufgabe, deren Details Sie 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 mit vier Aufgaben hat beispielsweise die Indexe 0, 1, 2 und 3.

Nächste Schritte