Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Agent für Oracle-Arbeitslasten einrichten

In diesem Dokument wird beschrieben, wie Sie den Agent for Compute Workloads auf Compute Engine-Instanzen installieren, konfigurieren und überprüfen, auf denen Oracle Database-Arbeitslasten ausgeführt werden.

Der Agent erfasst verschiedene Oracle-Messwerte, indem er Oracle Database-Leistungsansichten (z. B. V$DATABASE, V$INSTANCE und V$DATAGUARD_STATS) und Datendictionary-Ansichten (z. B. DBA_DATA_FILES und DBA_FREE_SPACE) abfragt. Diese Messwerte werden dann an Cloud Monitoring gesendet, wo sie visualisiert und analysiert werden können. Unterstützte Messwerte

Hinweis

Prüfen Sie vor der Installation des Agenten für Computing-Arbeitslasten zur Überwachung Ihrer Oracle Database-Arbeitslasten, ob die folgenden Voraussetzungen erfüllt sind:

Erstellen Sie eine Compute Engine-Instanz, falls Sie noch keine haben. Konfigurieren Sie Zugriffsbereiche für cloud-platform.
Root-Zugriff auf der Compute Engine-Instanz einrichten
Systemanforderungen prüfen
Weisen Sie dem Dienstkonto IAM-Rollen zu.
Aktivieren Sie die Verbindung zu Google Cloud API-Endpunkten, entweder über den Zugriff auf das öffentliche Netzwerk oder über den Zugriff auf das private Netzwerk.
Wenn Sie die Erhebung von Messwerten aktivieren möchten, erstellen Sie ein Secret in Secret Manager, um das Datenbankpasswort für den Datenbanknutzer zu speichern, der später in dieser Anleitung erstellt wird.

In den Beispielen in diesem Leitfaden gehen wir davon aus, dass es sich um wlmagent-password handelt.

Systemanforderungen ansehen

In der folgenden Tabelle sind die Oracle-Editionen aufgeführt, die Sie verwenden können, sowie die unterstützten Betriebssystemversionen:

Betriebssysteme	Oracle-Versionen	Oracle-Versionen
Red Hat Enterprise Linux-Versionen 7, 8 und 9 Oracle Linux-Versionen 7, 8 und 9	Oracle-Datenbank 19c Oracle Database 23ai* Hinweis:Der Agent wurde nicht für Oracle Database 23ai getestet, die unter Red Hat Enterprise Linux 7 oder Oracle Linux 7 ausgeführt wird.	Enterprise-Version Standardversion Express-Version (kostenlos)

Dem Dienstkonto IAM-Rollen zuweisen

Der Agent für Compute-Arbeitslasten verwendet das Dienstkonto, das an die Compute-Instanz angehängt ist, zur Authentifizierung und zum Zugriff auf Google Cloud -Ressourcen.

Zur Verbesserung der Sicherheit empfehlen wir, ein Dienstkonto für einen bestimmten Zweck anstelle des Compute Engine-Standarddienstkontos zu verwenden.

Bitten Sie Ihren Administrator, dem Dienstkonto die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, damit das Dienstkonto die erforderlichen Berechtigungen hat, damit sich Agent for Compute Workloads beiGoogle Cloud authentifizieren und auf Google Cloud -Ressourcen zugreifen kann:

Messwerte von der Compute-Instanz erfassen: Compute Viewer (roles/compute.viewer)
Daten in das Workload Manager-Data Warehouse schreiben: Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
Agent-Logs an Cloud Logging senden: Log-Autor (roles/logging.logWriter)
Wenn Sie Secret Manager zum Speichern des Passworts für die Verbindung mit der Oracle-Instanz verwenden: Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Ihr Administrator kann dem Dienstkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

Zugriff auf Cloud APIs aktivieren

Compute Engine empfiehlt, Ihre Instanzen so zu konfigurieren, dass sie allen Cloud APIs alle Zugriffsbereiche gewähren und dass Sie nur die IAM-Berechtigungen des Instanzdienstkontos verwenden, um den Zugriff aufGoogle Cloud -Ressourcen zu steuern. Weitere Informationen finden Sie unter VM mit vom Nutzer verwalteten Dienstkonto erstellen.

Wenn Sie den Zugriff auf die Cloud APIs beschränken, benötigt der Agent für Compute-Arbeitslasten mindestens die folgenden Cloud APIs-Zugriffsbereiche auf der Host-Compute-Instanz:

https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Best Practice für Bereiche.

Wenn Sie eine Oracle-Arbeitslast auf einer Compute-Instanz ausführen, die keine externe IP-Adresse hat, müssen Sie den privaten Google-Zugriff im Subnetz der Instanz aktivieren, damit der Agent für Compute-Arbeitslasten auf die Google APIs und Dienste zugreifen kann. Informationen zum Aktivieren des privater Google-Zugriff finden Sie unter Privaten Google-Zugriff konfigurieren.

Agent mit dem Paketmanager installieren und konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie den Agent for Compute Workloads auf Ihrer Compute-Instanz installieren und ihn so konfigurieren, dass er mithilfe eines Paketmanagers eine Verbindung zu einer Oracle-Instanz herstellt.

So installieren Sie den Agent for Compute Workloads:

Repository-Konfigurationsdatei erstellen

sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Workload Agent
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

Aktualisieren Sie die Metadaten des Paketmanagers:
```
sudo yum makecache
```
Installieren Sie das google-cloud-workload-agent-RPM-Paket:
```
sudo yum install google-cloud-workload-agent
```

Nachdem Sie den Agent für Oracle-Arbeitslasten installiert haben, überprüfen Sie die Installation des Agents.

Agent mithilfe von VM Extension Manager auf einer Reihe von VMs installieren und verwalten

In diesem Abschnitt erfahren Sie, wie Sie den Agent for Compute Workloads auf einer Flotte von VMs mithilfe von VM Extension Manager installieren und verwalten.

Mit der VM Extension Manager-Richtlinie können Sie unter anderem folgende Aufgaben ausführen:

