Configurer l'agent pour les charges de travail Oracle

Ce document explique comment installer, configurer et valider Agent for Compute Workloads sur des instances Compute Engine qui exécutent des charges de travail Oracle Database.

L'agent collecte diverses métriques Oracle en interrogeant les vues de performances de la base de données Oracle (telles que V$DATABASE, V$INSTANCE et V$DATAGUARD_STATS) et les vues du dictionnaire de données (telles que DBA_DATA_FILES et DBA_FREE_SPACE). Ces métriques sont ensuite envoyées à Cloud Monitoring, où elles peuvent être visualisées et analysées. Consultez la section Métriques acceptées.

Avant de commencer

Avant d'installer Agent for Compute Workloads pour surveiller vos charges de travail Oracle Database, assurez-vous que les conditions préalables suivantes sont remplies :

Vérifier la configuration système requise

Le tableau suivant répertorie les éditions Oracle que vous pouvez utiliser et les versions de système d'exploitation compatibles :

Systèmes d'exploitation Versions d'Oracle Éditions Oracle
  • Red Hat Enterprise Linux versions 7, 8 et 9
  • Oracle Linux versions 7, 8 et 9
  • Oracle Database 19c
  • Oracle Database 23ai*
  • Édition Enterprise
  • Édition Standard
  • Édition Express (gratuite)

Attribuer des rôles IAM au compte de service

Agent for Compute Workloads utilise le compte de service associé à l'instance de calcul pour l'authentification et pour accéder aux ressources Google Cloud .

Pour améliorer la sécurité, nous vous recommandons d'utiliser un compte de service à usage unique plutôt que le compte de service Compute Engine par défaut.

Pour vous assurer que le compte de service dispose des autorisations nécessaires pour permettre à Agent for Compute Workloads de s'authentifier auprès deGoogle Cloud et d'accéder aux ressources Google Cloud , demandez à votre administrateur d'accorder au compte de service les rôles IAM suivants dans votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer au compte de service les autorisations requises à l'aide de rôles personnalisés ou d'autres rôles prédéfinis.

Activer l'accès aux APIs Cloud

Compute Engine recommande de configurer vos instances de façon à accorder un niveau d'accès complet à toutes les APIs Cloud et à n'utiliser que les autorisations IAM du compte de service de l'instance pour contrôler les accès aux ressourcesGoogle Cloud . Pour en savoir plus, consultez Créer une VM qui utilise un compte de service géré par l'utilisateur.

Si vous limitez l'accès aux APIs Cloud, Agent for Compute Workloads nécessite au minimum les niveaux d'accès suivants aux APIs Cloud sur l'instance de calcul hôte :

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

Pour en savoir plus, consultez les bonnes pratiques concernant les niveaux d'accès.

Si vous exécutez des applications Oracle sur une instance de calcul qui ne possède pas d'adresse IP externe, vous devez activer l'accès privé à Google sur le sous-réseau de l'instance afin qu'Agent for Compute Workloads puisse accéder aux API et services Google. Pour savoir comment activer l'accès privé à Google, consultez Configurer l'accès privé à Google.

Installer et configurer l'agent à l'aide du gestionnaire de packages

Cette section vous explique comment installer Agent for Compute Workloads sur votre instance de calcul et le configurer pour qu'il se connecte à une instance Oracle à l'aide d'un gestionnaire de packages.

Pour installer Agent for Compute Workloads, procédez comme suit :

  1. Créez un fichier de configuration du dépôt.

    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. Mettez à jour les métadonnées du gestionnaire de paquets :

    sudo yum makecache

  3. Installez le package rpm google-cloud-workload-agent :

    sudo yum install google-cloud-workload-agent

Après avoir installé l'agent pour les charges de travail Oracle, vérifiez l'installation de l'agent.

Installer et gérer l'agent sur un parc de VM à l'aide de VM Extension Manager

Configurer VM Extension Manager

Pour configurer VM Extension Manager, procédez comme suit :

Installer l'agent sur un parc de VM

