Guide d'utilisation de l'agent Google Cloud pour SAP

Ce guide traite des procédures et des considérations opérationnelles pour l'exécution de la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP sur des instances de VM Compute Engine et des serveurs de solution Bare Metal.

Comprendre le cycle de vie de l'agent

Lors de la gestion des opérations de l'agent Google Cloud pour SAP, il est utile de comprendre ce que fait l'agent. En général, voici comment il fonctionne :

  • Vous devez installer l'agent Google Cloud pour SAP sur chaque instance de VM Compute Engine ou serveur de solution Bare Metal qui héberge des systèmes SAP. Cet agent s'exécute en tant que service Linux ou Windows.
  • Sur les instances de VM Compute Engine, l'agent combine les données de surveillance de Monitoring et des API Compute Engine.
  • Sur les serveurs de solution Bare Metal, pour la collecte des métriques de l'agent hôte SAP, l'agent n'accède pas aux API Google Cloud.
  • L'agent hôte SAP interroge les données mises en cache de l'agent Google Cloud, via HTTP. Il agrège les métriques de l'agent hôte SAP, les organise sous forme de rapports et les stocke dans la base de données SAP NetWeaver.
  • La transaction SAP ST06 ou l'interface de ligne de commande saposcol affiche les métriques agrégées de l'agent hôte SAP.
  • Vous pouvez afficher les métriques de l'agent hôte SAP à partir de l'agent Google Cloud pour SAP en exécutant une commande dans une fenêtre de terminal.

Vérifier que l'agent est en cours d'exécution

Après avoir installé ou redémarré l'agent, vous pouvez vérifier qu'il fonctionne comme prévu.

Pour vérifier si l'agent est en cours d'exécution, procédez comme suit :

Linux

  1. Établissez une connexion SSH avec votre serveur de solution Bare Metal ou votre instance de VM.

  2. Exécutez la commande ci-dessous :

    systemctl status google-cloud-sap-agent

    Si l'agent fonctionne correctement, la sortie contient active (running). Exemple :

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
    Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
    Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
    Main PID: 1337673 (google-cloud-sa)
    Tasks: 9 (limit: 100427)
    Memory: 22.4 M (max: 1.0G limit: 1.0G)
    CGroup: /system.slice/google-cloud-sap-agent.service
           └─1337673 /usr/bin/google-cloud-sap-agent
    
    .

Windows

  1. Utilisez le protocole RDP pour vous connecter à l'instance de VM.

  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    Si l'agent est en cours d'exécution, l'état indique Running.

Si l'agent Google Cloud pour SAP n'est pas en cours d'exécution, redémarrez l'agent.

Vérifier la version de l'agent

Après avoir installé ou redémarré l'agent Google Cloud pour SAP, vous pouvez vérifier la version de l'agent.

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

Linux

Pour RHEL, procédez comme suit :

  1. Utilisez SSH pour vous connecter à la machine hôte.
  2. Exécutez la commande suivante :
    yum info google-cloud-sap-agent

Pour SLES, procédez comme suit :

  1. Utilisez SSH pour vous connecter à la machine hôte.
  2. Exécutez la commande suivante :
    zypper info google-cloud-sap-agent

Windows

  1. Utilisez RDP pour vous connecter à la machine hôte.
  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :
    googet installed google-cloud-sap-agent

Répertoriez les versions disponibles de l'agent

Pour répertorier toutes les versions disponibles de l'agent Google Cloud pour SAP, procédez comme suit :

RHEL

  1. Établissez une connexion SSH avec votre hôte.

  2. Exécutez la commande ci-dessous.

    sudo yum list --showduplicates google-cloud-sap-agent

SLES

  1. Établissez une connexion SSH avec votre hôte.

  2. Exécutez la commande ci-dessous.

    sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent

Vérifier que l'agent hôte SAP reçoit les métriques

Pour vérifier que les métriques d'infrastructure sont collectées par l'agent Google Cloud pour SAP et envoyées correctement à l'agent hôte SAP, procédez comme suit :

  1. Dans votre système SAP, saisissez la transaction ST06.
  2. Dans le volet de synthèse, vérifiez la disponibilité et le contenu des champs suivants pour vous assurer de la configuration de façon correcte et complète de l'infrastructure de surveillance SAP et Google :

    • Fournisseur cloud : Google Cloud Platform
    • Accès à la surveillance améliorée : TRUE
    • Détails de la surveillance améliorée : ACTIVE

Afficher les métriques de l'agent hôte SAP

