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 Leistungsansichten der Oracle-Datenbank (z. B. V$DATABASE, V$INSTANCE und V$DATAGUARD_STATS) und Datenwörterbuchansichten (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

Hinweise

Bevor Sie den Agenten für Computing-Arbeitslasten installieren, um Ihre Oracle Database-Arbeitslasten zu überwachen, müssen die folgenden Voraussetzungen erfüllt sein:

Systemanforderungen prüfen

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 Database 19c
  • Oracle Database 23ai*
  • Enterprise-Version
  • Standardversion
  • Express-Version (kostenlos)

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.

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

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 Practices für Bereiche.

Wenn Sie Oracle-Anwendungen 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 for Compute Workloads 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 so konfigurieren, dass er mithilfe eines Paketmanagers eine Verbindung zu einer Oracle-Instanz herstellt.

Führen Sie die folgenden Schritte aus, um den Agent für Compute-Arbeitslasten zu installieren:

  1. Erstellen Sie eine Repository-Konfigurationsdatei.

    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

  2. Aktualisieren Sie die Metadaten des Paketmanagers:

    sudo yum makecache

  3. 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, prüfen Sie die Installation des Agents.

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

VM Extension Manager einrichten

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

Agent auf mehreren VMs installieren

Führen Sie die folgenden Schritte aus, um die neueste Version des Agents für Compute-Arbeitslasten auf Ihrer VM-Flotte in einer bestimmten Zone mit einer VM Extension Manager-Richtlinie zu installieren:

Console

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

    Zu den VM-Erweiterungsrichtlinien

  2. Klicken Sie auf Erweiterungsrichtlinie erstellen.

  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.

  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.

  5. 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.

  6. Wählen Sie in den Listen Region und Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen auf Erweiterung hinzufügen und gehen Sie dann so vor:

    1. Wählen Sie in der Liste Extension die Option Google Cloud's Extension for Compute Workloads aus.

    2. Lassen Sie das Feld Version leer.

      Dadurch wird die Richtlinie angewiesen, die neueste 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.

    4. Klicken Sie auf Fertig.

  8. Optional: So beschränken Sie die Einführung der Richtlinie auf die erforderlichen VMs:

    1. Klicken Sie auf Labels hinzufügen und fügen Sie die Labels hinzu, mit denen die erforderlichen VMs identifiziert werden.
    2. Klicken Sie auf Fertig.

  9. Klicken Sie auf Erstellen.

gcloud 

gcloud beta 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.

    • Alternativ können Sie die Konfiguration als Inline-String angeben. Verwenden Sie dazu 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 beides im selben Befehl.
    • Informationen zu den Konfigurationsparametern, die vom Agent für Ihre Oracle-Arbeitslast unterstützt werden, finden Sie unter Konfigurationsparameter.

  • 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 erfasst wird, 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, die die neueste Version des Agents für Compute-Arbeitslasten auf allen VMs installiert, die in der Zone us-centrail-f bereitgestellt werden. Die im agent-config.json angegebene Konfiguration wird auf den Agent angewendet.

gcloud beta 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-Installation überprüfen

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

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

  2. Prüfen Sie den Status des Agent-Pakets:

    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 for Compute Workloads 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 Messwerterfassung konfigurieren. Wenn das Flag 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 die Oracle-Erkennung 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-Datenbankinstanzen 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-Datenbankinstanz 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 Kennzeichnung des lokalen Computers an, auf dem Ihre Datenbankinstanz gehostet wird.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    Gibt den Port an, über den Ihre Oracle-Datenbankinstanz 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, aus dem das Passwort für den Nutzer abgerufen werden soll, der Anfragen an die Datenbank sendet.
    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 Compute-Arbeitslasten:

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

    2. 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

    3. Erstellen Sie als SYSDBA- oder SYSOPER-Nutzer in Oracle Database einen Nutzer für die Überwachung mit einem Passwort, das dem Secret entspricht, das Sie in den Voraussetzungen erstellt haben.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. 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;

    5. Beenden Sie sqlplus und den Nutzer oracle.

    6. Bearbeiten Sie als Root-Nutzer die Konfigurationsdatei des Agents mit Ihrem bevorzugten Editor.

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

    7. Bearbeiten Sie in der Konfigurationsdatei den Abschnitt oracle_metrics, um die folgenden Änderungen vorzunehmen:

      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 Agenten 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 ein Beispiel für eine Konfigurationsdatei:

      {
  "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"
          }
        }
      ]
    }
  }
}

    8. Speichern Sie die Konfigurationsdatei.

    9. 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 in Metrics Explorer aufrufen

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

    1. Rufen Sie in der Google Cloud Console Monitoring auf.
    2. Klicken Sie auf Metrics Explorer.
    3. Gehen Sie unter Ressourcentyp und Messwert suchen so vor:
      1. Wählen Sie unter 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 Beispiel-Dashboard 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:

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

    2. Laden Sie das oracle-status-overview.json-Dashboard aus dem GitHub-Repository für den Agenten für Computing-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

    3. 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 Prozessspeicher (PGA) in Byte.

        process/pga_memory/total_used_size

      • Prozessspeicher (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 Wartevorgänge für eine registrierte Warteklasse

        sys_wait/count

      • Aggregierte Zeit in dieser Warteklasse in Sekunden

        sys_wait/time

      • Gesamtzahl der Vordergrund-Wartevorgänge in dieser Warteklasse

        sys_wait/foreground/count

      • Aggregierte Wartezeit im Vordergrund für diese Warteklasse in Sekunden

        sys_wait/foreground/time

    • Verstrichene Systemzeit

      • Vergangene Zeit für Aufrufe auf Datenbanknutzerebene in Sekunden

        sys_time/db_time

      • Für Aufrufe auf Datenbanknutzerebene benötigte CPU-Zeit in Sekunden

        sys_time/db_cpu

      • Zeit, die für die Ausführung von SQL-Anweisungen benötigt wird

        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 aufgewendete Zeit

        sys_time/pl_sql_execution_elapsed_time

      • Verstrichene Zeit, die von Datenbank-Hintergrundprozessen verbraucht 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 Byte

        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

      • Grenzwert 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 bei der erneuten Ü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 Agent neu.

    1. Stellen Sie über SSH eine Verbindung zur VM-Instanz her.

    2. 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:

    1. Stellen Sie über SSH eine Verbindung zur VM-Instanz her.

    2. Führen Sie dazu diesen Befehl aus:

      yum info google-cloud-workload-agent

    Auf Aktualisierungen überprüfen

    1. Stellen Sie über SSH eine Verbindung zur VM-Instanz her.

    2. 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:

    1. Stellen Sie über SSH eine Verbindung zur VM-Instanz her.

    2. 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 DEBUG-Log-Level festlegen, erhalten Sie zusätzliche Informationen zur Fehlerbehebung bei bestimmten Problemen. Die Logs werden dadurch 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:

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

      Zum Log-Explorer

    2. Rufen Sie den Bereich Abfrage auf.

    3. Wählen Sie im Drop-down-Menü Ressourcen die Option Global aus und klicken Sie dann auf Übernehmen.

    4. Geben Sie im Abfrageeditor google-cloud-workload-agent ein.

    5. Klicken Sie auf Abfrage ausführen.

    Sie können die Logs ansehen, die vom Agent generiert wurden, der auf allen 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:

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

    2. Öffnen Sie die Konfigurationsdatei des Agents.

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

    3. Aktualisieren Sie für das Attribut log_to_cloud den Wert auf false.

    4. Speichern Sie die Konfigurationsdatei.

    5. Starten Sie den Agent neu, damit diese Änderung wirksam wird.

    Fehlerbehebung

    In den folgenden Abschnitten finden Sie Informationen zu häufigen Problemen im Zusammenhang mit der Verwendung des Agents für Oracle Database-Arbeitslasten, deren Ursachen und Lösungen.

    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 zur Behebung dieses Problems die Zugriffsbereiche der VM auf cloud-platform.

    Messwerte werden nicht in Cloud Monitoring angezeigt

    Problem:Messwerte des Agents für Compute-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.
    • Bei der Konfiguration des Agenten sind Fehler aufgetreten.

    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 über SSH eine Verbindung zu Ihrer VM-Instanz her.

      2. Prüfen Sie die Logs des Agents, um Fehler oder Probleme zu identifizieren, die die Erfassung von Messwerten verhindern. Die Logs finden Sie 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 anhand der Informationen unter Konfigurationsparameter, um dieses Problem zu beheben.

    Fehler beim Initialisieren der Datenerhebung

    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.