In diesem Dokument wird beschrieben, wie Sie Logs aus Cloud Logging für einen Batch-Job aktivieren, generieren und ansehen.
Mithilfe von Logs können Sie Informationen abrufen, die für die Analyse Ihrer Jobs nützlich sind. Mithilfe von Logs können Sie beispielsweise Fehler in fehlgeschlagenen Jobs beheben.
Wichtig: Logs werden erst nach dem Start eines Jobs generiert und nur, wenn die Protokollierung für den Job aktiviert wurde. Wenn Sie einen Job ohne Logs analysieren müssen, sehen Sie sich stattdessen die Statusereignisse an.
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 folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Analysieren eines Jobs mithilfe von Logs benötigen:
-
So erstellen Sie einen Job:
-
Batch-Job-Editor (
roles/batch.jobsEditor
) für das Projekt -
Dienstkontonutzer (
roles/iam.serviceAccountUser
) für das Dienstkonto des Jobs, das standardmäßig das Compute Engine-Standarddienstkonto ist
-
Batch-Job-Editor (
-
So rufen Sie Logs auf:
Logbetrachter (
roles/logging.viewer
) 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.
-
So erstellen Sie einen Job:
Logging für einen Job aktivieren
Damit Logs für einen Job generiert werden können, aktivieren Sie Logs in Cloud Logging, wenn Sie den Job erstellen:
- Wenn Sie einen Job über die Google Cloud -Konsole erstellen, sind Logs aus Cloud Logging immer aktiviert.
Wenn Sie einen Job mit der gcloud CLI oder der Batch API erstellen, sind Logs aus Cloud Logging standardmäßig deaktiviert. Wenn Sie Logs aus Cloud Logging aktivieren möchten, fügen Sie beim Erstellen des Jobs die folgende Konfiguration für das Feld
logsPolicy
ein:{ ... "logsPolicy": { "destination": "CLOUD_LOGGING" } ... }
Logs für einen Job schreiben und generieren
Wenn Logs aus Cloud Logging für einen Job aktiviert sind, werden alle für den Job geschriebenen Logs automatisch von Cloud Logging generiert. Batch-Jobs können die folgenden Logtypen haben:
Agent-Logs (
batch_agent_logs
): Logs für Aktivitäten des Batch-Dienst-Agents.Batch schreibt automatisch Agent-Logs für jeden Job, für den die Protokollierung aktiviert ist.
Aufgabenlogs (
batch_task_logs
): Logs für alle Daten, für die Sie die Runnables eines Jobs so konfiguriert haben, dass sie in den Standardausgabe- (stdout
) oder Standardfehlerstream (stderr
) geschrieben werden.Optional können Sie Aufgabenlogs für jeden Job schreiben, für den das Logging aktiviert ist.
Logs für einen Job ansehen
Sie können die Logs eines Jobs über die Google Cloud Console, die gcloud CLI, die Logging API oder Go, Java, Python oder C++ aufrufen.
Console
So rufen Sie die Logs eines Jobs mit der 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 geöffnet.
Klicken Sie auf den Tab Logs. In Batch werden alle Logs angezeigt, die mit dem Job verknüpft sind.
Optional: Führen Sie einen der folgenden Schritte aus, um die Logs zu filtern:
Geben Sie im Feld Filter ein.
Filter einenWählen Sie in der Liste Schweregrad einen Schweregrad aus.
Klicken Sie auf Batchfilterparametern eine Abfrage im Log-Explorer zu erstellen.
Im Log-Explorer ansehen, um mit den
gcloud
Wenn Sie Logs mit der gcloud CLI aufrufen möchten, verwenden Sie den Befehl gcloud logging read
:
gcloud logging read "QUERY"
Dabei ist QUERY
eine Abfrage für Batchlogs, die Batchfilterparameter enthält.
API
So rufen Sie Logs mithilfe der Logging API auf:entries.list
POST https://logging.googleapis.com/v2/entries:list
{
"resourceNames": [
"projects/PROJECT_ID"
],
"filter": "QUERY"
"orderBy": "timestamp desc"
}
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID Ihres Projekts.QUERY
: Eine Abfrage für Batch-Logs, die Batch-Filterparameter enthält.
Go
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Batch Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Batch Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Batch Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Batch C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Batch-Logs filtern
Sie können Batchlogs filtern, indem Sie eine Abfrage schreiben, die einen oder mehrere der folgenden Filterparameter und null oder mehr boolesche Operatoren (AND
, OR
und NOT
) enthält.
Wenn Sie nach Logs eines bestimmten Jobs filtern möchten, geben Sie die eindeutige ID (UID) des Jobs an:
labels.job_uid=JOB_UID
Dabei ist
JOB_UID
die UID des Jobs. Wenn Sie die UID eines Jobs abrufen möchten, rufen Sie die Details des Jobs auf.Wenn Sie nach einem bestimmten Typ von Batch-Logs filtern möchten, geben Sie den Logtyp an:
logName=projects/PROJECT_ID/logs/BATCH_LOG_TYPE
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID des Projekts, für das Sie Logs aufrufen möchten.BATCH_LOG_TYPE
: Der Typ der Batch-Logs, die Sie aufrufen möchten, entwederbatch_task_logs
für Aufgabenlogs oderbatch_agent_logs
für Agent-Logs.
Wenn Sie nach Logs mit Benutzerstatusereignissen filtern möchten, geben Sie an, dass im Log das Feld
jsonPayload.batch/custom/event
definiert sein muss:jsonPayload.batch"/"custom"/"event!=NULL_VALUE
Wenn Sie nach Logs mit einem oder mehreren bestimmten Schweregraden filtern möchten, geben Sie den folgenden Vergleich an:
severityCOMPARISON_OPERATORSEVERITY_ENUM
Ersetzen Sie Folgendes:
COMPARISON_OPERATOR
: ein Vergleichsoperator, z. B.>=
.SEVERITY_ENUM
: einLogSeverity
-Enum, das die Schwere eines Logs beschreibt, z. B.ERROR
.
Weitere Filteroptionen finden Sie in der Dokumentation zur Cloud Logging-Abfragesprache.
Nächste Schritte
- Weitere Informationen zur Fehlerbehebung
- Weitere Informationen zu Cloud Logging
- Aufgabenprotokolle schreiben
- Informationen zum Exportieren von Jobinformationen
- Jobs löschen