Agent für Oracle einrichten

Sie können den Google Cloud-Agent für Compute-Arbeitslasten auf dem Host neben Ihrer Oracle-Datenbank einrichten, um Messwerte zu erfassen und Ihre Oracle-Datenbankarbeitslasten zu überwachen.

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

Systemanforderungen

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)

Vorbereitung

Bevor Sie den Agent for Compute Workloads installieren, um Ihre Oracle Database-Arbeitslasten zu überwachen, müssen die folgenden Voraussetzungen erfüllt sein:

Agent installieren

So installieren Sie den Agent für Compute-Arbeitslasten:

  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
    

Prüfen Sie nach der Installation des Agents für Oracle die Installation des Agents.

Agent-Installation überprüfen

Wählen Sie Ihr Betriebssystem aus und führen Sie die folgenden Schritte aus, um zu prüfen, ob der Agent ausgeführt wird:

  1. Stellen Sie über SSH eine Verbindung zu Ihrer VM-Instanz her.
  2. Führen Sie dazu diesen Befehl aus:

    systemctl status google-cloud-workload-agent
    

    Wenn der Agent ordnungsgemäß funktioniert, enthält die Ausgabe active (running). Beispiel:

    google-cloud-workload-agent.service - Google Cloud Workload Agent
    Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; preset: disabled)
    Active: active (running) since Tue 2024-09-03 22:29:57 UTC; 3s ago
    Main PID: 274972 (google_cloud_wo)
     Tasks: 10 (limit: 100440)
    Memory: 51.2M (max: 1.0G limit: 1.0G available: 972.7M)
       CPU: 625ms
    CGroup: /system.slice/google-cloud-workload-agent.service
           └─274972 /usr/bin/google_cloud_workload_agent startdaemon
    
    Sep 03 22:29:57 my_gce_instance systemd[1]: Started Google Cloud Workload Agent.
    

    Wenn der Agent nicht ausgeführt wird, starten Sie den Agent neu.

Agent konfigurieren

Nachdem Sie den Agent für Compute Workloads installiert haben, können Sie optional weitere Funktionen des Agents aktivieren, indem Sie die Konfigurationsdatei des Agents aktualisieren. Eine Liste der Parameter, die Sie für Oracle Database-Arbeitslasten konfigurieren können, finden Sie unter Konfigurationsparameter.

Nachdem Sie den Agent konfiguriert haben, können Sie noch einmal die Installation prüfen, um sicherzustellen, dass der Agent richtig konfiguriert ist.

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 Erfassung von Messwerten 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 Compute-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-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, mit der das Passwort für den Nutzer abgerufen wird, 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 Agent for Compute Workloads:

  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 mit dem 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. Im Dashboard oracle-status-overview.json werden die folgenden Oracle-Messwertdiagramme angezeigt:

  • 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 „Agent for Compute Workloads“ 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 Agent for Compute Workloads 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, die in dieser Warteklasse verbracht wurde, 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

    • Vergangene Zeit für Datenbankaufrufe auf Nutzerebene in Sekunden

      sys_time/db_time

    • Für Aufrufe auf Datenbanknutzerebene benötigte CPU-Zeit 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 aufgewendete 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 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 Agents 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 Agents 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:Prüfen Sie, ob 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 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.
  • Die Konfiguration des Kundenservicemitarbeiters 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 über SSH eine Verbindung zu Ihrer VM-Instanz her.
    2. Prüfen Sie die Protokolle 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.