Pour installer la dernière version d'Agent for Compute Workloads sur votre parc de VM dans une zone spécifique à l'aide d'une stratégie VM Extension Manager, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Règles d'extension de VM.

    Accéder aux règles d'extension de VM

  2. Cliquez sur Créer une règle d'extension.

  3. Dans le champ Nom, saisissez un nom pour la règle.

  4. Facultatif : Dans le champ Description, saisissez une description de la règle.

  5. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000.

  6. Dans les listes Région et Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.

  7. Dans la section Extensions, cliquez sur Ajouter une extension, puis procédez comme suit :

    1. Dans la liste Extension, sélectionnez Extension Google Cloud pour les charges de travail Compute.

    2. Laissez le champ Version vide.

      Cette directive indique à la stratégie d'installer la dernière version d'Agent for Compute Workloads.

    3. Dans le champ Contenu du fichier de configuration, saisissez la configuration que vous souhaitez appliquer à l'agent.

      Pour en savoir plus sur les paramètres de configuration compatibles avec l'agent pour votre charge de travail Oracle, consultez Paramètres de configuration.

    4. Cliquez sur OK.

  8. Facultatif : Pour limiter le déploiement de la règle aux VM requises, procédez comme suit :

    1. Cliquez sur Ajouter des libellés et incluez les libellés qui identifient les VM requises.
    2. Cliquez sur OK.

  9. Cliquez sur Créer.

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]

Remplacez les éléments suivants :

  • POLICY_NAME : nom de la règle d'extension de VM.

    La commande échoue si une règle portant le nom spécifié existe déjà dans la zone.

  • ZONE : zone à laquelle appliquer cette règle.

  • CONFIG_FILE_PATH : chemin d'accès local au fichier JSON contenant la configuration permettant à l'agent pour les charges de travail Compute de se connecter à votre charge de travail Oracle.

    • Vous pouvez également fournir la configuration sous forme de chaîne intégrée à l'aide de l'indicateur --config au lieu de --config-from-file. Exemple : --config=google-cloud-workload-extension="CONFIG". Google Cloud vous recommande d'utiliser --config-from-file.
    • Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.
    • Pour en savoir plus sur les paramètres de configuration compatibles avec l'agent pour votre charge de travail Oracle, consultez Paramètres de configuration.

  • DESCRIPTION : description facultative de la règle.

  • KEY_1=VALUE_1 : liste de paires clé-valeur séparées par une virgule qui définissent les libellés utilisés par la règle pour cibler les VM.

    • Pour qu'une VM soit ciblée par votre règle, elle doit comporter tous les libellés spécifiés.
    • Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OR logique). Si vous omettez cet indicateur, la règle cible toutes les VM de la zone spécifiée.

  • PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la règle. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000.

Exemple :

La commande suivante crée une règle nommée test-agent-policy dans le projetGoogle Cloud nommé test-project, qui installe la dernière version de l'agent pour les charges de travail Compute sur toutes les VM déployées dans la zone us-centrail-f. La configuration spécifiée dans agent-config.json est appliquée à l'agent.

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"

Vérifier l'installation de l'agent

