In diesem Dokument wird beschrieben, wie Sie einen Batchjob erstellen und ausführen, der den Ops-Agent automatisch installiert. 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 Messwerten zur Ressourcenleistung für einen Job finden Sie unter Jobressourcen mit Messwerten überwachen und optimieren.
Hinweis
- Wenn Sie Batch noch nicht verwendet haben, lesen Sie den Artikel Erste Schritte mit Batch und aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzererfüllen.
- Aktivieren Sie die Cloud Monitoring API und die Cloud Logging API in Ihrem Projekt, falls noch nicht geschehen:
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (
roles/serviceusage.serviceUsageAdmin), die die Berechtigungserviceusage.services.enableenthält. Informationen zum Zuweisen von Rollen. -
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, damit Sie die Berechtigungen zum Erstellen eines Jobs erhalten:
-
Zum Erstellen eines Jobs:
- Batch Job Editor (
roles/batch.jobsEditor) für das Projekt - Dienstkontonutzer (
roles/iam.serviceAccountUser) für das Dienstkonto des Jobs. Standardmäßig ist dies das Compute Engine-Standarddienstkonto.
- Batch Job Editor (
-
Zum Aufrufen von Logs:
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.
-
Zum Erstellen eines Jobs:
Wenn 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 zuzuweisen:
- Monitoring-Messwertautor (
roles/monitoring.metricWriter) für das Projekt - Logautor (
roles/logging.logWriter) für das Projekt
- Monitoring-Messwertautor (
- Achten Sie darauf, dass die geplante Jobkonfiguration die Anforderungen des Ops-Agent erfüllt.
Anforderungen des Ops-Agent
Damit Sie einen Job erstellen und ausführen können, der den Ops-Agent verwendet, muss Ihr Job alle folgenden Anforderungen erfüllen:
Die VMs des Jobs müssen ein Betriebssystem verwenden, das vom Ops-Agent unterstützt wird. Weitere Informationen zum Betriebssystem-Image für die VMs eines Jobs finden Sie unter Übersicht über die Betriebssystemumgebung für die VMs eines Jobs.
Wenn Ihr Job eine nicht standardmäßige Netzwerkkonfiguration verwendet oder VPC Service Controls nutzt, muss der Job die Zugriffsanforderungen für den Ops-Agent erfüllen. Weitere Informationen finden Sie in der Dokumentation zu Google Cloud Observability unter VMs ohne Remote-Paketzugriff.
Der Job darf keinen Legacy-Cloud Logging-Agent oder Cloud Monitoring-Agent installieren, z. B. über ein benutzerdefiniertes Image oder eine Instanzvorlage.
Weitere Informationen zu den Funktionen und Anforderungen des Ops-Agent finden Sie in der Dokumentation zu Google Cloud Observability unter Übersicht über den Ops-Agent.
Job erstellen, der den Ops-Agent automatisch installiert
Erstellen Sie mit der Google Cloud CLI oder der REST API einen Job, bei dem das
installOpsAgent Feld
im allocationPolicy.instances Feld im Hauptteil der
JSON-Datei auf true gesetzt ist:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Ein Job, der den Ops-Agent automatisch installiert, kann beispielsweise eine JSON-Konfigurationsdatei haben, die der folgenden ähnelt:
{
"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 ausgeführt werden, können Sie die Ops-Agent-Messwerte wie alle anderen Ressourcenmesswerte sehen. Weitere Informationen finden Sie unter Jobressourcen mit Messwerten überwachen und optimieren.
Nächste Schritte
- Wenn Sie Probleme beim Erstellen oder Ausführen eines Jobs haben, lesen Sie den Abschnitt zur Fehlerbehebung.
- Jobs und Aufgaben ansehen.
- Weitere Optionen zum Erstellen von Jobs .