Après avoir installé ou mis à jour la configuration de l'agent Google Cloud pour SAP, vous pouvez afficher les métriques de l'agent hôte SAP collectées.

Pour afficher les métriques de l'agent hôte SAP collectées par l'agent Google Cloud pour SAP, procédez comme suit :

Linux

  1. Établissez une connexion SSH avec votre instance de VM hôte du serveur de solution Bare Metal.

  2. Exécutez la commande ci-dessous :

    curl http://localhost:18181

    Si les métriques sont disponibles, vous devriez recevoir une sortie XML contenant des informations sur votre système. Exemple :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <metrics>
      <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
      <name>VM Processing Power Consumption</name>
      <value>0.0</value>
      </metric>

Windows

  1. Utilisez le protocole RDP pour vous connecter à l'instance de VM.

  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    Si les métriques sont disponibles, vous devriez voir une sortie XML contenant des informations sur votre système. Exemple :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <metrics>
      <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
      <name>VM Processing Power Consumption</name>
      <value>10.0</value>
      </metric>

Afficher les autres métriques

Après avoir mis à jour la configuration de l'agent Google Cloud pour SAP afin de collecter les métriques de surveillance des processus ou les métriques de surveillance SAP HANA, nous vous recommandons de les afficher pour vérifier que l'agent collecte les métriques comme prévu.

Vous pouvez afficher les métriques et les informations collectées par l'agent Google Cloud pour SAP dans Cloud Monitoring en procédant comme suit :

  1. Dans la console Google Cloud, accédez à la page Explorateur de métriques de Monitoring.

    Accéder à l'explorateur de métriques

  2. Accédez à l'onglet Configuration.

  3. Développez le menu Sélectionner une métrique.

  4. Dans le menu Ressources, sélectionnez Instance de VM.

  5. Dans le menu Catégorie de métrique, sélectionnez sap.

  6. Dans le menu Métrique, sélectionnez metric: workload.googleapis.com/sap/service/active ou l'une des nouvelles métriques à représenter graphiquement.

  7. Cliquez sur Appliquer.

Vous devriez voir un graphique affichant les valeurs des métriques de séries temporelles.

Valider la fonctionnalité Backint

Après avoir activé la fonctionnalité Backint de l'agent, vous devez la valider en créant et en restaurant une sauvegarde.

Pour obtenir des instructions, consultez la page Valider la sauvegarde et la récupération.

Redémarrer l'agent

Si l'agent Google Cloud pour SAP cesse de fonctionner ou si vous mettez à jour sa configuration, redémarrez l'agent.

Sélectionnez votre système d'exploitation, puis procédez comme suit :

Linux

  1. Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.

  2. Exécutez la commande suivante :

    sudo systemctl restart google-cloud-sap-agent
    

Windows

  1. Établissez une connexion RDP avec votre instance de VM hôte.

  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :

    Restart-Service -Name 'google-cloud-sap-agent' -Force
    

Désactiver ou activer l'agent

Pour activer la surveillance appropriée, le service systemd de l'agent Google Cloud pour SAP sur votre instance de calcul doit être exécuté à tout moment. Toutefois, si vous devez désactiver ou arrêter l'agent sur votre instance de calcul basée sur Linux, exécutez la commande suivante :

sudo /usr/bin/google_cloud_sap_agent service -disable

Pour activer et démarrer le service systemd de l'agent sur votre instance de calcul basée sur Linux, procédez comme suit :

sudo /usr/bin/google_cloud_sap_agent service -enable

Lorsque vous désactivez ou activez le service systemd de l'agent sous Linux, l'action est consignée dans le fichier suivant : /var/log/google-cloud-sap-agent/service.log.

Passer à l'agent Google Cloud pour SAP depuis d'autres agents Google Cloud

L'agent Google Cloud pour SAP succède aux autres agents Google Cloud. Les sections suivantes fournissent des informations sur la mise à niveau de ces agents vers la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP.

Pour obtenir des instructions sur l'installation et la configuration de l'agent Google Cloud pour SAP, consultez le Guide d'installation et de configuration de l'agent Google Cloud pour SAP.

Mettre à niveau à partir de l'agent Backint de Cloud Storage pour SAP HANA