Pour vérifier que l'agent s'exécute comme prévu, procédez comme suit :

  1. Établissez une connexion SSH avec votre instance de calcul.

  2. Vérifiez l'état du package de l'agent :

    systemctl status google-cloud-workload-agent

    Si le package d'agent s'exécute comme prévu, la sortie contient active (running). Exemple :

    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

    Paramètres de configuration

    Agent for Compute Workloads accepte les paramètres de configuration suivants pour Oracle :

    Paramètre Description
    log_level

    String

    Pour définir le niveau de journalisation de l'agent, ajoutez les niveaux de journalisation. Les niveaux de journalisation disponibles sont les suivants :
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    La valeur par défaut est INFO.
    log_to_cloud

    Boolean

    Pour rediriger les journaux de l'agent vers Cloud Logging, spécifiez true. La valeur par défaut est true.
    oracle_configuration.enabled

    Boolean

    Facultatif. Détermine si le service Oracle est actif. Lorsque la valeur est définie sur true ou si elle n'est pas définie et que la charge de travail est présente, vous pouvez configurer la découverte et la collecte de métriques. Si la valeur est définie sur false, le service Oracle et ses fonctionnalités associées sont désactivés.
    Les paramètres enfants suivants ne s'appliquent que lorsque vous spécifiez oracle_configuration.enabled: true.
    oracle_configuration.oracle_discovery.enabled

    Boolean

    Facultatif. Détermine si Oracle Discovery est actif.

    La valeur par défaut est true.
    oracle_configuration.oracle_discovery.update_frequency

    Int

    Facultatif. Spécifiez l'intervalle d'échantillonnage, en secondes, qui détermine la fréquence à laquelle l'agent pour les charges de travail Compute exécute le processus de découverte. La valeur par défaut est de 3 600 secondes (une heure).

    Assurez-vous que la valeur se termine par un "s" minuscule pour indiquer les secondes. Par exemple : 30s.
    oracle_configuration.oracle_metrics.enabled

    Boolean

    Facultatif. Pour permettre à Agent for Compute Workloads de collecter les métriques de surveillance Oracle, spécifiez true. La valeur par défaut est false.

    Les paramètres enfants suivants ne s'appliquent que lorsque vous spécifiez oracle_metrics.enabled: true.
    oracle_configuration.oracle_metrics.collection_frequency

    Int

    Facultatif. Spécifiez l'intervalle d'échantillonnage, en secondes, qui détermine la fréquence à laquelle l'agent pour les charges de travail Compute interroge vos instances Oracle Database pour collecter les métriques de surveillance Oracle. La valeur par défaut est de 60 secondes.

    Assurez-vous que la valeur se termine par un "s" minuscule pour indiquer les secondes. Par exemple : 30s.
    oracle_configuration.oracle_metrics.query_timeout

    String

    Facultatif. Indiquez le délai avant expiration de chaque requête adressée aux instances Oracle Database. La valeur par défaut est de 10 secondes.

    Assurez-vous que la valeur se termine par un "s" minuscule pour indiquer les secondes. Par exemple : 30s.
    oracle_configuration.oracle_metrics.connection_parameters.username

    String

    Spécifie le compte utilisateur utilisé pour interroger l'instance Oracle Database.

    Assurez-vous que cet utilisateur dispose des autorisations requises pour lire les vues de performances dans votre base de données Oracle.
    oracle_configuration.oracle_metrics.connection_parameters.host

    String

    Spécifie l'identifiant de la machine locale qui héberge votre instance de base de données.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    Spécifie le port sur lequel votre instance Oracle Database accepte les requêtes.
    oracle_configuration.oracle_metrics.connection_parameters.service_name

    String

    Spécifie le nom de service de votre instance Oracle Database que vous souhaitez que l'agent surveille.
    oracle_configuration.oracle_metrics.connection_parameters.secret.project_id

    String

    Spécifie l'ID du projet Secret Manager permettant de récupérer le mot de passe de l'utilisateur qui interroge la base de données.
    oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name

    String

    Spécifie le nom du secret dans Secret Manager qui stocke le mot de passe du compte utilisateur.

    Collecter et afficher les métriques Oracle

    Vous pouvez activer la collecte de métriques pour les charges de travail Oracle Database. Consultez la section Métriques acceptées.

    Activer la collecte des métriques

    Pour activer la collecte des métriques Oracle à l'aide de l'agent pour les charges de travail Compute, procédez comme suit :

    1. Utilisez SSH pour vous connecter à votre instance de VM.

    2. En tant qu'utilisateur de l'OS Oracle, exécutez l'outil oraenv pour définir les variables d'environnement. Nous partons du principe que vous avez déjà défini l'utilisateur oracle et le ORACLE_SID dans le fichier /etc/oratab.

      sudo su - oracle
