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

Ce guide vous explique comment résoudre les problèmes liés à la version 2 de l'agent Google Cloudpour SAP.

Journalisation

Vérifiez les journaux dans le répertoire qui correspond spécifiquement à votre système d'exploitation.

Pour afficher les journaux de l'agent Google Cloudpour SAP, accédez aux chemins d'accès suivants:

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Problèmes courants

Problème : autorisations IAM insuffisantes

Problème:les journaux de l'agent Google Cloudpour SAP indiquent une erreur d'autorisation IAM insuffisante.

Cause : le compte de service ne dispose pas des autorisations IAM requises pour accéder à l'API Cloud Monitoring.

Solution : dans la console Google Cloud, sur la page Détails de l'instance de VM, notez le nom du compte de service de VM. Exemple : sap-example@example-project-123456.iam.gserviceaccount.com. Sur la page d'accueil "IAM et administration", assurez-vous que le compte de service inclut les rôles IAM suivants :

Fonctionnalité Rôles IAM requis
Collecte de métriques de l'agent hôte SAP
Collecte des métriques de surveillance des processus
Collecte des métriques d'évaluation du gestionnaire de charges de travail
Collecte des métriques de surveillance SAP HANA

Pour en savoir plus sur l'authentification requise pour l'agentGoogle Cloudpour SAP, consultez la section Authentification et accès.

Pour connaître les autorisations requises par l'agent Cloud Monitoring, consultez la documentation de Monitoring suivante :

Problème : Niveaux d'accès incorrects pour le compte de service de VM

Problème:si vous limitez les niveaux d'accès sur votre instance de VM hôte, les journaux de l'agentGoogle Cloudpour SAP peuvent afficher une erreur d'autorisation IAM insuffisante.

Cause:l'agent Google Cloudpour SAP nécessite un minimum de niveaux d'accès aux API Cloud sur l'instance de VM hôte. Cette erreur se produit lorsque le compte de service ne dispose pas des niveaux d'accès requis.

Solution : les champs d'application d'accès représentent l'ancienne méthode de spécification des autorisations associées à votre instance de VM. Compute Engine recommande de configurer vos instances de VM 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 la VM pour contrôler les accès aux ressources Google Cloud .

Pour résoudre ce problème, il est recommandé de définir tous les niveaux d'accès cloud-platform sur l'instance de VM, puis de restreindre de manière sécurisée les accès du compte de service aux API à l'aide de rôles IAM. Exemple :

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

Si vous limitez les niveaux d'accès de votre instance de VM, vous devez vous assurer que la VM hôte dispose des niveaux d'accès suivants :

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

Si vous avez activé la collecte des métriques de surveillance des processus, des métriques d'évaluation du gestionnaire de charges de travail ou des métriques de surveillance SAP HANA, les champs d'application d'accès de l'instance de VM hôte doivent également disposer d'un accès en écriture pour publier des données de métrique sur votre projet Google Cloud :

  • https://www.googleapis.com/auth/monitoring.write

Pour modifier les niveaux d'accès, vous devez arrêter votre instance de VM, apporter les modifications nécessaires, puis la redémarrer. Pour savoir comment procéder, consultez la documentation Compute Engine. Ce problème ne nécessite pas que vous modifiez les autorisations relatives aux rôles IAM.

Problème : Agent hôte SAP manquant ou incorrect

Problème:les journaux de l'agent Google Cloudpour SAP sont manquants ou incorrects.

Cause : l'agent hôte SAP ou le niveau de correctif minimal requis pour l'agent hôte SAP n'est pas installé. Pour que l'agent Google Cloudpour SAP fonctionne, votre système SAP doit avoir installé l'agent hôte SAP et le niveau de correctif minimal requis pour l'agent hôte est conservé.

Solution : pour résoudre ce problème, installez la version requise de l'agent hôte SAP. Pour savoir comment installer l'agent hôte SAP, consultez la documentation SAP.

Pour connaître les exigences relatives à la version de l'agent hôte SAP, consultez les notes SAP suivantes :

Problème: Échec de l'installation de l'agent Google Cloudpour SAP