Pour passer de l'agent Backint de Cloud Storage pour SAP HANA à la version 3.5 (la plus récente), procédez comme suit :

  1. Assurez-vous qu'aucune sauvegarde de données n'est en cours ou planifiée pour la période qui chevauche la mise à niveau.

  2. Désactivez les sauvegardes automatiques des journaux en définissant le paramètre SAP HANA enable_auto_log_backup sur no. Pour obtenir des instructions, consultez la page Activer et désactiver la sauvegarde automatique des journaux dans la documentation SAP HANA.

  3. Installez l'agent Google Cloud pour SAP. Pour obtenir des instructions, consultez le guide d'installation pour votre scénario.

  4. Activez la fonctionnalité Backint de l'agent Google Cloud pour SAP. Pour obtenir des instructions, consultez la page Configurer la sauvegarde et la récupération basées sur Backint.

    L'activation de la fonctionnalité Backint de l'agent Google Cloud pour SAP détecte automatiquement l'agent Backint sur votre hôte et le désactive de votre machine hôte.

  5. Pour créer une version JSON de votre fichier texte de configuration Backint existant, exécutez la commande suivante pour chacun de vos fichiers texte :

    /usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE

    Remplacez PATH_TO_PARAMETERS_FILE par le chemin d'accès à votre fichier PARAMETERS.txt.

    Les fichiers JSON sont créés au même emplacement dans votre système de fichiers que les fichiers texte, à condition que l'agent Google Cloud pour SAP soit autorisé à accéder à ces emplacements. Bien que l'agent Google Cloud pour SAP soit capable d'interpréter les paramètres Backint spécifiés dans le fichier texte, nous vous recommandons d'utiliser les fichiers JSON pour mettre à jour les configurations.

  6. Activez les sauvegardes automatiques des journaux en définissant le paramètre SAP HANA enable_auto_log_backup sur yes. Pour obtenir des instructions, consultez la page Activer et désactiver la sauvegarde automatique des journaux dans la documentation SAP HANA.

  7. Validez la sauvegarde et la récupération.

Lorsque vous effectuez cette mise à niveau, voici ce qui se produit :

  • À des fins de sauvegarde et de référence, tous les fichiers d'installation du répertoire backint-gcs de l'agent Backint sont copiés dans backint-gcs-old-TIMESTAMP/. Celles-ci sont nécessaires si vous devez revenir à l'utilisation de l'agent Backint.
  • Le dossier backint-gcs est ensuite nettoyé pour ne contenir que les fichiers requis pour exécuter l'agent de Google Cloud pour SAP, y compris son fichier de configuration, parameters.json et les fichiers de configuration Backint tels que PARAMETERS.txt.

Pour en savoir plus sur le mappage des paramètres de configuration entre l'agent Backint et l'agent Google Cloud pour SAP, développez la section suivante.

Mappage des paramètres de configuration

Nom du paramètre dans l'agent Backint Nom du paramètre dans l'agent Google Cloud pour SAP
BUCKET bucket
DISABLE_COMPRESSION compress
ENCRYPTION_KEY encryption_key
KMS_KEY_NAME kms_key
MAX_GCS_RETRY retries
PARALLEL_FACTOR parallel_streams
PARALLEL_PART_SIZE Cette fonctionnalité n'est pas disponible dans l'agent Google Cloud pour SAP.
RATE_LIMIT_MB rate_limit_mb
SERVICE_ACCOUNT service_account_key
THREADS thread
READ_IDLE_TIMEOUT file_read_timeout_ms
CHUNK_SIZE_MB buffer_size_mb
HTTP_READ_TIMEOUT Cette fonctionnalité n'est pas disponible dans l'agent Google Cloud pour SAP.

Mettre à niveau à partir de l'agent de surveillance pour SAP HANA

L'installation de la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP détecte automatiquement les versions de l'agent de surveillance pour SAP HANA, les désactive, puis les supprime de vos machines hôtes pendant l'installation.

Si cet agent est détecté, sa configuration est migrée vers l'agent de Google Cloud pour SAP lors de son installation. La configuration de l'agent de surveillance pour SAP HANA est copiée dans le fichier suivant à des fins de sauvegarde et de référence :

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

Mettre à niveau des instances SSL