export PATH=$PATH:/usr/local/bin
. oraenv
sqlplus / as sysdba

    3. En tant qu'utilisateur SYSDBA ou SYSOPER, dans la base de données Oracle, créez un utilisateur pour la surveillance avec un mot de passe correspondant au secret que vous avez créé dans la section Conditions requises.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. En tant qu'utilisateur SYSDBA ou SYSOPER, accordez les autorisations suivantes à l'utilisateur de surveillance pour interroger les vues sur les performances :

      • SESSION
      • SELECT_CATALOG_ROLE
      • SYSDG
      GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;

    5. Quittez sqlplus et l'utilisateur oracle.

    6. En tant qu'utilisateur racine, modifiez le fichier de configuration de l'agent à l'aide de l'éditeur de votre choix.

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

    7. Dans le fichier de configuration, modifiez la section oracle_metrics pour apporter les modifications suivantes :

      1. Définissez le paramètre enabled sur true.
      2. Définissez le paramètre service_name pour spécifier le nom de service de l'instance Oracle que vous souhaitez que l'agent surveille.
      3. Spécifiez le nom d'utilisateur Oracle pour que l'agent se connecte à votre base de données.
      4. Définissez les paramètres host et port pour que l'agent se connecte à votre base de données.
      5. Définissez le paramètre secret pour que l'agent récupère un mot de passe pour le nom d'utilisateur :
        • project_id : ID du projet contenant les données Secret Manager.
        • secret_name : nom du secret dans Secret Manager.

      Voici un exemple de fichier de configuration :

      {
  "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. Enregistrez le fichier de configuration.

    9. Redémarrez l'agent pour que les nouveaux paramètres prennent effet.

    Afficher les métriques

    Vous pouvez afficher les métriques collectées et surveiller les performances et l'état d'Oracle à l'aide de l'explorateur de métriques ou en important un tableau de bord personnalisé.

    Afficher les métriques dans l'explorateur de métriques

    Pour afficher les métriques Oracle dans l'explorateur de métriques, procédez comme suit :

    1. Dans la console Google Cloud , accédez à Monitoring.
    2. Cliquez sur Explorateur de métriques.
    3. Sous Find resource type and metric (Rechercher un type de ressource et une métrique), procédez comme suit :
      1. Pour Resource type (Type de ressource), sélectionnez VM Instance (Instance de VM).
      2. Pour Métrique, sélectionnez les métriques Oracle que vous souhaitez afficher.

    Vous pouvez afficher les données en temps réel et historiques pour les métriques Oracle sélectionnées, en utilisant des filtres et l'agrégation si nécessaire.

    Importer un tableau de bord personnalisé

    Pour afficher les métriques Oracle collectées par l'agent, vous pouvez créer des tableaux de bord Cloud Monitoring personnalisés en suivant les instructions de la section Créer et gérer des tableaux de bord personnalisés.

    Nous fournissons un exemple de tableau de bord oracle-status-overview.json et des instructions pour l'importer. Le tableau de bord oracle-status-overview.json affiche les graphiques suivants des métriques Oracle :

    • Répartition du temps de base de données
    • Utilisation de la mémoire de la base de données
    • Sessions actives moyennes par classe d'attente
    • E/S disque
    • Utilisation du processeur
    • Trafic réseau

    Pour importer le tableau de bord oracle-status-overview.json :

    1. Vérifiez que gcloud CLI est installé et à jour. Pour obtenir des instructions, consultez Installer gcloud CLI.

    2. Dans le dépôt GitHub de l'agent pour les charges de travail Compute, téléchargez le tableau de bord oracle-status-overview.json :

      $ 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. Exécutez la commande suivante pour importer le tableau de bord :

      gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json

      Une fois la commande exécutée, le tableau de bord personnalisé est créé dans Cloud Monitoring. Pour savoir comment afficher un tableau de bord, consultez Rechercher et afficher un tableau de bord.

    Métriques acceptées

    Toutes les métriques Oracle collectées par l'agent pour les charges de travail de calcul sont disponibles sous le chemin d'accès workload.googleapis.com/oracle.

    Vous trouverez ci-dessous la liste des métriques Oracle compatibles et de leurs chemins Cloud Monitoring correspondants :

    • Mémoire de processus

      • Mémoire de processus (PGA) utilisée, en octets.

        process/pga_memory/total_used_size

      • Mémoire de processus (PGA) allouée, en octets

        process/pga_memory/total_allocated_size

    • Mémoire partagée

      • Taille de l'élément de mémoire partagée (SGA), en octets

        process/sga_memory/size

    • Événements d'attente du système

      • Nombre total d'attentes pour une classe d'attente enregistrée

        sys_wait/count

      • Temps total passé dans cette classe d'attente, en secondes

        sys_wait/time

      • Nombre total d'attentes au premier plan dans cette classe d'attente

        sys_wait/foreground/count

      • Temps d'attente au premier plan agrégé pour cette classe d'attente, en secondes

        sys_wait/foreground/time

    • Temps écoulé du système

      • Temps écoulé pour effectuer des appels au niveau de l'utilisateur de la base de données, en secondes

        sys_time/db_time

      • Temps CPU passé sur les appels au niveau de l'utilisateur de la base de données, en secondes

        sys_time/db_cpu

      • Temps écoulé pendant l'exécution des instructions SQL

        sys_time/sql_execute_elapsed_time

      • Temps écoulé pour analyser les instructions SQL

        sys_time/parse_time_elapsed

      • Temps écoulé passé à exécuter l'interpréteur PL/SQL

        sys_time/pl_sql_execution_elapsed_time

      • Temps écoulé consommé par les processus d'arrière-plan de la base de données, en secondes

        sys_time/background_elapsed_time

    • Statistiques d'E/S

      • Nombre total d'opérations de lecture (petites et grandes)

        iostat/read_ops_count

      • Nombre total d'opérations d'écriture (petites et grandes)

        iostat/write_ops_count

      • Nombre total d'octets lus

        iostat/read_bytes_count

      • Nombre total d'octets écrits

        iostat/write_bytes_count

      • Latence moyenne par opération d'E/S

        iostat/average_latency_seconds

    • Fichiers de données

      • Taille allouée du fichier de données, en octets

        data_files/total_bytes

      • Espace utilisé par les fichiers de données, en octets

        data_files/bytes_used

      • Espace libre du fichier de données, en octets

        data_files/available_bytes

      • Limite d'extension automatique des fichiers de données, en octets

        data_files/max_bytes

      • Pourcentage du fichier de données utilisé

        data_files/percent_used

    • Instance de base de données

      • Temps d'activité de l'instance, en secondes

        instance/uptime

      • État de l'instance

        instance/status

        Cette métrique peut prendre les valeurs suivantes :

        UNKNOWN 0
        STARTED 1
        MOUNTED 2
        OPEN 3
        OPEN MIGRATE 4

      • Mode ouvert

        instance/db_open_mode

        Cette métrique peut prendre les valeurs suivantes :

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

    • Oracle Data Guard

      • Délai d'application du rétablissement, en secondes

        dataguard/apply_lag

      • Délai de rétablissement, en secondes

        dataguard/transport_lag

    Gérer l'agent

    Redémarrer l'agent

    Si Agent for Compute Workloads cesse de fonctionner ou si vous mettez à jour sa configuration, redémarrez l'agent.

    1. Utilisez SSH pour vous connecter à l'instance de VM.

    2. Exécutez la commande suivante :

      sudo systemctl restart google-cloud-workload-agent

    Vérifier la version de l'agent

    Pour afficher la version de l'agent, procédez comme suit :

    1. Utilisez SSH pour vous connecter à l'instance de VM.

    2. Exécutez la commande suivante :

      yum info google-cloud-workload-agent

    Rechercher des mises à jour

    1. Utilisez SSH pour vous connecter à l'instance de VM.

    2. Exécutez la commande suivante :

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

    Mettre à jour l'agent

    Pour vous assurer que vous disposez de la dernière version de l'agent, vérifiez régulièrement si des mises à jour sont disponibles et mettez à jour l'agent :

    1. Utilisez SSH pour vous connecter à l'instance de VM.

    2. Exécutez la commande suivante :

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

    Afficher les journaux de l'agent

    Les journaux de l'agent for Compute Workloads sont disponibles sur /var/log/google-cloud-workload-agent.log.

    La verbosité des journaux est contrôlée par le paramètre log_level. La définition du niveau de journalisation DEBUG inclut des informations supplémentaires pour résoudre des problèmes spécifiques, mais génère des journaux beaucoup plus volumineux.

    Par défaut, les journaux de l'agent pour les charges de travail de calcul sont redirigés depuis vos instances de VM vers Cloud Logging.

    Pour afficher les journaux de l'agent dans Logging, procédez comme suit :

    1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

      Accéder à l'explorateur de journaux

    2. Accédez au volet Requête.

    3. Dans le menu déroulant Ressources, sélectionnez Global, puis cliquez sur Appliquer.

    4. Dans l'éditeur de requêtes, saisissez google-cloud-workload-agent.

    5. Cliquez sur Exécuter la requête.

    Vous pouvez afficher les journaux générés par l'agent s'exécutant sur toutes vos instances de VM. Vous pouvez filtrer les journaux pour une instance spécifique.

    Configurer les journaux de l'agent dans Cloud Logging

    Pour désactiver la redirection par défaut des journaux de l'agent vers Cloud Logging, procédez comme suit :

    1. Utilisez SSH pour vous connecter à votre instance de VM.

    2. Modifiez le fichier de configuration de l'agent :

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

    3. Pour la propriété log_to_cloud, remplacez la valeur par false.

    4. Enregistrez le fichier de configuration.

    5. Redémarrez l'agent pour que cette modification soit prise en compte.

    Dépannage

    Les sections suivantes fournissent des informations sur les problèmes courants liés à l'utilisation de l'agent pour les charges de travail Oracle Database, leurs causes et leur résolution.

    Autorisations IAM insuffisantes

    Problème : les journaux de l'agent pour les charges de travail Compute affichent une erreur d'autorisation IAM insuffisante.

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

    Cause : Le compte de service utilisé par l'agent ne dispose pas des autorisations IAM requises pour accéder aux API Google Cloud ou d'un mot de passe pour l'utilisateur Oracle dans Secret Manager.

    Résolution : Pour résoudre ce problème, assurez-vous que le compte de service de la VM dispose des rôles et autorisations IAM mentionnés dans Conditions préalables.

    Champs d'application d'authentification insuffisants

    Problème : les journaux de l'agent pour les charges de travail Compute indiquent des niveaux d'authentification insuffisants.

    googleapi: Error 403: Request had insufficient authentication scopes.

    Cause : le compte de service utilisé par l'agent ne dispose pas du niveau d'accès#39;application requis.

    Solution : pour résoudre ce problème, configurez les champs d'application d'accès de la VM sur cloud-platform.

    Les métriques n'apparaissent pas dans Cloud Monitoring

    Problème : Les métriques de l'agent pour les charges de travail de calcul ne sont pas visibles dans Cloud Monitoring.

    Cause :

    Voici les causes possibles de ce problème :

    • Le compte de service utilisé par l'agent pour les charges de travail Compute ne dispose pas des autorisations IAM nécessaires.
    • L'utilisateur Oracle utilisé par l'agent ne dispose pas des droits suffisants pour interroger les vues de performances.
    • La configuration de l'agent comporte des erreurs.

    Solution :

    • Pour résoudre le problème d'autorisations insuffisantes pour le compte de service, procédez comme suit :

      1. Dans la console Google Cloud , accédez à la page Informations sur l'instance de VM et notez le compte de service utilisé par l'instance exécutant l'agent.
      2. Accédez à la page IAM et administration et assurez-vous que le compte de service dispose de tous les rôles et autorisations requis mentionnés dans les Conditions préalables. Attribuez au compte de service les rôles manquants requis.

    • Pour résoudre le problème d'autorisations insuffisantes pour l'utilisateur Oracle :

      1. Vérifiez que l'utilisateur Oracle dispose des autorisations requises suivantes pour interroger les vues de performances :

        • SESSION
        • SELECT_CATALOG_ROLE
        • SYSDG

      2. Accordez les autorisations manquantes en exécutant la commande SQL suivante :

        -- Grant the "wlmagent" user the required permissions
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;

    • Pour résoudre le problème de configuration incorrecte de l'agent, procédez comme suit :

      1. Utilisez SSH pour vous connecter à votre instance de VM.

      2. Examinez les journaux de l'agent pour identifier les erreurs ou les problèmes qui empêchent la collecte de métriques. Vous trouverez les journaux sur /var/log/google-cloud-workload-agent.log.

        Recherchez les erreurs d'autorisation, les erreurs de configuration ou les problèmes de connectivité.

      3. Corrigez les erreurs.

      4. Redémarrez l'agent et vérifiez si la collecte de métriques commence.

    Échec du chargement du fichier de configuration

    Problème : si le fichier de configuration contient des valeurs non valides, l'erreur suivante s'affiche. 

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

    Résolution : pour résoudre ce problème, mettez à jour le fichier de configuration en utilisant les informations de la section Paramètres de configuration.

    Échec de l'initialisation de la collecte de données

    Problème : Si le fichier de configuration n'est pas mis à jour après l'installation de l'agent, l'erreur suivante s'affiche : 

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

    Résolution : pour résoudre ce problème, initialisez la configuration des identifiants à l'aide des paramètres de configuration.