Verlauf eines Jobs über Statusereignisse ansehen

In diesem Dokument wird beschrieben, wie Sie Statusereignisse für Batchjobs und Aufgaben aufrufen. 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 eine Statusänderung und Details dazu, warum dieser Status erreicht wurde. Informationen zu 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 noch nicht verwendet haben, lesen Sie den Hilfeartikel Batch-Dateien erstellen und ausführen und aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.

  2. 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 zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Jobs und Aufgaben benötigen. 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 beschrieben, wie Sie Statusereignisse mit derGoogle Cloud -Konsole, der gcloud CLI und der Batch API aufrufen. Wenn Sie eine Clientbibliothekssprache verwenden möchten, folgen Sie der Anleitung zum Ansehen der Details eines Jobs oder zum Ansehen der Details einer Aufgabe und sehen Sie sich dann das entsprechende Feld statusEvents[] an.

Statusereignisse eines Jobs ansehen

Console

So rufen Sie in derGoogle Cloud -Console die Statusereignisse eines Jobs im aktuellen Projekt auf:

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

    Jobliste aufrufen

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

  • 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, deren Details Sie aufrufen möchten. In einer Aufgabengruppe beginnt der Aufgabenindex bei 0 für die erste Aufgabe und erhöht sich mit jeder zusätzlichen 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: 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

Wenn Sie die Statusereignisse einer Aufgabe mit der Batch API aufrufen möchten, senden Sie eine GET-Anfrage an die Methode tasks.get und sehen Sie sich 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: den Speicherort, 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 aufrufen 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 bei 0 für die erste Aufgabe und erhöht sich mit jeder zusätzlichen Aufgabe um 1. Eine Aufgabengruppe mit vier Aufgaben hat beispielsweise die Indexe 0, 1, 2 und 3.

Nächste Schritte