Flottenweite Installation: Installieren Sie den Agenten für Computing-Arbeitslasten auf den folgenden Elementen:
- Alle VMs in Ihrem Google Cloud Projekt oder eine Teilmenge von VMs, die durch Labels identifiziert werden.
- Alle VMs in einer Zone oder eine Teilmenge von VMs, die durch Labels identifiziert werden.
Konfigurationsverwaltung: Wenden Sie eine benutzerdefinierte Konfiguration auf den Agent auf allen VMs an, die von einer Richtlinie verwaltet werden.

Weitere Informationen zu VM Extension Manager finden Sie unter VM Extension Manager.

VM Extension Manager einrichten

Führen Sie die folgenden Schritte aus, um VM Extension Manager einzurichten:

Lesen Sie in der Dokumentation zum VM Extension Manager den Abschnitt Vorbereitung.
Richten Sie die IAM-Rollen ein, die zum Erstellen und Verwalten von VM Extension Manager-Richtlinien erforderlich sind. Hier finden Sie weitere Informationen:

Agent auf einer Flotte von VMs installieren und konfigurieren

Informationen zum Installieren der neuesten Version des Agent for Compute Workloads auf Ihrer VM-Flotte mithilfe einer VM Extension Manager-Richtlinie finden Sie im entsprechenden Abschnitt:

Agent auf VMs in Ihrem Google Cloud Projekt installieren und konfigurieren
Agent auf VMs in einer bestimmten Zone installieren und konfigurieren

Agent auf VMs in Ihrem Google Cloud -Projekt installieren und konfigurieren

So installieren Sie den Agent auf allen VMs in Ihrem Google Cloud Projekt oder auf einer Teilmenge von VMs, die durch ein Label identifiziert werden, mithilfe einer VM Extension Manager-Richtlinie:

Console

Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

Zu den VM-Erweiterungsrichtlinien
Klicken Sie auf Erweiterungsrichtlinie erstellen.
Geben Sie im Feld Name einen Namen für die Richtlinie ein.
Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.
Wählen Sie im Abschnitt Bereich die Option Globaler Roll-out aus.
Klicken Sie im Abschnitt Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie dann so vor:
1. Wählen Sie in der Liste Erweiterung die Option Erweiterung von Google Cloud für Compute-Arbeitslasten aus.
2. Lassen Sie das Feld Version leer.
  
  Dadurch wird die Richtlinie angewiesen, die aktuelle Version des Agents für Compute-Arbeitslasten zu installieren.
3. Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agent anwenden möchten.
  
  Informationen zu den Konfigurationsparametern, die vom Agent für Ihre Oracle-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.
  
  Hinweis :Wenn Sie eine VM Extension Manager-Richtlinie auf VMs anwenden, auf denen der Agent for Compute Workloads bereits ausgeführt wird, werden die Version und Konfiguration des vorhandenen Agents durch die in der Richtlinie festgelegten Werte überschrieben.
  
  Die vorhandene Konfiguration des Agents wird in eine BAK-Datei im Verzeichnis /etc/google-cloud-workload-agent/ auf den jeweiligen VMs geschrieben.
4. Klicken Sie auf Fertig.
5. Wählen Sie im Feld Rollout die gewünschte Rollout-Planoption aus: Langsamer Rollout (empfohlen) oder Schneller Rollout.
  
  Weitere Informationen zu Roll-out-Plänen finden Sie unter Roll-out-Pläne.
Optional: So beschränken Sie die Einführung der Richtlinie auf die erforderlichen VMs:
1. Klicken Sie auf Labels hinzufügen und geben Sie die Labels an, mit denen die erforderlichen VMs identifiziert werden.
2. Klicken Sie auf Fertig.
Klicken Sie auf Erstellen.

gcloud

Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud compute global-vm-extension-policies create aus:

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

Ersetzen Sie Folgendes:

POLICY_NAME: Ein eindeutiger Name für die VM-Erweiterungsrichtlinie.
PROJECT_ID: die Projekt-ID desGoogle Cloud -Projekts, für das Sie die Richtlinie erstellen
ROLL_OUT_SPEED: Wie schnell Sie die Richtlinie einführen möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout. Weitere Informationen finden Sie unter Roll-out-Pläne.
Alternativ können Sie einen benutzerdefinierten Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide im selben Befehl.
DESCRIPTION: eine optionale Beschreibung der Richtlinie.
CONFIG_FILE_PATH: Der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for Compute Workloads enthält.
- Wenn Sie die Konfiguration stattdessen als Inline-String angeben möchten, verwenden Sie das Flag --config anstelle von --config-from-file. Beispiel: --config=google-cloud-workload-extension="CONFIG".
- Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.
- Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.
Hinweis: Wenn Sie eine VM Extension Manager-Richtlinie auf VMs anwenden, auf denen der Agent für Compute-Arbeitslasten bereits ausgeführt wird, werden die Version und Konfiguration des vorhandenen Agents durch die in der Richtlinie festgelegten Werte überschrieben.

Die vorhandene Konfiguration des Agents wird in eine BAK-Datei im Verzeichnis /etc/google-cloud-workload-agent/ auf den jeweiligen VMs geschrieben.
KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.
- Damit eine VM von Ihrer Richtlinie betroffen ist, muss sie alle angegebenen Labels haben.
- Wenn Sie --inclusion-labels mehrmals angeben, wird die Richtlinie auf VMs angewendet, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, wird die Richtlinie auf alle VMs im Projekt angewendet.
PRIORITY: Eine Ganzzahl zwischen 0 und 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000. Weitere Informationen finden Sie unter Richtlinienpriorität und Konfliktlösung.

Agent auf VMs in einer bestimmten Zone installieren und konfigurieren

So installieren und konfigurieren Sie die neueste Version des Agents für Compute-Arbeitslasten auf Ihrer VM-Flotte in einer bestimmten Zone mit einer VM Extension Manager-Richtlinie:

Console

Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