Si vous avez configuré l'agent de surveillance pour SAP HANA afin d'utiliser des certificats SSL pour communiquer avec vos instances SAP HANA, lorsque vous installez l'agent de Google Cloud pour SAP, toutes les configurations de surveillance SAP HANA sauf la configuration SSL, sont migrées vers l'agent Google Cloud pour SAP. Dans ce cas, pour surveiller les instances SAP HANA à l'aide de l'agent de Google Cloud, procédez comme suit :

  1. Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.

  2. Ouvrez le fichier de configuration de l'agent Google Cloud pour SAP :

    /etc/google-cloud-sap-agent/configuration.json
  3. Dans la section hana_monitoring_configuration, définissez le paramètre enabled sur true.

  4. Dans la section hana_monitoring_configuration.hana_instances, procédez comme suit pour chaque instance SAP HANA qui utilise le protocole TLS/SSL pour une communication sécurisée :

    1. Spécifiez le paramètre enable_ssl et définissez sa valeur sur true.

    2. Spécifiez le paramètre host_name_in_certificate et définissez le nom d'hôte SAP HANA comme spécifié dans le certificat TLS/SSL en tant que valeur.

    3. Spécifiez la propriété tls_root_ca_file et définissez le chemin d'accès au certificat TLS/SSL en tant que valeur.

  5. Enregistrez le fichier de configuration.

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

    sudo systemctl restart google-cloud-sap-agent
  7. Vérifiez que l'agent collecte les métriques de surveillance SAP HANA. Pour obtenir des instructions, consultez la page Afficher les autres métriques.

  8. Désinstallez l'agent de surveillance pour SAP HANA.

Si vous rencontrez des problèmes de connexion avec vos instances SAP HANA après cette mise à niveau, vous pouvez afficher les journaux de l'agent dans Logging et utiliser le guide de dépannage pour résoudre le problème.

Mettre à niveau à partir de l'agent de surveillance pour SAP NetWeaver

L'installation de la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP détecte automatiquement les versions de l'agent de surveillance pour SAP NetWeaver.

Si cet agent est détecté, sa configuration est migrée vers l'agent de Google Cloud pour SAP lors de son installation.

Mettre à jour l'agent Google Cloud pour SAP

Pour vous assurer que vous disposez de la dernière version de l'agent Google Cloud pour SAP, vous devez régulièrement vérifier si des mises à jour sont disponibles et mettre à jour l'agent.

Rechercher des mises à jour

Sélectionnez votre système d'exploitation, puis procédez comme suit :

RHEL

  1. Établissez une connexion ssh avec votre instance.
  2. Exécutez la commande ci-dessous :
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Établissez une connexion ssh avec votre instance.
  2. Exécutez la commande ci-dessous :
    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. Établissez une connexion RDP avec votre instance de VM hôte.
  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :
    googet latest google-cloud-sap-agent

Installer une mise à jour

Sélectionnez votre système d'exploitation, puis procédez comme suit :

RHEL

  1. Établissez une connexion ssh avec votre instance.
  2. Mettez à jour votre instance d'agent :
    • (Recommandé) Pour effectuer la mise à jour vers la version 3.5 (la plus récente) de l'agent :
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

SLES

  1. Établissez une connexion ssh avec votre instance.
  2. Mettez à jour votre instance d'agent :
    • (Recommandé) Pour effectuer la mise à jour vers la version 3.5 (la plus récente) de l'agent :
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

Windows

  1. Établissez une connexion RDP avec votre instance de VM hôte.
  2. Pour effectuer la mise à jour vers la version 3.5 (la plus récente) de l'agent, exécutez la commande suivante à partir de PowerShell en tant qu'administrateur :
    googet install google-cloud-sap-agent

Revenir à une version antérieure de l'agent Google Cloud pour SAP

Bien que nous vous recommandions de toujours utiliser la dernière version de l'agent Google Cloud pour SAP, vous pouvez revenir de sa dernière version à une autre version compatible de l'agent en exécutant la commande suivante :

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum downgrade google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

Remplacez VERSION_NUMBER par le numéro de version de l'agent que vous souhaitez installer, par exemple 3.1-606637668. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.

Restaurer les autres agents Google Cloud

Cette section fournit des informations sur le rollback à partir de la version 3.5 (la plus récente) de l'agent Google Cloud pour SAP et l'utilisation de ses agents prédécesseurs.

Effectuez un rollback à l'aide de l'agent Backint

Si vous souhaitez effectuer un rollback de l'agent Backint et cesser d'utiliser la fonctionnalité Backint de l'agent Google Cloud pour SAP, procédez comme suit :

  1. Supprimez tous les fichiers liés à la fonctionnalité Backint de l'agent Google Cloud pour SAP :

    rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs

    Remplacez SID par le SID de votre système SAP.

  2. Restaurez les fichiers de l'agent Backint stockés en tant que sauvegarde lors de la mise à niveau vers l'agent Google Cloud pour SAP, en les copiant dans le répertoire backint-gcs :

    cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs

    Remplacez les éléments suivants :

    • SID : SID de votre système SAP
    • TIMESTAMP : valeur d'horodatage dans le nom du dossier créé lors de la mise à niveau de l'agent Backint vers l'agent Google Cloud pour SAP
  3. Utilisez SAP HANA Studio ou SAP HANA Cockpit pour modifier le fichier global.ini et mettre à jour les chemins d'accès à vos fichiers de configuration .txt. Pour en savoir plus sur les paramètres pour lesquels vous devez spécifier le chemin d'accès aux fichiers .txt, consultez la section Configurer SAP HANA pour la fonctionnalité Backint.

  4. Enregistrez les modifications apportées au fichier global.ini.

