Version 1 : Installer et configurer l'agent Google Cloud pour SAP sur un serveur de solution Bare Metal

Version 1

• Version 3.2 (latest)
• Version 2
• Version 1

L'agent Google Cloud pour SAP est requis pour pouvoir utiliser SAP avec les systèmes SAP exécutés sur un serveur de solution Bare Metal.

Si vous utilisez les images "pour SAP" suivantes des OS RHEL ou SLES, fournies par Google Cloud, l'agent Google Cloud pour SAP sera empaqueté avec les images d'OS :

• RHEL : toutes les images "for SAP"
• SLES : SLES 15 SP4 pour SAP et versions ultérieures

Pour plus d'informations sur les systèmes d'exploitation disponibles pour exécuter SAP sur des serveurs de solution Bare Metal, consultez les ressources suivantes :

• Pour SAP HANA, consultez la section Systèmes d'exploitation certifiés.
• Pour SAP NetWeaver, consultez la section Systèmes d'exploitation certifiés.

Pour installer et configurer la version 1 de l'agent Google Cloud pour SAP sur une instance de VM Compute Engine, consultez la page Installer l'agent Google Cloud pour SAP sur une instance de VM Compute Engine.

Présentation de l'installation

Vous installez l'agent Google Cloud pour SAP à l'aide des commandes standards de gestion des packages du système d'exploitation : la commande yum sur RHEL et la commande zypper sur SLES. La commande de gestion des packages effectue les tâches suivantes :

• Elle télécharge l'agent Google Cloud pour SAP.
• Elle crée l'agent en tant que service systemd Linux nommé google-cloud-sap-agent.
• Elle active et démarre le service google-cloud-sap-agent.

Installer l'agent

Nous vous recommandons d'installer la dernière version de l'agent Google Cloud pour SAP, car elle prend en charge un plus grand nombre de fonctionnalités. Pour obtenir des instructions, consultez la page Installer et configurer l'agent Google Cloud pour SAP sur un serveur de solution Bare Metal.

Pour installer la version 1 de l'agent Google Cloud pour SAP, contactez l'assistance Cloud Customer Care.

Après avoir installé l'agent Google Cloud pour SAP et l'agent hôte SAP, vérifiez l'installation de l'agent Google Cloud pour SAP, comme décrit dans la section Vérifier l'installation de l'agent.

Vérifier l'installation de l'agent

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

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
   

Si l'agent n'est pas en cours d'exécution, redémarrez-le.

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

Configurer l'agent Google Cloud pour SAP sous Linux

Après avoir installé l'agent Google Cloud pour SAP, vous pouvez éventuellement le configurer pour activer la collecte des métriques de surveillance des processus et des métriques d'évaluation du gestionnaire de charges de travail. Par défaut, seule la collecte des métriques de l'agent hôte SAP est activée.

La collecte des métriques d'évaluation du gestionnaire de charges de travail et des métriques de surveillance des processus n'est possible que sous Linux.

Si vous activez la collecte de métriques d'évaluation et de métriques de gestionnaire de charge de travail, vous devez remplir les conditions préalables suivantes :

• Créez un compte de service IAM pour que l'agent puisse accéder aux ressources Google Cloud. Attribuez le rôle IAM requis au compte de service. Pour en savoir plus, consultez la section Configurer un compte de service.
• Sur le serveur de solution Bare Metal, installez gcloud CLI. Pour en savoir plus, consultez la page Installer gcloud CLI.
• Pour accéder à Google Cloud, autorisez gcloud CLI. Pour en savoir plus, consultez la page Autoriser gcloud CLI.
• Établissez une connexion aux API Google Cloud Pour en savoir plus, consultez la section Configurer l'accès privé à Google pour les hôtes sur site.

Configurer un compte de service

Pour permettre à l'agent d'accéder aux ressources Google Cloud à partir d'un environnement de solution Bare Metal, vous devez configurer un compte de service IAM.

Le compte de service utilisé par l'agent doit au moins inclure le rôle Rédacteur de métriques de surveillance (roles/monitoring.metricWriter).

Pour créer un compte de service, procédez comme suit :