Zu den VM-Erweiterungsrichtlinien
Klicken Sie auf Erweiterungsrichtlinie erstellen.
Geben Sie im Feld Name einen Namen für die Richtlinie ein.
Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.
Wählen Sie in den Listen Region und Zone die Zone aus, auf die Sie diese Richtlinie anwenden möchten.
Klicken Sie im Abschnitt Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie dann so vor:
1. Wählen Sie in der Liste Erweiterung die Option Erweiterung von Google Cloud für Compute-Arbeitslasten aus.
2. Lassen Sie das Feld Version leer.
  
  Dadurch wird die Richtlinie angewiesen, die aktuelle Version des Agents für Compute-Arbeitslasten zu installieren.
3. Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agent anwenden möchten.
  
  Informationen zu den Konfigurationsparametern, die vom Agent für Ihre Oracle-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.
  
  Hinweis :Wenn Sie eine VM Extension Manager-Richtlinie auf VMs anwenden, auf denen der Agent for Compute Workloads bereits ausgeführt wird, werden die Version und Konfiguration des vorhandenen Agents durch die in der Richtlinie festgelegten Werte überschrieben.
  
  Die vorhandene Konfiguration des Agents wird in eine BAK-Datei im Verzeichnis /etc/google-cloud-workload-agent/ auf den jeweiligen VMs geschrieben.
4. Klicken Sie auf Fertig.
Optional: So beschränken Sie die Einführung der Richtlinie auf die erforderlichen VMs:
1. Klicken Sie auf Labels hinzufügen und geben Sie die Labels an, mit denen die erforderlichen VMs identifiziert werden.
2. Klicken Sie auf Fertig.
Klicken Sie auf Erstellen.

gcloud

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Ersetzen Sie Folgendes:

POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.

Der Befehl schlägt fehl, wenn in der Zone bereits eine Richtlinie mit dem angegebenen Namen vorhanden ist.
ZONE: die Zone, in der Sie diese Richtlinie anwenden möchten.
CONFIG_FILE_PATH: Der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for Compute Workloads enthält, um eine Verbindung zu Ihrer Oracle-Arbeitslast herzustellen.
- Wenn Sie die Konfiguration stattdessen als Inline-String angeben möchten, verwenden Sie das Flag --config anstelle von --config-from-file. Beispiel: --config=google-cloud-workload-extension="CONFIG". Google Cloud empfiehlt die Verwendung von --config-from-file.
- Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.
- Informationen zu den Konfigurationsparametern, die vom Agent für Ihre Oracle-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.
Hinweis: Wenn Sie eine VM Extension Manager-Richtlinie auf VMs anwenden, auf denen der Agent für Compute-Arbeitslasten bereits ausgeführt wird, werden die Version und Konfiguration des vorhandenen Agents durch die in der Richtlinie festgelegten Werte überschrieben.

Die vorhandene Konfiguration des Agents wird in eine BAK-Datei im Verzeichnis /etc/google-cloud-workload-agent/ auf den jeweiligen VMs geschrieben.
DESCRIPTION: eine optionale Beschreibung der Richtlinie.
KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.
- Damit eine VM von Ihrer Richtlinie betroffen ist, muss sie alle angegebenen Labels haben.
- Wenn Sie --inclusion-labels mehrmals angeben, richtet sich die Richtlinie an VMs, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, richtet sich die Richtlinie an alle VMs in der angegebenen Zone.
PRIORITY: Eine Ganzzahl zwischen 0 und 65535, die die Priorität der Richtlinie definiert. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1000.

Beispiel:

Mit dem folgenden Befehl wird eine Richtlinie mit dem Namen test-agent-policy im ProjektGoogle Cloud mit dem Namen test-project erstellt, mit der die neueste Version des Agents für Compute-Arbeitslasten auf allen VMs installiert wird, die in der Zone us-centrail-f bereitgestellt werden. Die in agent-config.json angegebene Konfiguration wird auf den Agent angewendet.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

Agent auf einer Reihe von VMs verwalten

Wenn Sie ändern möchten, wie eine VM Extension Manager-Richtlinie den Agent for Compute Workloads verwaltet, aktualisieren Sie die Richtlinie. Wenn Sie eine Richtlinie aktualisieren, führt VM Extension Manager die Änderungen für alle entsprechenden VMs aus. Das dauert in der Regel etwa eine Minute. Wenn Sie Einschlusslabels ändern, wird der Agent for Compute Workloads möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob die VMs den aktualisierten Labels entsprechen.

In den folgenden Abschnitten wird beschrieben, wie Sie den Agent for Compute Workloads verwalten, um Folgendes zu tun:

Agent-Konfiguration auf einer Reihe von VMs ändern
Globale Richtlinie aktualisieren, um neue Zonen einzuschließen
Globale Richtlinie aktualisieren, um Zonen auszuschließen

Agent-Konfiguration auf einer Reihe von VMs ändern

Wenn Sie die Konfiguration von Agent for Compute Workloads-Instanzen ändern möchten, die Sie mithilfe einer VM Extension Manager-Richtlinie auf Ihrer VM-Flotte installiert haben, müssen Sie diese Richtlinie bearbeiten.

Führen Sie die folgenden Schritte aus, um die Agent-Konfiguration für Ihre VM-Flotte zu ändern:

Console

Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

Zu den VM-Erweiterungsrichtlinien
Klicken Sie auf die Richtlinie, die Sie ändern möchten.
Klicken Sie auf der Seite Details zur Erweiterungsrichtlinie auf Bearbeiten.
Aktivieren oder deaktivieren Sie im Bereich Erweiterungen verwalten die Option Erweiterung von Google Cloud für Compute-Arbeitslasten.
Geben Sie im Feld Inhalt der Konfigurationsdatei die Konfiguration ein, die Sie auf den Agent anwenden möchten.

Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.
Klicken Sie auf Fertig.
Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl gcloud compute zone-vm-extension-policies update aus, um die Konfiguration des Agenten für Computing-Arbeitslasten auf Ihrer VM-Flotte zu ändern. Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Anfrage als vollständiger Ersatz behandelt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt. Vorhandene Werte aus der geänderten Richtlinie werden nicht beibehalten.

