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:
Rufen Sie in der Google Cloud Console die Seite Jobliste auf.
Klicken Sie in der Spalte Jobname auf den Namen eines Jobs.
Die Seite Jobdetails wird aufgerufen.
Der Tab Details ist standardmäßig geöffnet.
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 Indexe0
,1
,2
und3
.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 aufgroup0
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 aufgroup0
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 Indexe0
,1
,2
und3
.
Nächste Schritte
Informationen zu Statusereignissen aus Batch, die Fehler beschreiben, finden Sie unter Fehlerbehebung.
Wenn Sie einen detaillierteren Verlauf für Ihren Job benötigen, z. B. Statusereignisse für Start und Ende von Runnables, konfigurieren Sie benutzerdefinierte Statusereignisse.