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

Vérifier l'installation de l'agent Google Cloud pour SAP Pour obtenir des instructions, consultez le guide d'installation pour votre scénario.
Si vous avez installé l'agent sur un serveur de solution Bare Metal, assurez-vous de remplir les conditions préalables requises et de configurer un compte de service. Pour obtenir des instructions, consultez la page Configurer l'agent Google Cloud pour SAP sous Linux.

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 de VM Compute Engine ou votre serveur de solution Bare Metal inclut les rôles suivants :

Lecteur Compute (roles/compute.viewer)
Rédacteur de métriques Monitoring (roles/monitoring.metricWriter)
Accesseur de secrets Secret Manager (roles/secretmanager.secretAccessor), si vous utilisez Secret Manager pour stocker le mot de passe de la base de données SAP HANA.

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

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

Accéder à IAM
Sélectionnez votre projet Google Cloud.
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.
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
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 :

Établissez une connexion SSH avec votre instance de VM Compute Engine ou votre serveur de solution Bare Metal.
Modifiez le fichier de configuration de l'agent :
```
/etc/google-cloud-sap-agent/configuration.json
```
Dans la section collection_configuration, définissez la valeur true pour le paramètre collect_workload_validation_metrics.
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.
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.
Enregistrez le fichier de configuration.
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 de VM Compute Engine

L'exemple suivant est un fichier de configuration terminé de l'agent Google Cloud pour SAP s'exécutant sur de serveur 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": 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",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_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 s'exécutant sur une instance de VM 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": 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",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "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 de VM, 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 de VM Compute Engine, spécifiez le nom de cette instance. L'agent détecte automatiquement le nom de l'instance de VM 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 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_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. Vous pouvez également spécifier le paramètre de configuration `hdbuserstore_key` pour authentifier l'utilisateur SAP HANA spécifié.
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` Pour authentifier l'utilisateur SAP HANA que vous spécifiez pour `hana_db_user`, spécifiez une clé `hdbuserstore` que vous avez créée pour cet utilisateur. Pour utiliser une clé `hdbuserstore` pour l'authentification, assurez-vous de remplir les conditions suivantes : Les outils SAP `hdbsql` et `hdduserstore` sont installés sur l'instance de calcul qui héberge l'agent. La clé `hdbuserstore` correspond à une instance SAP HANA spécifique. Vous ne pouvez pas utiliser de clés contenant les noms d'hôte de plusieurs instances SAP HANA. Si vous spécifiez `hdbuserstore_key`, vous pouvez ignorer les paramètres `hostname` et `port`.
`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.