So ändern Sie die Agent-Konfiguration:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY_NUMBER \]
    [--description="DESCRIPTION"]

Ersetzen Sie Folgendes:

POLICY_NAME: Der Name der VM-Erweiterungsrichtlinie, die Sie ändern möchten.
ZONE: die Google Cloud Zone, in der die Richtlinie gilt.
CONFIG_FILE_PATH: Der lokale Pfad zur JSON-Datei, die die Konfiguration für den Agent for Compute Workloads enthält.
- Sie können die Agentenkonfiguration auch als Inline-String bereitstellen, indem Sie das Flag --config anstelle von --config-from-file verwenden. Beispiel: --config=google-cloud-workload-extension="CONFIG". Google Cloud empfiehlt die Verwendung von --config-from-file.
- Sie können entweder --config-from-file oder --config verwenden, aber nicht beide im selben Befehl.
- Informationen zu den vom Agent unterstützten Konfigurationsparametern finden Sie unter Konfigurationsparameter.
KEY_1=VALUE_1: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die die Labels definieren, mit denen die Richtlinie auf VMs ausgerichtet wird.
- Damit eine VM von Ihrer Richtlinie betroffen ist, muss sie alle angegebenen Labels haben.
- Wenn Sie --inclusion-labels mehrmals angeben, richtet sich die Richtlinie an VMs, die einen der angegebenen Selektoren erfüllen (logisches OR). Wenn Sie dieses Flag weglassen, richtet sich die Richtlinie an alle VMs in der angegebenen Zone.
PRIORITY_NUMBER: die Priorität, die Sie für Ihre Richtlinie festlegen möchten. Sie können eine Ganzzahl zwischen 0 und 65535 angeben.
DESCRIPTION: Eine Beschreibung der VM-Erweiterungsrichtlinie.

Globale Richtlinie aktualisieren, um neue Zonen einzuschließen

Wenn Sie VMs in einer neuen Zone erstellen, nachdem Sie eine globale Richtlinie erstellt und eingeführt haben, wendet VM Extension Manager die Richtlinie nicht automatisch auf die VMs in den neuen Zonen an. Wenn Sie die VMs in neue Zonen aufnehmen möchten, müssen Sie die globale Richtlinie neu bereitstellen.

So starten Sie die Bereitstellung einer globalen Richtlinie neu:

Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud compute global-vm-extension-policies update aus und geben Sie die Option --rollout-entry-uuid so an:
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID
```
Ersetzen Sie Folgendes:
- UUID: Eine Universally Unique Identifier (UUID), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen.
- ROLL_OUT_SPEED: Wie schnell Sie die Richtlinie einführen möchten. Die unterstützten Werte sind slow_rollout (empfohlen) und fast_rollout. Weitere Informationen finden Sie unter Roll-out-Pläne.
- Alternativ können Sie einen benutzerdefinierten Roll-out-Plan verwenden, indem Sie die Option --rollout-custom-plan angeben. Weitere Informationen finden Sie unter Roll-out-Pläne.
- Sie können entweder --rollout-predefined-plan oder --rollout-custom-plan verwenden, aber nicht beide im selben Befehl.

Globale Richtlinie aktualisieren, um Zonen auszuschließen

So aktualisieren Sie eine globale Richtlinie, um Zonen auszuschließen:

Führen Sie in Ihrem Terminal oder in Cloud Shell den Befehl gcloud compute global-vm-extension-policies update aus und geben Sie einen benutzerdefinierten Rollout-Plan an, in dem die Zonen angegeben sind, in denen die Richtlinie angewendet werden soll:
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID
```
Ersetzen Sie Folgendes:
- NEW_CUSTOM_PLAN_NAME: Der Name des neuen benutzerdefinierten Rolloutplans, der die Zonen angibt, in denen die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Rollout-Pläne finden Sie unter Rollout-Pläne.
- UUID: Eine Universally Unique Identifier (UUID), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen.

Agent von einer VM-Flotte deinstallieren

Wenn Sie den Agent for Compute Workloads von Ihren VMs deinstallieren möchten, müssen Sie die VM Extension Manager-Richtlinie löschen, mit der die VMs verwaltet werden.

Wenn beim Löschen einer Richtlinie eine andere aktive Richtlinie mit niedrigerer Priorität auf eine VM angewendet wird und den Agent for Compute Workloads deklariert, bleibt der Agent basierend auf der Richtlinie mit niedrigerer Priorität auf dieser VM installiert.

VM Extension Manager entfernt den Agent innerhalb einer Minute nach dem Löschen der Richtlinie von allen zugänglichen VMs. Wenn auf eine VM nicht zugegriffen werden kann, weil der Gast-Agent entfernt oder die VM gelöscht wurde, überspringt VM Extension Manager das Löschen des Agents für Compute-Arbeitslasten. Wenn eine solche VM wieder verfügbar ist, entfernt VM Extension Manager den Agent for Compute Workloads zu diesem Zeitpunkt.

So deinstallieren Sie den Agent for Compute Workloads von Ihrer VM-Flotte:

Console

Rufen Sie in der Google Cloud Console die Seite VM-Erweiterungsrichtlinien auf.

Zu den VM-Erweiterungsrichtlinien
Klicken Sie auf die Richtlinie, mit der der Agent für Computing-Arbeitslasten in Ihrer VM-Flotte verwaltet wird.
Klicken Sie auf der Seite Details zur Erweiterungsrichtlinie auf Löschen und bestätigen Sie die Löschung.

gcloud

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Ersetzen Sie Folgendes:

POLICY_NAME: Der Name der VM-Erweiterungsrichtlinie, die Sie löschen möchten.
PROJECT_ID: Die ID des Google Cloud Projekts, in dem sich die Richtlinie befindet.
ZONE: die Google Cloud Zone, in der sich die Richtlinie befindet.

Agent-Installation überprüfen

So prüfen Sie, ob der Agent wie erwartet ausgeführt wird:

Stellen Sie eine SSH-Verbindung zu Ihrer Compute-Instanz her.

Status des Agent-Pakets prüfen:

systemctl status google-cloud-workload-agent