1. Créez un compte de service :

   1. Dans la console Google Cloud, accédez à la page Créer un compte de service.

      Accéder à la page "Créer un compte de service"
   2. Sélectionnez votre projet.

   3. Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.

      Dans le champ Description du compte de service, saisissez une description. Exemple : Service account for quickstart.

   4. Cliquez sur Créer et continuer.

   5. Attribuez le rôle Monitoring > Monitoring Metric Writer au compte de service.

      Pour accorder le rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez Monitoring > Monitoring Metric Writer.

      Remarque : Le champ Rôle détermine les ressources auxquelles le compte de service peut accéder dans votre projet. Vous pouvez révoquer ces rôles ou attribuer des rôles supplémentaires ultérieurement. Dans les environnements de production, n'attribuez pas les rôles Propriétaire, Éditeur et Lecteur. Attribuez plutôt un rôle prédéfini ou un rôle personnalisé répondant à vos besoins.
   6. Cliquez sur Continuer.

   7. Cliquez sur OK pour terminer la création du compte de service.

      Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.

2. Créez une clé de compte de service :

   1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
   2. Cliquez sur Keys (Clés).
   3. Cliquez sur Ajouter une clé, puis sur Créer une clé.
   4. Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
   5. Cliquez sur Close (Fermer).

Importez le fichier de clé JSON sur un emplacement sécurisé du serveur Bare Metal accessible à l'agent.

Activer la collecte des métriques de surveillance des processus et des métriques d'évaluation du gestionnaire de charges de travail

Pour activer la collecte des métriques de surveillance des processus et des métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit :

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

2. Ouvrez le fichier de configuration suivant :

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

3. Dans la section collection_configuration, définissez les propriétés suivantes sur true :

   • collect_process_metrics : permet à l'agent de collecter des métriques de surveillance des processus. Pour collecter les métriques de la base de données SAP HANA, vous devez configurer des propriétés supplémentaires dans la section hana_metrics_config afin d'accéder à la base de données SAP HANA et de l'interroger.
   • collect_workload_validation_metrics : permet à l'agent de collecter des métriques d'évaluation du gestionnaire de charges de travail.

   Pour en savoir plus sur les paramètres, consultez le tableau suivant.

4. Enregistrez le fichier de configuration.

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

   sudo systemctl restart google-cloud-sap-agent

Paramètres de configuration

Le tableau suivant explique les paramètres de configuration de la version 1 de l'agent Google Cloud pour SAP.

