In diesem Dokument wird erläutert, wie Statusereignisse für Batch aufgerufen werden Jobs und Aufgaben. Statusereignisse enthalten einen Verlauf, den Sie für Analysen verwenden können und enthalten oft nützliche Fehlermeldungen, die Sie für Fehlerbehebung.
Jeder Job und jede seiner Aufgaben haben Statusereignisse, die automatisch die während der Jobausführung von Batch erstellt wurden. 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 Jobs auch so konfigurieren, dass sie benutzerdefinierte Statusereignisse erhalten. den Fortschritt von Runnables. Weitere Informationen zu benutzerdefinierten Statusereignissen finden Sie unter Benutzerdefinierte Statusereignisse konfigurieren
Hinweise
- 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.
-
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 verwalten.Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Statusereignisse ansehen
Auf Jobebene können unterschiedliche Statusereignisse angezeigt werden
(Feld statusEvents[]
für den Job)
und auf Aufgabenebene
(statusEvents[]
Feld für jede Aufgabe).
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 mithilfe der Google Cloud Console führen Sie die folgenden Schritte aus:
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
Um die Statusereignisse eines Jobs mithilfe der
gcloud CLI verwenden, verwenden Sie die
gcloud batch jobs describe
-Befehl,
und sehen dann das Feld statusEvents[]
.
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
Ersetzen Sie Folgendes:
JOB_NAME
: der Name eines vorhandenen Jobs.LOCATION
: der Standort wo der Job liegt.
API
Um die Statusereignisse eines Jobs mithilfe der
Batch API senden Sie eine GET
-Anfrage an die
Methode jobs.get
,
und sehen dann das Feld statusEvents[]
.
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
Um die Statusereignisse einer Aufgabe mit der gcloud CLI anzuzeigen, verwenden Sie die
gcloud batch tasks describe
-Befehl,
und sehen dann das Feld statusEvents[]
.
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 Indexe0
,1
,2
und3
.JOB_NAME
: der Name eines vorhandenen Jobs.LOCATION
: der Standort, an dem Sie der Job existiert.TASK_GROUP_NAME
: der Name der Aufgabengruppe, die enthält die Aufgabe, deren Details Sie ansehen möchten. Der Wert muss aufgroup0
festgelegt.
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
: der Standort wo der Job liegt.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 aufgroup0
festgelegt.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 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 wann Runnables starten und enden, Benutzerdefinierte Statusereignisse konfigurieren.
Hier erfahren Sie, wie Sie Jobs mithilfe von Logs zu analysieren.