Wenn das Agent-Paket wie erwartet ausgeführt wird, enthält die Ausgabe active (running). Beispiel:

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Konfigurationsparameter

Der Agent für Computing-Arbeitslasten unterstützt die folgenden Konfigurationsparameter für Oracle:

Parameter		Beschreibung
`log_level`	`String` Fügen Sie die Logebenen hinzu, um die Logebene des Agents festzulegen. Folgende Logebenen sind verfügbar: `DEBUG` `INFO` `WARNING` `ERROR` Der Standardwert ist `INFO`.
`log_to_cloud`	`Boolean` Geben Sie `true` an, um die Logs des Agents an Cloud Logging weiterzuleiten. Der Standardwert ist `true`.
`oracle_configuration.enabled`	`Boolean` Optional. Gibt an, ob der Oracle-Dienst aktiv ist. Wenn der Wert auf `true` festgelegt ist oder nicht festgelegt ist und die Arbeitslast vorhanden ist, können Sie die Erkennung und die Erfassung von Messwerten konfigurieren. Wenn der Wert auf `false` gesetzt ist, werden der Oracle-Dienst und die zugehörigen Funktionen deaktiviert.
Die folgenden untergeordneten Parameter gelten nur, wenn Sie `oracle_configuration.enabled: true` angeben.
`oracle_configuration.oracle_discovery.enabled`	`Boolean` Optional. Gibt an, ob Oracle Discovery aktiv ist. Der Standardwert ist `true`.
`oracle_configuration.oracle_discovery.update_frequency`	`Int` Optional. Geben Sie das Abtastintervall in Sekunden an, das die Häufigkeit bestimmt, mit der der Agent für Computing-Arbeitslasten den Erkennungsprozess ausführt. Der Standardwert beträgt 3.600 Sekunden (1 Stunde). Der Wert muss mit einem Kleinbuchstaben „s“ enden, um Sekunden anzugeben. Beispiel: `30s`.
`oracle_configuration.oracle_metrics.enabled`	`Boolean` Optional. Geben Sie `true` an, damit der Agent für Compute-Arbeitslasten die Oracle-Monitoring-Messwerte erfassen kann. Der Standardwert ist `false`.
Die folgenden untergeordneten Parameter gelten nur, wenn Sie `oracle_metrics.enabled: true` angeben.
`oracle_configuration.oracle_metrics.collection_frequency`	`Int` Optional. Geben Sie das Abtastintervall in Sekunden an, das die Häufigkeit bestimmt, mit der der Agent für Compute-Arbeitslasten Ihre Oracle-Datenbankinstanzen abfragt, um die Oracle-Monitoring-Messwerte zu erfassen. Der Standardwert beträgt 60 Sekunden. Der Wert muss mit einem Kleinbuchstaben „s“ enden, um Sekunden anzugeben. Beispiel: `30s`.
`oracle_configuration.oracle_metrics.query_timeout`	`String` Optional. Geben Sie das Zeitlimit für jede Abfrage an die Oracle Database-Instanzen an. Der Standardwert beträgt 10 Sekunden. Der Wert muss mit einem Kleinbuchstaben „s“ enden, um Sekunden anzugeben. Beispiel: `30s`.
`oracle_configuration.oracle_metrics.connection_parameters.username`	`String` Gibt das Nutzerkonto an, das zum Abfragen der Oracle Database-Instanz verwendet wird. Achten Sie darauf, dass dieser Nutzer die erforderlichen Berechtigungen zum Lesen der Leistungsansichten in Ihrer Oracle-Datenbank hat.
`oracle_configuration.oracle_metrics.connection_parameters.host`	`String` Gibt die Kennung des lokalen Computers an, auf dem Ihre Datenbankinstanz gehostet wird.
`oracle_configuration.oracle_metrics.connection_parameters.port`	`Int` Gibt den Port an, über den die Oracle Database-Instanz Abfragen akzeptiert.
`oracle_configuration.oracle_metrics.connection_parameters.service_name`	`String` Gibt den Dienstnamen für Ihre Oracle-Datenbankinstanz an, die vom Agent überwacht werden soll.
`oracle_configuration.oracle_metrics.connection_parameters.secret.project_id`	`String` Gibt die Projekt-ID des Secret Manager an, um das Passwort für den Nutzer abzurufen, der Anfragen an die Datenbank stellt.
`oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name`	`String` Gibt den Namen des Secrets im Secret Manager an, in dem das Passwort des Nutzerkontos gespeichert ist.

Oracle-Messwerte erfassen und ansehen

Sie können die Erfassung von Messwerten für Oracle Database-Arbeitslasten aktivieren. Unterstützte Messwerte

Messwerterfassung aktivieren

So aktivieren Sie die Erfassung von Oracle-Messwerten mit dem Agenten für Computing-Arbeitslasten:

Stellen Sie eine SSH-Verbindung zu Ihrer VM-Instanz her.
Führen Sie als Oracle OS-Nutzer das Tool oraenv aus, um die Umgebungsvariablen festzulegen. Wir gehen davon aus, dass Sie den Nutzer oracle und die ORACLE_SID bereits in der Datei /etc/oratab definiert haben.
```
sudo su - oracle
export PATH=$PATH:/usr/local/bin
. oraenv
sqlplus / as sysdba
```
Erstellen Sie als SYSDBA- oder SYSOPER-Nutzer in Oracle Database einen Nutzer für das Monitoring mit einem Passwort, das dem Secret entspricht, das Sie in den Voraussetzungen erstellt haben.