Problème : l'installation de l'agent échoue lorsque la commande d'installation du gestionnaire de packages (yum, zypper ou googet) est exécutée.

Cause : l'installation de l'agent échoue, car le serveur hôte qui exécute l'agent a été créé sans adresse IP publique.

Solution : pour résoudre ce problème, configurez une passerelle NAT qui fournit au serveur hôte un accès sortant à Internet. Pour en savoir plus sur la configuration d'une passerelle NAT, consultez le guide de déploiement de votre système SAP. Par exemple, pour SAP NetWeaver, consultez les pages suivantes :

Problème : Échec de la collecte des métriques de surveillance SAP HANA

Problème:lors de la mise à niveau à partir de l'agent de surveillance pour SAP HANA, un message d'erreur semblable à celui-ci s'affiche après l'installation de l'agent Google Cloudpour SAP:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Cause:l'agent Google Cloudpour SAP ne peut pas démarrer la collecte des métriques de surveillance SAP HANA, car les instances SAP HANA cibles utilisent des certificats SSL spécifiés avec le nom commun (CN).

Résolution : pour résoudre ce problème, procédez comme suit :

  1. Pour les instances SAP HANA que vous souhaitez surveiller à l'aide de l'agentGoogle Cloudpour SAP, vous devez passer à un certificat SSL (SAN, Subject Alternative Name) au lieu des certificats SSL spécifiés avec le nom commun (CN).

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

  3. Ouvrez le fichier de configuration de l'agent Google Cloudpour SAP:

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

  4. Dans la section hana_monitoring_configuration, définissez le paramètre enabled sur true.

  5. 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 valeur spécifiée dans le certificat TLS/SSL.

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

  6. Enregistrez le fichier de configuration.

  7. Redémarrez l'agent Google Cloudpour SAP pour que les nouveaux paramètres prennent effet:

    sudo systemctl restart google-cloud-sap-agent

  8. 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.

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

Problème: erreur "Connexion refusée"

Problème : les journaux de l'agent hôte SAP affichent l'erreur "Connexion refusée".

Cause:l'agent pour SAP de Google Cloudne peut pas démarrer, car le port 18181 n'est pas disponible.L'agent pour SAP de Google Cloudécoute les requêtes sur le port 18181. Ce port doit être disponible pour que l'agent démarre.

Solution:pour résoudre ce problème, assurez-vous que le port 18181 est disponible pour l'agent Google Cloudpour SAP. Si un autre service utilise le port 18181, vous devrez peut-être redémarrer cet autre service ou le reconfigurer pour qu'il utilise un autre port.

Problème: pour les images d'OS SLES 15 SP4 pour SAP et versions ultérieures,l'agent pour SAP de Google Cloudne s'exécute pas

Problème:Lorsque vous utilisez les images d'OS SLES "pour SAP", l'agentGoogle Cloudpour SAP est préinstallé. Toutefois, pour les images d'OS SLES 15 SP4 pour SAP et versions ultérieures, l'agent préinstallé pour SAP ne démarre pas seul.

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

  1. Connectez-vous à l'instance de VM hôte ou au serveur de solution Bare Metal.

  2. Exécutez la commande suivante : 

    systemctl status google-cloud-sap-agent

    Si l'agent n'est pas en cours d'exécution, le résultat contient inactive (dead). Par exemple : 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Cause : l'agent pour SAP ne démarre pas seul en raison d'un problème avec le packaging de système d'exploitation.

Résolution : pour résoudre le problème, procédez comme suit :

  1. Connectez-vous à l'instance de VM hôte ou au serveur de solution Bare Metal.

  2. Exécutez les commandes suivantes :

    sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

  3. Vérifiez que l'agent est en cours d'exécution : 

    systemctl status google-cloud-sap-agent

    Un résultat semblable aux lignes suivantes doit s'afficher :

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

Obtenir de l'aide concernant l'agent pour SAP de Google Cloud

Si vous avez besoin d'aide pour résoudre un problème lié à l'agent Google Cloudpour SAP, rassemblez les informations de diagnostic nécessaires et contactez Cloud Customer Care. Pour en savoir plus, consultez la section Version 2:Informations de diagnostic de l'agent Google Cloudpour SAP.