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

Ce guide traite des procédures et des considérations opérationnelles spécifiques à l'exécution de l'agent de surveillance pour SAP NetWeaver sur des VM Compute Engine et des serveurs de solution Bare Metal.

Comprendre le cycle de vie de l'agent de surveillance

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

  • Vous devez installer l'agent de surveillance pour SAP NetWeaver sur chaque 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 Windows ou Linux.
  • Sur les VM Compute Engine, Cloud Monitoring dispose d'un agent local qui collecte les métriques, les événements et les métadonnées de Google Cloud. Compute Engine fournit également des API qui offrent des fonctionnalités de surveillance.
  • Sur les VM Compute Engine, l'agent de surveillance pour SAP NetWeaver combine les données de surveillance de Monitoring et les API Compute Engine. Sur les serveurs de solution Bare Metal, l'agent n'accède pas aux API Google Cloud.
  • L'agent hôte SAP sonde les données mises en cache de l'agent de surveillance pour SAP NetWeaver, via HTTP. Il agrège les métriques, les signale 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.
  • Vous pouvez afficher les données de l'agent de surveillance pour SAP NetWeaver en exécutant une commande dans une fenêtre de terminal.

Accès aux API Cloud pour l'agent de surveillance pour SAP NetWeaver

Lorsque l'agent de surveillance pour SAP NetWeaver s'exécute sur une VM Compute Engine, il lit les données de Monitoring.

L'accès aux API Monitoring peut être contrôlé par les autorisations IAM accordées au compte de service de la VM hôte, par les niveaux d'accès de l'API Google Cloud accordés à la VM, ou les deux.

Compute Engine recommande d'utiliser uniquement les autorisations IAM du compte de service de la VM pour contrôler l'accès aux ressources Google Cloud et de définir les niveaux d'accès de la VM afin d'accorder un accès complet à toutes les API Cloud. Pour en savoir plus, consultez la section Bonnes pratiques.

L'agent de surveillance pour SAP NetWeaver utilise le compte de service de sa VM hôte pour récupérer les métriques Cloud Monitoring. Par conséquent, la VM hôte doit posséder un compte de service et le compte de service doit inclure l'autorisation monitoring.timeSeries.list, contenue dans le rôle prédéfini "Lecteur Monitoring".

Si vous limitez l'accès aux API Cloud, l'agent de surveillance pour SAP NetWeaver nécessite au minimum les niveaux d'accès suivants aux API Cloud sur l'instance de VM hôte :

  • Compute Engine : lecture seule
  • API Stackdriver Monitoring : lecture seule

Si vous exécutez SAP NetWeaver sur une VM dépourvue d'adresse IP externe, vous devez activer l'accès aux API et aux services Google Cloud pour l'agent de surveillance pour SAP NetWeaver.

Pour activer l'accès privé à Google depuis une VM Compute Engine sur un sous-réseau, consultez la section Configurer l'accès privé à Google.

Si vous exécutez SAP NetWeaver sur un serveur dans une extension de région de solution Bare Metal, l'agent de surveillance pour SAP NetWeaver n'a pas besoin d'accéder aux API Google Cloud.

Vérifier que l'agent de surveillance pour SAP NetWeaver est en cours d'exécution

L'agent de surveillance pour SAP NetWeaver est un serveur HTTP local.

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

Linux

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

  2. Exécutez la commande suivante : 

    sudo systemctl status google-sapnetweavermonitoring-agent

    Si l'agent de surveillance pour SAP NetWeaver fonctionne correctement, le résultat contient active (running). Exemple : 

    google-sapnetweavermonitoring-agent.service - Google Cloud monitoring agent for SAP NetWeaver