Hinweis :Wenn Sie eine Oracle Multitenant-Containerdatenbank haben, stellen Sie dem Nutzernamen das common_user_prefix voran, in der Regel c##, um einen gemeinsamen Nutzer zu erstellen. Aus wlmagent wird beispielsweise c##wlmagent.
```
CREATE USER wlmagent IDENTIFIED BY password;
```
Als SYSDBA- oder SYSOPER-Nutzer müssen Sie dem Monitoring-Nutzer die folgenden Berechtigungen erteilen, damit er Leistungsansichten abfragen kann:
- SESSION
- SELECT_CATALOG_ROLE
- SYSDG
```
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;
```
Beenden Sie sqlplus und den Nutzer oracle.
Bearbeiten Sie als Root-Nutzer die Konfigurationsdatei des Agenten mit dem Editor Ihrer Wahl.
```
sudo nano /etc/google-cloud-workload-agent/configuration.json
```
Nehmen Sie in der Konfigurationsdatei im Abschnitt oracle_metrics die folgenden Änderungen vor:
1. Setzen Sie den Parameter enabled auf true.
2. Legen Sie den Parameter service_name fest, um den Dienstnamen der Oracle-Instanz anzugeben, die vom Agent überwacht werden soll.
3. Geben Sie den Oracle-Nutzernamen an, mit dem der Agent eine Verbindung zu Ihrer Datenbank herstellen soll.
4. Legen Sie die Parameter host und port für den Agent fest, damit er eine Verbindung zu Ihrer Datenbank herstellen kann.
5. Legen Sie den Parameter secret für den Agent fest, damit er ein Passwort für den Nutzernamen abrufen kann:
  - project_id: Die ID des Projekts, das die Secret Manager-Daten enthält.
  - secret_name: Der Name des Secrets im Secret Manager.
Hier sehen Sie eine Beispielkonfigurationsdatei:
```
{
  "log_level": "INFO",
  "common_discovery": {"collection_frequency": "3600s" },
  "oracle_configuration": {
    "enabled": true,
    "oracle_metrics": {
      "enabled": true,
      "collection_frequency": "30s",
      "connection_parameters": [
        {
          "host": "localhost",
          "port": 1521,
          "service_name": "orcl",
          "username": "wlmagent",
          "secret": {
            "project_id": "my-project",
            "secret_name": "wlmagent_password"
          }
        }
      ]
    }
  }
}
```
Speichern Sie die Konfigurationsdatei.
Starten Sie den Agent neu, damit die neuen Einstellungen wirksam werden.

Messwerte aufrufen

Sie können die erfassten Messwerte aufrufen und die Oracle-Leistung und den Oracle-Status entweder über den Metrics Explorer oder durch Importieren eines benutzerdefinierten Dashboards überwachen.

Messwerte im Metrics Explorer aufrufen

So rufen Sie die Oracle-Messwerte im Metrics Explorer auf:

Rufen Sie in der Google Cloud Console Monitoring auf.
Klicken Sie auf Metrics Explorer.
Gehen Sie unter Ressourcentyp und Messwert finden so vor:
1. Wählen Sie als Ressourcentyp die Option VM-Instanz aus.
2. Wählen Sie unter Messwert die Oracle-Messwerte aus, die Sie sehen möchten.

Sie können Echtzeit- und Verlaufsdaten für die ausgewählten Oracle-Messwerte ansehen und bei Bedarf Filter und Aggregation verwenden.

Benutzerdefiniertes Dashboard importieren

Wenn Sie die vom Agent erfassten Oracle-Messwerte ansehen möchten, können Sie benutzerdefinierte Cloud Monitoring-Dashboards erstellen. Folgen Sie dazu der Anleitung unter Benutzerdefinierte Dashboards erstellen und verwalten.

Wir stellen ein Beispieldashboard oracle-status-overview.json und eine Anleitung zum Importieren zur Verfügung. Das oracle-status-overview.json-Dashboard enthält die folgenden Diagramme mit Oracle-Messwerten:

Aufschlüsselung der Datenbankzeit
Arbeitsspeichernutzung der Datenbank
Durchschnittliche aktive Sitzungen nach Warteklasse
Laufwerk-E/A
CPU-Auslastung
Netzwerktraffic

So importieren Sie das oracle-status-overview.json-Dashboard:

Prüfen Sie, ob die gcloud CLI installiert und auf dem neuesten Stand ist. Eine Anleitung finden Sie unter gcloud CLI installieren.

Laden Sie das Dashboard oracle-status-overview.json aus dem GitHub-Repository des Agenten für Compute-Arbeitslasten herunter:

$ curl -H "Accept: application/vnd.github.v3.raw" -o oracle-status-overview.json https://api.github.com/repos/GoogleCloudPlatform/workloadagent/contents/observability/dashboards/oracle-status-overview.json

Führen Sie den folgenden Befehl aus, um das Dashboard zu importieren:
```
gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json
```
Nachdem der Befehl ausgeführt wurde, wird das benutzerdefinierte Dashboard in Cloud Monitoring erstellt. Informationen zum Aufrufen eines Dashboards finden Sie unter Dashboard suchen und aufrufen.

Unterstützte Messwerte

Alle Oracle-Messwerte, die vom Agenten für Compute-Arbeitslasten erfasst werden, sind unter dem Pfad workload.googleapis.com/oracle verfügbar.

Im Folgenden finden Sie eine Liste der unterstützten Oracle-Messwerte und der entsprechenden Cloud Monitoring-Pfade:

Prozessspeicher
- Verwendeter Prozessarbeitsspeicher (PGA) in Byte.
  
  process/pga_memory/total_used_size
- Prozessarbeitsspeicher (PGA) zugewiesen, in Byte
  
  process/pga_memory/total_allocated_size
Geteilte Erinnerung
- Größe des Elements im gemeinsamen Arbeitsspeicher (SGA) in Byte
  
  process/sga_memory/size
System-Warteereignisse
- Gesamtzahl der Wartezeiten für eine registrierte Warteklasse
  
  sys_wait/count
- Aggregierte Zeit in dieser Warteklasse in Sekunden
  
  sys_wait/time
- Gesamtzahl der Wartevorgänge im Vordergrund in dieser Warteklasse
  
  sys_wait/foreground/count
- Aggregierte Wartezeit im Vordergrund für diese Warteklasse in Sekunden
  
  sys_wait/foreground/time
Verstrichene Systemzeit
- Die verstrichene Zeit für Datenbankaufrufe auf Nutzerebene in Sekunden.
  
  sys_time/db_time
