Verlauf eines Jobs über Statusereignisse ansehen

In diesem Dokument wird beschrieben, wie Sie Statusereignisse für Batch-Jobs und ‑Aufgaben aufrufen. Statusereignisse enthalten einen Verlauf, mit dem Sie Jobs analysieren können. Sie enthalten oft nützliche Fehlermeldungen, die Sie zur Fehlerbehebung verwenden können.

Für jeden Job und jede seiner Aufgaben werden während der Ausführung des Jobs automatisch Statusereignisse von Batch erstellt. Jedes dieser Statusereignisse beschreibt eine Statusänderung und enthält Details dazu, warum dieser Status erreicht wurde. Informationen zu Job- und Aufgabenstatus finden Sie unter Job-Lebenszyklus. Optional können Sie einen Job auch so konfigurieren, dass er benutzerdefinierte Statusereignisse enthält, die den Fortschritt von Runnables beschreiben. Weitere Informationen zu benutzerdefinierten Statusereignissen

Hinweise

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

  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 auf Aufgabenebene (Feld statusEvents[] für jede Aufgabe) können unterschiedliche Statusereignisse angezeigt werden.

In der folgenden Anleitung wird beschrieben, wie Sie Statusereignisse über dieGoogle Cloud Console, die gcloud CLI und die Batch API aufrufen. Wenn Sie eine Clientbibliotheksprache verwenden möchten, folgen Sie der Anleitung zum Aufrufen der Details eines Jobs oder Aufrufen der Details einer Aufgabe und sehen Sie sich dann das entsprechende Feld statusEvents[] an.

Statusereignisse eines Jobs ansehen

Console

So rufen Sie die Statusereignisse eines Jobs im aktuellen Projekt über dieGoogle 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

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 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 der Job vorhanden ist.

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, an dem der Job vorhanden ist.

  • 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 wird bei jeder zusätzlichen Aufgabe um 1 erhöht. Eine Taskgruppe mit vier Tasks hat beispielsweise die Indexe 0, 1, 2 und 3.

  • JOB_NAME: Der Name eines vorhandenen Jobs.

  • LOCATION: Der Standort, an dem der Job vorhanden ist.

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

API

Wenn Sie die Statusereignisse einer Aufgabe mit der Batch API aufrufen möchten, senden Sie eine GET-Anfrage an die tasks.get-Methode 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: Die Projekt-ID des aktuellen Projekts.

  • LOCATION: der Standort, an dem der Job vorhanden ist.

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

  • 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 wird bei jeder zusätzlichen Aufgabe um 1 erhöht. Eine Taskgruppe mit vier Tasks hat beispielsweise die Indexe 0, 1, 2 und 3.

Nächste Schritte