Paramètres
provide_sap_host_agent_metrics	Boolean Pour activer la collecte des métriques requises par l'agent hôte SAP, spécifiez true. La valeur par défaut est true. Ne définissez pas provide_sap_host_agent_metrics sur false, sauf si vous êtes dirigé par le service client Cloud Customer Care ou l'assistance SAP.
bare_metal	Boolean Lorsque l'agent est installé sur un serveur de solution Bare Metal, spécifiez true. La valeur par défaut est false.
log_level	String Pour définir le niveau de journalisation de l'agent, définissez la valeur requise. Les niveaux de journalisation disponibles sont les suivants : DEBUG INFO WARNING ERROR La valeur par défaut est INFO. Ne modifiez pas le niveau de journalisation, sauf si vous êtes dirigé par le service client Cloud Customer Care.
log_to_cloud	Boolean Pour rediriger les journaux de l'agent vers Cloud Logging, spécifiez true. La valeur par défaut est true.
cloud_properties.project_id	String Si votre système SAP s'exécute sur un serveur de solution Bare Metal, spécifiez l'ID du projet Google Cloud que vous utilisez avec la solution Bare Metal. Lorsque l'agent s'exécute sur une instance de VM, il détecte automatiquement l'ID du projet par défaut.
cloud_properties.instance_id	String Spécifiez le nom du serveur de solution Bare Metal sur lequel vous avez installé l'agent.
cloud_properties.region	String Si votre système SAP s'exécute sur un serveur de solution Bare Metal, spécifiez la région du serveur de solution Bare Metal. Lorsque l'agent s'exécute sur une instance de VM, il utilise par défaut la région de l'instance de VM sur laquelle il est installé.
cloud_properties.zone	String Lorsque l'agent s'exécute sur une instance de VM, il utilise par défaut la zone de l'instance de VM sur laquelle il est installé.
cloud_properties.image	String Indiquez le nom d'image de l'OS de l'instance. Lorsque l'agent s'exécute sur une instance de VM, il détecte par défaut l'image d'OS de l'instance de VM sur laquelle il est installé.
cloud_properties.numeric_project_id	String Spécifiez l'ID numérique du projet Google Cloud dans lequel le système SAP est exécuté. Lorsque l'agent s'exécute sur une instance de VM, il détecte automatiquement l'ID numérique du projet par défaut.
collection_configuration.collect_process_metrics	Boolean Pour activer la collecte des métriques de surveillance des processus, spécifiez true. La valeur par défaut est false. Ce paramètre ne s'applique qu'à Linux. Si vous activez la collecte des métriques de processus pour SAP HANA, vous devez configurer des paramètres supplémentaires répertoriés sous hana_metrics_config.
collection_configuration.process_metrics_frequency	Int Spécifiez la fréquence de collecte des métriques de surveillance du processus, en secondes. La valeur par défaut de ce paramètre est 5 secondes. Bien que vous puissiez mettre à jour la fréquence de collecte des métriques de surveillance des processus, nous vous recommandons d'utiliser la valeur par défaut. Si vous devez modifier la valeur par défaut, ajoutez le paramètre process_metrics_frequency sous la section collection_configuration et indiquez la valeur requise.
collection_configuration.hana_metrics_config.hana_db_user	String Spécifiez le compte utilisateur de base de données utilisé par l'agent pour interroger SAP HANA. La valeur par défaut est SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password	String Spécifiez le mot de passe en texte brut du compte utilisateur de base de données utilisé par l'agent pour interroger SAP HANA. Plutôt que d'utiliser un mot de passe en texte brut, nous vous recommandons d'utiliser un secret dans Secret Manager en spécifiant le nom de le secret dans hana_db_password_secret_name. Ne spécifiez pas de mot de passe si vous utilisez Secret Manager pour stocker les identifiants de l'utilisateur de la base de données. Lorsque hana_db_password et hana_db_password_secret_name sont spécifiés dans la configuration, une erreur est déclenchée et l'agent ne peut pas se connecter à la base de données.
collection_configuration.hana_metrics_config.hana_db_password_secret_name	String Pour fournir le mot de passe du compte utilisateur de base de données utilisé par l'agent pour interroger SAP HANA de manière sécurisée, spécifiez le nom du secret contenant les identifiants de sécurité du compte utilisateur de base de données. Les métriques liées à SAP HANA ne sont collectées que si hana_db_password_secret_name ou hana_db_password est défini. Important : Le secret et l'instance de VM hôte doivent se trouver dans le même projet Google Cloud.
collection_configuration.collect_workload_validation_metrics	Boolean Pour activer la collecte des métriques d'évaluation du gestionnaire de charges de travail, spécifiez true. À partir de la version 3.2, la valeur par défaut est true. Ce paramètre ne s'applique qu'à Linux.
collection_configuration.workload_validation_metrics_frequency	Int Fréquence de collecte des métriques d'évaluation du gestionnaire de charges de travail, en secondes. La valeur par défaut est de 300 secondes. Nous vous déconseillons de modifier la fréquence de collecte par défaut, car cela pourrait affecter l'ensemble de la fonctionnalité. Si vous devez modifier la fréquence de collecte des métriques du gestionnaire de charges de travail, ajoutez le paramètre workload_validation_metrics_frequency sous la section collection_configuration et indiquez la valeur requise.
collection_configuration.workload_validation_db_metrics_config.hana_db_user	String Spécifiez le compte utilisateur utilisé pour interroger l'instance SAP HANA. Le compte utilisateur doit disposer de l'autorisation de lecture sur la base de données SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String Spécifiez le nom du secret dans Secret Manager qui stocke le mot de passe du compte utilisateur.
collection_configuration.workload_validation_db_metrics_config.hostname	String Spécifiez l'identifiant de la machine locale ou distante qui héberge votre instance SAP HANA. Les valeurs acceptées sont les suivantes : Si l'hôte est un ordinateur local, spécifiez la chaîne localhost ou l'adresse IP de rebouclage de l'hôte local, comme 127.0.0.1. Si l'hôte est une machine distante, spécifiez son adresse IP interne ou externe.
collection_configuration.workload_validation_db_metrics_config.port	String Spécifiez le port sur lequel l'instance SAP HANA accepte les requêtes. Pour la première ou la seule instance de base de données locataire, le port est 3NN15, où NN correspond au numéro de l'instance SAP HANA.
collection_configuration.workload_validation_db_metrics_frequency	Int Fréquence de collecte des métriques de base de données SAP HANA, en secondes, pour l'évaluation du gestionnaire de charges de travail. La valeur par défaut est de 3600 secondes. Bien que vous puissiez mettre à jour la fréquence de collecte des métriques de base de données SAP HANA, nous vous recommandons d'utiliser la valeur par défaut. Si vous devez modifier la valeur par défaut, ajoutez le paramètre workload_validation_db_metrics_frequency sous la section collection_configuration et indiquez la valeur requise. Assurez-vous de ne pas définir de fréquence de collecte supérieure à 3600 secondes.

