Version 2: Configurer la collecte des métriques d'évaluation du gestionnaire de charges de travail

Ce guide vous explique comment configurer la version 2 de l'agent Google Cloud pour SAP afin de collecter les métriques d'évaluation du gestionnaire de charges de travail à partir de vos systèmes SAP.

Pour en savoir plus sur cette fonctionnalité, consultez la page Évaluation du gestionnaire de charges de travail à l'aide de l'agent Google Cloud pour SAP.

Avant de commencer

Définir des rôles IAM

Pour autoriser l'agent Google Cloud pour SAP à collecter les métriques d'évaluation du gestionnaire de charges de travail, vous devez vous assurer que le compte de service utilisé par votre instance Compute Engine ou votre serveur de solution Bare Metal inclut les rôles suivants:

Pour ajouter ces rôles requis à votre compte de service, procédez comme suit :

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

    Accéder à IAM

  2. Sélectionnez votre projet Google Cloud.

  3. Identifiez le compte de service auquel vous souhaitez ajouter un rôle.

    • Si ce compte de service ne figure pas déjà sur la liste des comptes principaux, cela signifie qu'aucun rôle ne lui a encore été attribué. Cliquez sur Ajouter, puis saisissez l'adresse e-mail du compte de service.
    • Si le compte de service figure déjà sur la liste des comptes principaux, il possède des rôles. Cliquez sur le bouton Modifier correspondant au compte de service que vous souhaitez modifier.

  4. Sélectionnez le rôle requis dans la liste des rôles disponibles :

    • Lecteur de Compute
    • Monitoring > Rédacteur de statistiques de surveillance
    • Secret Manager > Accesseur de secrets de Secret Manager

  5. Cliquez sur Ajouter ou sur Enregistrer pour appliquer le ou les rôles sélectionnés au compte de service.

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

Pour activer la collecte de métriques d'évaluation du gestionnaire de charges de travail à l'aide de l'agent Google Cloud pour SAP, procédez comme suit :

  1. Établissez une connexion SSH avec votre instance Compute Engine ou votre serveur de solution Bare Metal.

  2. Modifiez le fichier de configuration de l'agent :

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

  3. Dans la section collection_configuration, définissez la valeur true pour le paramètre collect_workload_validation_metrics.

  4. Pour activer la collecte de métriques workload.googleapis.com/sap/validation/hanasecurity permettant d'activer les règles d'évaluation de sécurité dans le gestionnaire de charges de travail, ajoutez la section workload_validation_db_metrics_config après collect_workload_validation_metrics, puis spécifiez les paramètres suivants :

    • hana_db_user : spécifiez le compte utilisateur utilisé pour interroger l'instance SAP HANA.
    • hana_db_password_secret_name : spécifiez le nom du secret dans Secret Manager qui stocke le mot de passe du compte utilisateur.
    • hostname : spécifiez l'identifiant de la machine locale ou distante qui héberge votre instance SAP HANA.
    • port : spécifiez le port sur lequel l'instance SAP HANA accepte les requêtes.

    Pour plus d'informations sur ces paramètres, consultez la section Paramètres de configuration.

  5. Si vous le souhaitez, dans la section cloud_properties, vous pouvez mettre à jour les valeurs de paramètres définies automatiquement. Pour ce faire, ajoutez la section cloud_properties à votre fichier de configuration, puis spécifiez les paramètres requis et leurs valeurs.

  6. Enregistrez le fichier de configuration.

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

    sudo systemctl restart google-cloud-sap-agent

Exemples de fichiers de configuration

Instance Compute Engine

L'exemple suivant est un fichier de configuration terminé de l'agent Google Cloud pour SAP version 2 s'exécutant surune instance de Compute Engine, où la collecte des métriques d'évaluation du gestionnaire de charges de travail est activée:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Serveur de solution Bare Metal

L'exemple suivant est un fichier de configuration terminé de l'agent Google Cloud pour SAP version 2 s'exécutant surun serveur de solution Bare Metal, où la collecte des métriques d'évaluation du gestionnaire de charges de travail est activée:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Paramètres de configuration

Le tableau suivant explique les paramètres de configuration de l'agent Google Cloud pour SAP qui sont spécifiques à la collecte des métriques d'évaluation du gestionnaire de charges de travail.

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

Boolean

Pour activer la détection du système SAP, 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 Compute Engine, il détecte automatiquement l'ID du projet par défaut.
cloud_properties.instance_name

String

Si votre système SAP s'exécute sur une instance Compute Engine, spécifiez le nom de cette instance. L'agent détecte automatiquement le nom de l'instance Compute lors de l'installation.

Si votre système SAP s'exécute sur un serveur de solution Bare Metal, spécifiez le nom de ce serveur. Dans la version 2.5 ou antérieure de l'agent, spécifiez le nom du serveur de solution Bare Metal pour la propriété instance_id.
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 calcul, il utilise par défaut la région dans laquelle l'instance de calcul est déployée.
cloud_properties.zone

String

Lorsque l'agent s'exécute sur une instance de calcul, il utilise par défaut la zone où l'instance de calcul est déployée.
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 calcul, il détecte automatiquement l'image d'OS utilisée par l'instance de calcul par défaut.
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 calcul, il détecte automatiquement le numéro de projet par défaut.
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.

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

String

Spécifiez le mot de passe du compte utilisateur utilisé pour interroger l'instance 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.sid

String

Spécifiez le SID de votre instance SAP HANA.
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.