- CPU-Zeit für Aufrufe auf Datenbanknutzerebene in Sekunden
  
  sys_time/db_cpu
- Dauer der Ausführung von SQL-Anweisungen
  
  sys_time/sql_execute_elapsed_time
- Zeitaufwand für das Parsen von SQL-Anweisungen
  
  sys_time/parse_time_elapsed
- Die für die Ausführung des PL/SQL-Interpreters benötigte Zeit
  
  sys_time/pl_sql_execution_elapsed_time
- Verstrichene Zeit, die von Datenbank-Hintergrundprozessen in Anspruch genommen wurde, in Sekunden
  
  sys_time/background_elapsed_time
E/A-Statistiken
- Gesamtzahl der Lesevorgänge (klein + groß)
  
  iostat/read_ops_count
- Gesamtzahl der Schreibvorgänge (klein + groß)
  
  iostat/write_ops_count
- Gesamtzahl der gelesenen Byte
  
  iostat/read_bytes_count
- Gesamtzahl der geschriebenen Bytes
  
  iostat/write_bytes_count
- Durchschnittliche Latenz pro E/A-Vorgang
  
  iostat/average_latency_seconds
Datendateien
- Zugewiesene Größe der Datendatei in Byte
  
  data_files/total_bytes
- Verwendeter Speicherplatz für Datendateien in Byte
  
  data_files/bytes_used
- Freier Speicherplatz in der Datendatei in Byte
  
  data_files/available_bytes
- Limit für die automatische Erweiterung von Datendateien in Byte
  
  data_files/max_bytes
- Prozentsatz der verwendeten Datendatei
  
  data_files/percent_used
Datenbankinstanz
- Instanzverfügbarkeit in Sekunden
  
  instance/uptime
- Instanzstatus
  
  instance/status
  
  Dieser Messwert kann die folgenden Werte haben:
  
  UNKNOWN 0
  
  STARTED 1
  
  MOUNTED 2
  
  OPEN 3
  
  OPEN MIGRATE 4
- Offener Modus
  
  instance/db_open_mode
  
  Dieser Messwert kann die folgenden Werte haben:
  
  UNKNOWN 0
  
  MOUNTED 1
  
  READ WRITE 2
  
  READ ONLY 3
  
  READ ONLY WITH APPLY 4
Oracle Data Guard
- Verzögerung beim Anwenden von „Wiederholen“ in Sekunden
  
  dataguard/apply_lag
- Verzögerung für erneute Übertragung in Sekunden
  
  dataguard/transport_lag

Agent verwalten

Agent neu starten

Wenn der Agent für Compute-Arbeitslasten nicht mehr funktioniert oder Sie seine Konfiguration aktualisieren, starten Sie den Agenten neu.

Stellen Sie mit SSH eine Verbindung zur VM-Instanz her.

Führen Sie dazu diesen Befehl aus:

sudo systemctl restart google-cloud-workload-agent

Version des Agents prüfen

Führen Sie folgende Schritte aus, um die Version Ihres Agents zu prüfen:

Stellen Sie mit SSH eine Verbindung zur VM-Instanz her.
Führen Sie dazu diesen Befehl aus:
```
yum info google-cloud-workload-agent
```

Auf Aktualisierungen überprüfen

Stellen Sie mit SSH eine Verbindung zur VM-Instanz her.

Führen Sie dazu diesen Befehl aus:

sudo yum check-update google-cloud-workload-agent

Agent aktualisieren

Um sicherzustellen, dass Sie die neueste Version des Agents verwenden, sollten Sie regelmäßig nach Updates suchen und den Agent aktualisieren:

Stellen Sie mit SSH eine Verbindung zur VM-Instanz her.

Führen Sie dazu diesen Befehl aus:

sudo yum --nogpgcheck update google-cloud-workload-agent

Agent-Logs ansehen

Die Logs des Agenten für Computing-Arbeitslasten sind unter /var/log/google-cloud-workload-agent.log verfügbar.

Die Ausführlichkeit der Protokolle wird über den Parameter log_level gesteuert. Wenn Sie den Log-Level von DEBUG festlegen, sind zusätzliche Informationen zur Fehlerbehebung bei bestimmten Problemen enthalten. Die Logs sind dann aber deutlich größer.

Standardmäßig werden die Logs für den Agent für Compute-Arbeitslasten von Ihren VM-Instanzen zu Cloud Logging umgeleitet.

So rufen Sie die Logs des Agents in Logging auf:

Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

Zum Log-Explorer
Rufen Sie den Bereich Abfrage auf.
Wählen Sie im Drop-down-Menü Ressourcen die Option Global aus und klicken Sie dann auf Übernehmen.
Geben Sie im Abfrageeditor google-cloud-workload-agent ein.
Klicken Sie auf Abfrage ausführen.

Sie können die Logs ansehen, die vom Agent generiert wurden, der auf allen Ihren VM-Instanzen ausgeführt wird. Sie können die Logs nach einer bestimmten Instanz filtern.

Agent-Logs in Cloud Logging konfigurieren

So deaktivieren Sie die Standardweiterleitung der Agent-Logs an Cloud Logging:

Stellen Sie eine SSH-Verbindung zu Ihrer VM-Instanz her.

Öffnen Sie die Konfigurationsdatei des Agents.

/etc/google-cloud-workload-agent/configuration.json

Aktualisieren Sie für das Attribut log_to_cloud den Wert auf false.
Speichern Sie die Konfigurationsdatei.
Starten Sie den Agent neu, damit diese Änderung wirksam wird.

Fehlerbehebung

In den folgenden Abschnitten finden Sie Informationen zu häufigen Problemen bei der Verwendung des Agents für Oracle Database-Arbeitslasten, zu ihren Ursachen und zur Fehlerbehebung.

Unzureichende IAM-Berechtigungen

Problem: Die Logs des Agenten für Compute-Arbeitslasten zeigen einen Fehler an, der unzureichende IAM-Berechtigungen angibt.

googleapi: Error 403: The client is not authorized to make this request.