Configuration par défaut

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

Exemple de configuration

Pour installer l'agent sur une solution Bare Metal, vous devez ajouter les paramètres requis au fichier de configuration. L'exemple suivant montre un fichier de configuration terminé pour l'installation de l'agent sur un serveur de solution Bare Metal.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

Afficher les métriques collectées

Pour visualiser les métriques de surveillance des processus collectées par l'agent, vous pouvez utiliser les tableaux de bord personnalisés suivants fournis par Google Cloud :

• Présentation de l'état de l'agent SAP HANA : ce tableau de bord fournit des graphiques qui indiquent l'état des métriques suivantes : disponibilité SAP HANA, haute disponibilité SAP HANA, réplication haute disponibilité SAP HANA, état du service SAP HANA, état du cluster haute disponibilité et des nœuds, état du cluster haute disponibilité et des ressources pour les instances SAP.

  Le fichier JSON de ce tableau de bord est sap-agent-status-overview.json.

• Métriques brutes de l'agent SAP HANA : ce tableau de bord fournit des graphiques qui indiquent les valeurs des métriques brutes suivantes : disponibilité SAP HANA, haute disponibilité SAP HANA, réplication haute disponibilité SAP HANA, état du service SAP HANA, état du cluster haute disponibilité et des nœuds, état du cluster haute disponibilité et des ressources pour les instances SAP.

  Le fichier JSON de ce tableau de bord est sap-agent-raw-metrics.json.

Installer des tableaux de bord

Pour installer un tableau de bord personnalisé, procédez comme suit :

Console Google Cloud

1. Dans la console Google Cloud, accédez à la page Monitoring :

   Accéder à Monitoring

2. Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.

3. Cliquez sur l'onglet Exemple de bibliothèque.

   

4. Pour filtrer les tableaux de bord personnalisés spécifiques à l'agent, saisissez Agent for SAP dans le champ Filtre.

5. (Facultatif) Pour afficher les détails d'un tableau de bord ou pour prévisualiser son contenu, cliquez sur Aperçu.

6. Sélectionnez le tableau de bord que vous souhaitez installer.

7. Cliquez sur Importer, puis sur Confirmer.

   Le tableau de bord est ajouté aux tableaux de bord disponibles dans votre projet Google Cloud. Pour afficher votre tableau de bord, suivez les instructions de la section Afficher le tableau de bord installé.

Google Cloud CLI

1. Ouvrez Cloud Shell.

   Ouvrir Cloud Shell

2. Dans Cloud Shell, clonez ou téléchargez le dépôt :

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

3. Dans Cloud Shell, installez le tableau de bord requis à l'aide du fichier JSON correspondant :

   gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

   Remplacez CONFIG_FROM_FILE par le chemin d'accès au fichier JSON contenant la configuration du tableau de bord. Les fichiers de configuration du tableau de bord peuvent se trouver à l'emplacement monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

   Le tableau de bord est ajouté aux tableaux de bord disponibles dans votre projet Google Cloud. Pour afficher votre tableau de bord, suivez les instructions de la section Afficher le tableau de bord installé.

Afficher les tableaux de bord installés

Pour afficher les tableaux de bord installés, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Monitoring :

   Accéder à Monitoring

2. Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.

3. Cliquez sur le nom du tableau de bord dans la liste.

Si vous disposez d'un grand nombre de tableaux de bord, vous pouvez appliquer un filtre pour n'afficher que les tableaux de bord personnalisés ou le nom du nouveau tableau de bord. Pour en savoir plus sur le filtrage de cette liste, consultez la section Afficher des tableaux de bord personnalisés.

L'image suivante est un exemple qui montre une partie du tableau de bord personnalisé pour les métriques SAP HANA dans Monitoring.

Dépannage

Pour en savoir plus sur le diagnostic et la résolution des problèmes que vous pourriez rencontrer lors de l'installation et de la configuration de l'agent Google Cloud pour SAP, consultez le guide de dépannage de l'agent Google Cloud pour SAP.

Obtenir de l'aide

Si vous avez besoin d'aide pour résoudre des problèmes liés à l'agent Google Cloud pour SAP, collectez toutes les informations de diagnostic disponibles et contactez Cloud Customer Care. Pour savoir comment contacter le service client, consultez la page Obtenir de l'aide pour SAP sur Google Cloud.