Verlauf eines Jobs über Statusereignisse ansehen

In diesem Dokument wird erläutert, wie Statusereignisse für Batch aufgerufen werden Jobs und Aufgaben. Statusereignisse bieten einen Verlauf, mit dem Sie Jobs analysieren können. Außerdem enthalten sie oft nützliche Fehlermeldungen, die Sie bei der 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 einen Status und Details dazu, warum der 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 ausführbaren Elementen beschreiben. Weitere Informationen zu benutzerdefinierten Statusereignissen finden Sie unter Benutzerdefinierte Statusereignisse konfigurieren

Hinweise

  1. Wenn Sie Batch zum ersten Mal verwenden, lesen Sie Erste Schritte mit Batch und aktivieren Sie Batch, indem Sie den Voraussetzungen für Projekte und Nutzer.

  2. Um die Berechtigungen zu erhalten, die Sie zum Ansehen von Jobs und Aufgaben benötigen, bitten Sie Ihren Administrator, Ihnen Batchjob-Betrachter (roles/batch.jobsViewer) oder Batchjob-Editor (roles/batch.jobsEditor) IAM-Rolle für das Projekt Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Sie können 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 auftreten.

In der folgenden Anleitung wird erläutert, wie Sie Statusereignisse mithilfe der Google Cloud Console, gcloud CLI und Batch API Um eine Clientbibliothekssprache zu verwenden, befolgen Sie die Schritte zur Details eines Jobs ansehen oder Details zu einer Aufgabe ansehen und sehen dann das entsprechende statusEvents[]-Feld.

Statusereignisse eines Jobs ansehen

Console

So rufen Sie die Statusereignisse eines Jobs im aktuellen Projekt in der Google Cloud Console auf:

  1. Rufen Sie in der Google Cloud Console die Seite Aufgabenliste 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

Wenn Sie die Statusereignisse eines Jobs mit der gcloud CLI aufrufen möchten, verwenden Sie den Befehl gcloud batch jobs describe und sehen Sie sich das Feld statusEvents[] an.

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • LOCATION: den Speicherort, 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 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 wo der Job liegt.

  • JOB_NAME: der Name eines vorhandenen Jobs.

Statusereignisse einer Aufgabe ansehen

gcloud

Wenn Sie die Statusereignisse einer Aufgabe mit der gcloud CLI aufrufen möchten, verwenden Sie den Befehl gcloud batch tasks describe und sehen Sie sich 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, die Sie ansehen möchten die Details zu zeigen. In einer Aufgabengruppe beginnt der Aufgabenindex für die erste und erhöht sich bei jeder weiteren Aufgabe um 1. Zum Beispiel kann eine Aufgabe Gruppe, die vier Aufgaben enthält, hat die Indexe 0, 1, 2 und 3.

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • LOCATION: den Speicherort, an dem sich die Aufgabe befindet.

  • TASK_GROUP_NAME: der Name der Aufgabengruppe, die die Aufgabe enthält, deren Details Sie aufrufen möchten. Der Wert muss auf group0 festgelegt sein.

API

So rufen Sie die Statusereignisse einer Aufgabe mithilfe der Batch API auf: GET-Anfrage an den Methode tasks.get, und sehen dann das Feld statusEvents[].

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: den Speicherort, an dem sich der Job befindet.

  • JOB_NAME: der Name eines vorhandenen Jobs.

  • TASK_GROUP_NAME: der Name der Aufgabengruppe, die enthält die Aufgabe, deren Details Sie ansehen möchten. Der Wert muss auf group0 festgelegt sein.

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

Nächste Schritte