Ursache:Das vom Agent verwendete Dienstkonto hat nicht die erforderlichen IAM-Berechtigungen für den Zugriff auf die Google Cloud APIs oder ein Passwort für den Oracle-Nutzer im Secret Manager.

Lösung:Achten Sie darauf, dass das VM-Dienstkonto die in den Voraussetzungen genannten IAM-Rollen und Berechtigungen hat.

Unzureichende Authentifizierungsbereiche

Problem:Die Logs des Agents für Compute-Arbeitslasten zeigen unzureichende Authentifizierungsbereiche an.

googleapi: Error 403: Request had insufficient authentication scopes.

Ursache:Das vom Agent verwendete Dienstkonto hat nicht den erforderlichen Zugriffsbereich.

Lösung: Konfigurieren Sie die Zugriffsbereiche der VM auf cloud-platform, um dieses Problem zu beheben.

Messwerte werden nicht in Cloud Monitoring angezeigt

Problem:Messwerte des Agenten für Computing-Arbeitslasten sind in Cloud Monitoring nicht sichtbar.

Ursache:

Mögliche Ursachen für dieses Problem:

Dem vom Agent for Compute Workloads verwendeten Dienstkonto fehlen die erforderlichen IAM-Berechtigungen.
Der vom Agent verwendete Oracle-Nutzer hat nicht die erforderlichen Berechtigungen, um Leistungsansichten abzufragen.
Die Konfiguration des Agenten enthält Fehler.

Lösung:

So beheben Sie das Problem mit den unzureichenden Berechtigungen für das Dienstkonto:
1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzdetails auf und notieren Sie sich das Dienstkonto, das von der Instanz verwendet wird, auf der der Agent ausgeführt wird.
2. Rufen Sie die Seite IAM & Verwaltung auf und prüfen Sie, ob das Dienstkonto alle in den Voraussetzungen genannten erforderlichen Rollen und Berechtigungen hat. Weisen Sie dem Dienstkonto alle erforderlichen fehlenden Rollen zu.
So beheben Sie das Problem mit den unzureichenden Berechtigungen für den Oracle-Nutzer:
1. Prüfen Sie, ob der Oracle-Nutzer die folgenden erforderlichen Berechtigungen zum Abfragen von Leistungsansichten hat:
  - SESSION
  - SELECT_CATALOG_ROLE
  - SYSDG
2. Erteilen Sie alle fehlenden Berechtigungen, indem Sie den folgenden SQL-Befehl ausführen:
```
-- Grant the "wlmagent" user the required permissions
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;
```
So beheben Sie das Problem mit der Fehlkonfiguration des Agents:
1. Stellen Sie eine SSH-Verbindung zu Ihrer VM-Instanz her.
2. Sehen Sie sich die Logs des Agents an, um Fehler oder Probleme zu identifizieren, die die Erfassung von Messwerten verhindern. Sie finden die Protokolle unter /var/log/google-cloud-workload-agent.log.
  
  Suchen Sie nach Berechtigungsfehlern, Fehlkonfigurationen oder Verbindungsproblemen.
3. Beheben Sie alle Fehler.
4. Starten Sie den Agent neu und prüfen Sie, ob die Erfassung von Messwerten beginnt.

Konfigurationsdatei konnte nicht geladen werden

Problem:Wenn die Konfigurationsdatei ungültige Werte enthält, wird der folgende Fehler angezeigt.

"Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown
field "{field_name}"

Lösung:Aktualisieren Sie die Konfigurationsdatei mit den Details unter Konfigurationsparameter, um dieses Problem zu beheben.

Datenerhebung konnte nicht initialisiert werden

Problem:Nach der Installation des Agents wird die Konfigurationsdatei nicht aktualisiert und Sie sehen den folgenden Fehler:

"Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"

Lösung: Initialisieren Sie die Anmeldedatenkonfiguration mit Konfigurationsparametern, um dieses Problem zu beheben.

`UNKNOWN`	`0`
`STARTED`	`1`
`MOUNTED`	`2`
`OPEN`	`3`
`OPEN MIGRATE`	`4`

`UNKNOWN`	`0`
`MOUNTED`	`1`
`READ WRITE`	`2`
`READ ONLY`	`3`
`READ ONLY WITH APPLY`	`4`

Agent für Oracle-Arbeitslasten einrichten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Systemanforderungen ansehen

Dem Dienstkonto IAM-Rollen zuweisen

Zugriff auf Cloud APIs aktivieren

Agent mit dem Paketmanager installieren und konfigurieren

Agent mithilfe von VM Extension Manager auf einer Reihe von VMs installieren und verwalten

VM Extension Manager einrichten

Agent auf einer Flotte von VMs installieren und konfigurieren

Agent auf VMs in Ihrem Google Cloud -Projekt installieren und konfigurieren

Console

gcloud

Agent auf VMs in einer bestimmten Zone installieren und konfigurieren

Console

gcloud

Agent auf einer Reihe von VMs verwalten

Agent-Konfiguration auf einer Reihe von VMs ändern

Console

gcloud

Globale Richtlinie aktualisieren, um neue Zonen einzuschließen

Globale Richtlinie aktualisieren, um Zonen auszuschließen

Agent von einer VM-Flotte deinstallieren

Console

gcloud

Agent-Installation überprüfen

Konfigurationsparameter

Oracle-Messwerte erfassen und ansehen

Messwerterfassung aktivieren

Messwerte aufrufen

Messwerte im Metrics Explorer aufrufen

Benutzerdefiniertes Dashboard importieren

Unterstützte Messwerte

Agent verwalten

Agent neu starten

Version des Agents prüfen

Auf Aktualisierungen überprüfen

Agent aktualisieren

Agent-Logs ansehen

Agent-Logs in Cloud Logging konfigurieren

Fehlerbehebung

Unzureichende IAM-Berechtigungen

Unzureichende Authentifizierungsbereiche

Messwerte werden nicht in Cloud Monitoring angezeigt

Konfigurationsdatei konnte nicht geladen werden

Datenerhebung konnte nicht initialisiert werden

Agent für Oracle-Arbeitslasten einrichten