In diesem Dokument wird beschrieben, wie Sie einen Batch-Job erstellen und ausführen, mit dem der Ops-Agent automatisch installiert wird. Installieren Sie den Ops-Agent, um in Cloud Monitoring zusätzliche Messwerte zur Leistung der Ressourcen eines Jobs zu erhalten. Weitere Informationen zur Verwendung von Ressourcenleistungsmesswerten für einen Job finden Sie unter Jobressourcen anhand von Messwerten überwachen und optimieren.
Hinweise
- 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.
- Aktivieren Sie die Cloud Monitoring API und die Cloud Logging API in Ihrem Projekt, falls noch nicht geschehen:
-
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Jobs benötigen:
-
So erstellen Sie einen Job:
-
Batch-Job-Bearbeiter (
roles/batch.jobsEditor
) für das Projekt -
Dienstkontonutzer (
roles/iam.serviceAccountUser
) im Dienstkonto des Jobs, das standardmäßig das Compute Engine-Standarddienstkonto ist
-
Batch-Job-Bearbeiter (
-
So rufen Sie Logs auf:
Loganzeige (
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:
Sofern Sie nicht die Standardkonfiguration für das Dienstkonto des Jobs verwenden, muss es die erforderlichen Berechtigungen haben.
Damit das Dienstkonto des Jobs die erforderlichen Berechtigungen zum Schreiben von Ops-Agent-Messwerten in Monitoring hat, bitten Sie Ihren Administrator, dem Dienstkonto des Jobs die folgenden IAM-Rollen zu erteilen:
-
Monitoring-Messwert-Autor (
roles/monitoring.metricWriter
) für das Projekt -
Log-Autor (
roles/logging.logWriter
) für das Projekt
-
Monitoring-Messwert-Autor (
- Prüfen Sie, ob die geplante Jobkonfiguration die Anforderungen an den Ops-Agenten erfüllt.
Anforderungen an den Ops-Agent
Damit Sie einen Job erstellen und ausführen können, der den Ops-Agenten verwendet, muss Ihr Job alle folgenden Anforderungen erfüllen:
Achten Sie darauf, dass die VMs des Jobs ein Betriebssystem verwenden, das vom Ops-Agent unterstützt wird. Weitere Informationen zum VM-Betriebssystem-Image für einen Job finden Sie unter Übersicht über die Betriebssystemumgebung für die VMs eines Jobs.
Wenn für Ihren Job eine andere Netzwerkkonfiguration als die Standardkonfiguration oder VPC Service Controls verwendet wird, muss der Job die Zugriffsanforderungen für den Ops-Agenten erfüllen. Weitere Informationen finden Sie in der Google Cloud Observability-Dokumentation unter VMs ohne Remote-Paketzugriff.
Achten Sie darauf, dass der Job keinen Legacy-Cloud Logging- oder Cloud Monitoring-Agent installiert, z. B. über ein benutzerdefiniertes Image oder eine Instanzvorlage.
Weitere Informationen zu den Funktionen und Anforderungen des Ops-Agents finden Sie in der Google Cloud Observability-Dokumentation unter Ops-Agent – Übersicht.
Job erstellen, mit dem der Ops-Agent automatisch installiert wird
Verwenden Sie die Google Cloud CLI oder die REST API, um einen Job zu erstellen, der das Feld installOpsAgent
enthält, das im Feld allocationPolicy.instances
im Hauptteil der JSON-Datei auf true
festgelegt ist:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Ein Job, der den Ops-Agenten automatisch installiert, kann beispielsweise eine JSON-Konfigurationsdatei haben, die in etwa so aussieht:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Nachdem die VMs des Jobs gestartet wurden, können Sie die Ops-Agent-Messwerte wie alle anderen Ressourcenmesswerte sehen. Weitere Informationen finden Sie unter Jobressourcen anhand von Messwerten überwachen und optimieren.
Nächste Schritte
- Wenn beim Erstellen oder Ausführen eines Jobs Probleme auftreten, lesen Sie den Hilfeartikel Fehlerbehebung.
- Aufgaben und Jobs ansehen
- Weitere Informationen zu den Optionen zum Erstellen von Jobs