Loaded: loaded (/usr/lib/systemd/system/google-sapnetweavermonitoring-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Thu 2021-09-02 07:21:42 UTC; 742ms ago
Main PID: 10723 (java)
Tasks: 26 (limit: 512)
CGroup: /system.slice/google-sapnetweavermonitoring-agent.service
       └─10723 /usr/sap/google-sapnetweavermonitoring-agent/jre/bin/java -Xms32m -Xmx64m -cp /usr/sap/google-sapnetweavermonitoring-age...

Windows

  1. Utilisez RDP pour vous connecter à l'instance de VM que vous souhaitez surveiller.

  2. Exécutez la commande suivante : 

    Get-Service -Name google-sapnetweavermonitoring-agent

    Si l'agent de surveillance pour SAP NetWeaver fonctionne correctement, la colonne Status affiche Running. Exemple : 

        Status   Name               DisplayName
    ------   ----               -----------
    Running  google-sapnetwe... Google Cloud monitoring agent for S...

Pour vérifier les métriques collectées, consultez la section Afficher les métriques surveillées.

Si l'agent de surveillance pour SAP NetWeaver n'est pas en cours d'exécution, consultez la section Redémarrer l'agent de surveillance pour SAP NetWeaver.

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

Vous pouvez afficher les métriques surveillées en sondant le serveur. Procédez comme suit :

Linux

  1. Utilisez SSH pour vous connecter à la machine hôte que vous devez surveiller.

  2. À l'invite, saisissez la commande suivante :

    curl http://localhost:18181

Windows

  1. Utilisez RDP pour vous connecter à la machine hôte que vous devez surveiller.

  2. Dans un navigateur Web, accédez à l'URL suivante :

    http://localhost:18181

L'exemple suivant montre les premières lignes de sortie XML de l'agent de surveillance pour SAP NetWeaver.

VM Compute Engine 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
  last-refresh="1614389614" refresh-interval="0"><name>Data
  Provider Version</name><value>1.1.1.0</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Cloud Provider</name><value>Google Cloud
  Platform</value>
</metric>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Instance Type</name><value>n2-standard-16</value>
</metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614389614" refresh-interval="0">
  <name>Virtualization Solution</name><value>KVM</value>
</metric>
...
</metrics>

Serveur de solution Bare Metal

L'agent de surveillance pour SAP NetWeaver est correctement configuré pour une machine hôte Bare Metal si la valeur de Instance Type indique bms-nn et si la valeur de Hardware Model est définie sur Google Cloud Bare Metal, comme illustré dans l'exemple suivant.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<metrics>
<metric category="config" context="vm" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Data
Provider Version</name><value>1.1.1.0</value>
</metric><metric category="config" context="host" type="string"
unit="none" last-refresh="1614391024" refresh-interval="0">
<name>Cloud Provider</name><value>Google Cloud
Platform</value></metric><metric category="config"
context="vm" type="string" unit="none" last-refresh="1614391024"
refresh-interval="0"><name>Instance Type</name>
<value>bms-16.0</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Virtualization
Solution</name><value>N/A</value></metric><metric
category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware Manufacturer</name><value>Google</value></metric>
<metric category="config" context="host" type="string" unit="none"
last-refresh="1614391024" refresh-interval="0"><name>Hardware
Model</name><value>Google Cloud Bare Metal</value>
</metric>
...
</metrics>

Redémarrer l'agent de surveillance pour SAP NetWeaver

Si l'agent de surveillance pour SAP NetWeaver cesse de fonctionner, redémarrez-le.

Sélectionnez votre système d'exploitation :

Linux

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

  2. Exécutez la commande suivante : 

    systemctl restart google-sapnetweavermonitoring-agent

Windows

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

  2. Exécutez la commande suivante : 

    Restart-Service -Force google-sapnetweavermonitoring-agent

Mettre à jour l'agent de surveillance pour SAP NetWeaver

Pour vous assurer que vous disposez de la dernière version de l'agent de surveillance pour SAP NetWeaver, vérifiez régulièrement si des mises à jour sont disponibles.

Rechercher des mises à jour

Sélectionnez votre système d'exploitation :

RHEL

Pour rechercher les mises à jour de l'agent de surveillance à l'aide du gestionnaire de packages, procédez comme suit :

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

  2. Exécutez la commande suivante : 

    sudo yum check-update google-sapnetweavermonitoring-agent

SLES

Pour rechercher les mises à jour de l'agent de surveillance à l'aide du gestionnaire de packages, procédez comme suit :

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

  2. Exécutez la commande suivante : 

    sudo zypper list-updates -r google-sapnetweavermonitoring-agent

Windows

Pour vérifier les mises à jour de l'agent de surveillance, procédez comme suit :

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

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

    C:\Program Files\Google\google-sapnetweavermonitoring-agent\bin\updatecheck.ps1

Installer une mise à jour

Sélectionnez votre système d'exploitation :

RHEL

Pour installer l'agent de surveillance à l'aide du gestionnaire de packages, procédez comme suit :

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

  2. Exécutez la commande suivante : 

    sudo yum --nogpgcheck update google-sapnetweavermonitoring-agent

SLES

Pour installer l'agent de surveillance à l'aide du gestionnaire de packages, procédez comme suit :

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

  2. Exécutez la commande suivante : 

    sudo zypper --no-gpg-checks update google-sapnetweavermonitoring-agent

Windows

Pour installer l'agent de surveillance, procédez comme suit :

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

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

    . { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex