Version 1 : 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 1 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 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 surveillées

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 surveillé.

Pour afficher les métriques surveillées de l'agent hôte 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>

Vérifier les métriques de surveillance des processus et les métriques d'évaluation du gestionnaire de charges de travail

Après avoir mis à jour la configuration, vous devez vérifier que les métriques de surveillance des processus et les métriques d'évaluation du gestionnaire de charges de travail sont disponibles. Vous pouvez accéder aux métriques et aux informations collectées par l'agent Google Cloud pour SAP dans Cloud Monitoring.

Pour vérifier les métriques dans Monitoring, procédez 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.

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 de l'agent de surveillance pour SAP NetWeaver à l'agent Google Cloud pour SAP

L'installation de l'agent Google Cloud pour SAP détecte automatiquement les anciennes versions de l'agent de surveillance pour SAP NetWeaver, désactive l'agent, puis le supprime de votre serveur hôte lors de l'installation.

Si l'agent de surveillance pour SAP NetWeaver est détecté et qu'un fichier de configuration existant est trouvé lors de l'installation, le processus d'installation migre automatiquement les configurations existantes vers 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 à 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.3 (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.

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.

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.3 (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.

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.

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

Procéder au rollback vers une version précédente

Si nécessaire, vous pouvez effectuer un rollback de l'agent Google Cloud pour SAP version 1 vers l'agent de surveillance pour SAP NetWeaver version 2.

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

RHEL

Établissez une connexion SSH avec votre instance de VM hôte.
Exécutez la commande suivante :
```
sudo yum remove google-cloud-sap-agent
```
Installez l'agent de surveillance pour SAP NetWeaver version 2. Pour obtenir des instructions sur l'installation de l'agent de surveillance pour SAP NetWeaver, consultez le Guide d'installation de l'agent de surveillance pour SAP NetWeaver.

SLES

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

Exécutez la commande suivante :

sudo zypper remove google-cloud-sap-agent

Installez l'agent de surveillance pour SAP NetWeaver version 2. Pour obtenir des instructions sur l'installation de l'agent de surveillance pour SAP NetWeaver, consultez le Guide d'installation de l'agent de surveillance pour SAP NetWeaver.

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 remove google-cloud-sap-agent
```
Installez l'agent de surveillance pour SAP NetWeaver version 2. Pour obtenir des instructions sur l'installation de l'agent de surveillance pour SAP NetWeaver, consultez le Guide d'installation de l'agent de surveillance pour SAP NetWeaver.

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.