Effectuer un rollback vers l'utilisation de l'agent de surveillance pour SAP HANA

Si vous souhaitez effectuer un rollback vers l'utilisation de l'agent de surveillance pour SAP HANA et cesser d'utiliser la fonctionnalité de surveillance SAP HANA de l'agent Google Cloud pour SAP, procédez comme suit :

RHEL

  1. Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.

  2. Pour empêcher la collecte de métriques en double, désactivez la collecte de métriques de surveillance SAP HANA par l'agent SAP pour Google Cloud :

    1. Ouvrez le fichier de configuration de l'agent Google Cloud pour SAP :

      /etc/google-cloud-sap-agent/configuration.json
    2. Dans la section hana_monitoring_configuration, définissez le paramètre enabled sur false.

    3. Enregistrez le fichier de configuration.

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

      sudo systemctl restart google-cloud-sap-agent
  3. Copiez la configuration de l'agent de surveillance pour SAP HANA à partir du fichier suivant :

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
  4. Installez l'agent de surveillance pour SAP HANA version 2. Pour obtenir des instructions d'installation, consultez le Guide d'installation et d'utilisation de l'agent de surveillance pour SAP HANA V2.0.

  5. Dans le fichier suivant, collez la configuration de l'agent de surveillance pour SAP HANA que vous avez copié précédemment :

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
  6. Redémarrez l'agent de surveillance pour SAP HANA :

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.

  2. Pour empêcher la collecte de métriques en double, désactivez la collecte de métriques de surveillance SAP HANA par l'agent SAP pour Google Cloud :

    1. Ouvrez le fichier de configuration de l'agent Google Cloud pour SAP :

      /etc/google-cloud-sap-agent/configuration.json
    2. Dans la section hana_monitoring_configuration, définissez le paramètre enabled sur false.

    3. Enregistrez le fichier de configuration.

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

      sudo systemctl restart google-cloud-sap-agent
  3. Copiez la configuration de l'agent de surveillance pour SAP HANA à partir du fichier suivant :

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
  4. Installez l'agent de surveillance pour SAP HANA version 2. Pour obtenir des instructions d'installation, consultez le Guide d'installation et d'utilisation de l'agent de surveillance pour SAP HANA V2.0.

  5. Dans le fichier suivant, collez la configuration de l'agent de surveillance pour SAP HANA que vous avez copié précédemment :

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
  6. Redémarrez l'agent de surveillance pour SAP HANA :

    sudo systemctl start google-saphanamonitoring-agent

Désinstaller l'agent

Pour désinstaller ou supprimer l'agent de votre hôte, procédez comme suit :

RHEL

  1. Établissez une connexion SSH avec votre hôte.

  2. Exécutez la commande ci-dessous.

    sudo yum remove google-cloud-sap-agent

SLES

  1. Établissez une connexion SSH avec votre hôte.

  2. Exécutez la commande ci-dessous.

    sudo zypper remove google-cloud-sap-agent

Windows

  1. Établissez une connexion RDP avec votre instance de VM hôte.

  2. En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :

    Remove-Service -Name 'google-cloud-sap-agent'

Afficher les journaux de l'agent dans Cloud Logging

Par défaut, les journaux de l'agent Google Cloud pour SAP sont redirigés depuis vos instances de VM et vos serveurs de solution Bare Metal vers Cloud Logging.

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

  1. Dans Google Cloud Console, 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-sap-agent.

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

Vous devriez voir les journaux générés par les instances d'agent s'exécutant sur l'ensemble de vos instances de VM ou serveurs de solution Bare Metal. Pour filtrer les journaux d'une machine spécifique, utilisez les filtres disponibles dans l'interface.

Vous pouvez désactiver la redirection par défaut des journaux de l'agent concernés par la collecte de métriques. Pour cela, procédez comme suit :

  1. Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.

  2. Ouvrez le fichier de configuration suivant :

    /etc/google-cloud-sap-agent/configuration.json
  3. Pour le paramètre 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.

Pour désactiver la redirection par défaut des journaux liés à la fonctionnalité Backint de l'agent Google Cloud pour SAP, modifiez votre fichier de configuration Backint et définissez le paramètre log_to_cloud sur false.