Version 2 : Guide d'utilisation de l'agent Google Cloud pour SAP

Ce guide traite des procédures et des considérations opérationnelles spécifiques à l'exécution de la version 2 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

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

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

Utilisez le protocole RDP pour vous connecter à l'instance de VM.
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 :

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

Pour SLES, procédez comme suit :

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

Windows

Utilisez RDP pour vous connecter à la machine hôte.
En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :
```
googet installed 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 :

Dans votre système SAP, saisissez la transaction ST06.
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

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

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

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

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, les métriques d'évaluation du gestionnaire de charges de travail ou les métriques de surveillance SAP HANA, vous devez 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 :

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

Accéder à l'explorateur de métriques
Accédez à l'onglet Configuration.
Développez le menu Sélectionner une métrique.
Dans le menu Ressources, sélectionnez Instance de VM.
Dans le menu Catégorie de métrique, sélectionnez sap.
Dans le menu Métrique, sélectionnez metric: workload.googleapis.com/sap/service/active ou l'une des nouvelles métriques à représenter graphiquement.
Cliquez sur Appliquer.

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

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

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

Exécutez la commande suivante :

sudo systemctl restart google-cloud-sap-agent

Windows

Établissez une connexion RDP avec votre instance de VM hôte.
En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

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

L'installation de l'agent Google Cloud pour SAP détecte automatiquement les anciennes versions de l'agent de surveillance pour SAP NetWeaver et de l'agent de surveillance pour SAP HANA, les désactive, puis les supprime de vos machines hôtes lors de l'installation.

Si ces agents Google Cloud sont détectés, les configurations de leurs fichiers de configuration sont également migrées vers l'agent 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

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

Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.
Ouvrez le fichier de configuration de l'agent Google Cloud pour SAP :
```
/etc/google-cloud-sap-agent/configuration.json
```
Dans la section hana_monitoring_configuration, définissez le paramètre enabled sur true.
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.
Enregistrez le fichier de configuration.
Redémarrez l'agent pour que les nouveaux paramètres prennent effet.
```
sudo systemctl restart google-cloud-sap-agent
```
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.
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 à jour l'agent Google Cloud pour SAP

Cette section explique comment vérifier si une version mise à jour de l'agent Google Cloud pour SAP est disponible et comment passer à la version 3.4 (dernière version) de l'agent Google Cloud pour SAP.

Si vous devez passer à une version de l'agent autre que la dernière, contactez Cloud Customer Care.

Rechercher des mises à jour

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

RHEL

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

Exécutez la commande suivante :

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

SLES

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

Exécutez la commande suivante :

sudo zypper list-updates -r google-cloud-sap-agent

Windows

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

Installer une mise à jour

Pour mettre à jour votre instance de l'agent Google Cloud pour SAP vers la version 3.4 (dernière version), sélectionnez votre système d'exploitation, puis suivez les étapes ci-dessous.

Si vous devez installer une version de l'agent autre que la dernière, contactez Cloud Customer Care.

RHEL

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

Exécutez la commande suivante :

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

SLES

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

Exécutez la commande suivante :

sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

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

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

Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.
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
```
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
```
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.
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
```
Redémarrez l'agent de surveillance pour SAP HANA :
```
sudo systemctl start google-saphanamonitoring-agent
```

SLES

Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.
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
```
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
```
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.
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
```
Redémarrez l'agent de surveillance pour SAP HANA :
```
sudo systemctl start google-saphanamonitoring-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 :

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

Accéder à l'explorateur de journaux
Accédez au volet Requête.
Dans le menu déroulant Ressources, sélectionnez Global, puis cliquez sur Appliquer.
Dans l'éditeur de requêtes, saisissez google-cloud-sap-agent.
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 cette redirection par défaut des journaux de l'agent. Pour cela, procédez comme suit :

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

Ouvrez le fichier de configuration suivant :

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

Pour le paramètre log_to_cloud, remplacez la valeur par false.
Enregistrez le fichier de configuration.
Redémarrez l'agent pour que cette modification soit prise en compte.