Ce guide vous explique comment configurer l'agent Google Cloudpour 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 Cloudpour SAP.
Avant de commencer
- Vérifiez l'installation de l'agent Google Cloudpour 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 Cloudpour SAP sous Linux.
Assurez-vous que l'API Workload Manager est activée pour votre projetGoogle Cloud .
Rôles IAM requis
Pour vous assurer que le compte de service dispose des autorisations nécessaires pour autoriser l'agent Google Cloudpour SAP à collecter les métriques d'évaluation du Gestionnaire de charges de travail, demandez à votre administrateur d'accorder au compte de service les rôles IAM suivants sur votre projet :
-
Lecteur Compute (
roles/compute.viewer
) : pour collecter les métriques d'évaluation du gestionnaire de charges de travail à partir de l'instance Compute Engine qui héberge votre système SAP. -
Rédacteur d'insights Workload Manager (
roles/workloadmanager.insightWriter
) : permet d'écrire les métriques collectées dans le data warehouse Workload Manager. -
(Facultatif) Accesseur de secrets Secret Manager (
roles/secretmanager.secretAccessor
) : si vous utilisez Secret Manager pour stocker le mot de passe permettant de se connecter à la base de données SAP HANA.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour autoriser l'Agent Google Cloudpour SAP à collecter les métriques d'évaluation du Gestionnaire de charges de travail. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour autoriser l'agent Google Cloudpour SAP à collecter les métriques d'évaluation du gestionnaire de charges de travail :
-
Pour collecter les métriques d'évaluation du gestionnaire de charges de travail à partir de l'instance Compute Engine hôte et les écrire dans le data warehouse du gestionnaire de charges de travail :
-
monitoring.timeSeries.create
-
compute.zoneOperations.list
-
compute.disks.list
-
compute.nodeGroups.get
-
workloadmanager.insights.write
-
-
Si vous utilisez Secret Manager pour stocker le mot de passe permettant de se connecter à la base de données SAP HANA, procédez comme suit pour accéder au secret :
secretmanager.versions.access
Votre administrateur peut également attribuer au compte de service ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Rôles SAP HANA requis
Pour autoriser l'agent à collecter des métriques à partir de votre base de données SAP HANA, assurez-vous que l'utilisateur SAP HANA que vous spécifiez dans le fichier de configuration de l'agent dispose du rôle MONITORING
.
Pour en savoir plus sur ce rôle, consultez le document SAP Rôles de base de données standards.
Vérifier la version de l'agent
Google Cloud vous recommande d'installer la dernière version de l'agent pour SAP afin d'obtenir une évaluation précise de vos charges de travail SAP, car les versions périodiques de l'agent pour SAP peuvent ajouter ou modifier des métriques utilisées pour l'évaluation.
Pour vous assurer que vous disposez de la dernière version de l'agent Google Cloudpour SAP, vous devez régulièrement vérifier si des mises à jour sont disponibles et mettre à jour l'agent.
Installer une mise à jour
Sélectionnez votre système d'exploitation, puis procédez comme suit :
RHEL
- Établissez une connexion ssh avec votre instance.
- Mettez à jour votre instance d'agent :
- (Recommandé) Pour effectuer la mise à jour vers la version 3.8 (la plus récente) de l'agent :
sudo yum --nogpgcheck update google-cloud-sap-agent
- Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Remplacez
VERSION_NUMBER
par le numéro de version de l'agent que vous souhaitez installer, par exemple3.1-606637668
. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.
- (Recommandé) Pour effectuer la mise à jour vers la version 3.8 (la plus récente) de l'agent :
SLES
- Établissez une connexion ssh avec votre instance.
- Mettez à jour votre instance d'agent :
- (Recommandé) Pour effectuer la mise à jour vers la version 3.8 (la plus récente) de l'agent :
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- Pour effectuer la mise à jour vers une version spécifique de l'agent, procédez comme suit :
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Remplacez
VERSION_NUMBER
par le numéro de version de l'agent que vous souhaitez installer, par exemple3.1-606637668
. Pour en savoir plus sur les versions d'agent que vous pouvez installer, consultez la section Répertorier toutes les versions disponibles de l'agent.
- (Recommandé) Pour effectuer la mise à jour vers la version 3.8 (la plus récente) de l'agent :
Activer la collecte des métriques d'évaluation du gestionnaire de charges de travail
À partir de la version 3.2, les nouvelles installations de l'agent Google Cloudpour SAP sont activées par défaut pour collecter les métriques d'évaluation du gestionnaire de charges de travail. Si vous passez à la version 3.2 à partir d'une version précédente, vous pouvez également activer explicitement cette fonctionnalité. Pour ce faire, procédez comme suit :
Établissez une connexion SSH avec votre instance Compute Engine ou votre serveur de solution Bare Metal.
Pour permettre à l'agent de collecter les métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit:
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
Pour activer la collecte des métriques "Insights SAP HANA" et "Bonnes pratiques de sécurité SAP HANA", procédez comme suit :
Modifiez le fichier de configuration de l'agent :
/etc/google-cloud-sap-agent/configuration.json
Vous pouvez également effectuer cette configuration en exécutant des commandes. Pour en savoir plus, consultez Commandes de configuration pour l'agent Google Cloudpour SAP.
Ajoutez la section
workload_validation_db_metrics_config
aprèscollect_workload_validation_metrics
, puis spécifiez les paramètres suivants :hana_db_user
: spécifiez le compte utilisateur de base de données SAP HANA utilisé pour interroger l'instance SAP HANA.hostname
: spécifiez l'identifiant de la machine locale ou distante qui héberge votre instance SAP HANA.port
: spécifiez le port de base de données sur lequel l'instance SAP HANA accepte les requêtes. Par exemple, saisissez30015
si la base de données de votre locataire est à l'écoute sur le port30015
.sid
: spécifiez le SID de votre instance SAP HANA.hana_db_password_secret_name
: spécifiez le nom du secret Secret Manager qui stocke le mot de passe du compte utilisateur.À la place du secret, vous pouvez utiliser le paramètre de configuration
hdbuserstore_key
.hdbuserstore_key
: spécifiez la cléhdbuserstore
qui authentifie l'utilisateur que vous avez spécifié pourhana_db_user
.Si vous spécifiez
hdbuserstore_key
, vous ne devez pas spécifier les paramètreshostname
etport
.
Pour plus d'informations sur ces paramètres, consultez 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 sectioncloud_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 Compute Engine
Les exemples suivants sont des fichiers de configuration terminés de l'agentGoogle Cloudpour SAP s'exécutant sur unune instance Compute Engine, où la collecte des métriques d'évaluation du gestionnaire de charges de travail est activée.
Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant : si spécifié, le paramètre de configuration hdbuserstore_key
est préféré au paramètre hana_db_password
, qui est préféré au paramètre hana_db_password_secret_name
. Nous vous recommandons de ne définir qu'une seule option d'authentification dans votre fichier de configuration.
- L'exemple suivant utilise une clé de magasin d'utilisateurs sécurisé (
hdbuserstore
) pour l'authentification SAP HANA :{ "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" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- L'exemple suivant utilise un nom d'utilisateur et un secret Secret Manager pour l'authentification SAP HANA :
{ "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 }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- L'exemple suivant utilise un nom d'utilisateur et un mot de passe pour l'authentification SAP HANA. Nous vous recommandons d'utiliser plutôt un secret Secret Manager ou une clé de magasin d'utilisateurs sécurisé (
hdbuserstore
) pour l'authentification SAP HANA.{ "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": "TempPa55word", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Serveur de solution Bare Metal
Les exemples suivants sont des fichiers de configuration terminés de l'agentGoogle Cloudpour SAP s'exécutant sur unserveur de solution Bare Metal, où la collecte des métriques d'évaluation du gestionnaire de charges de travail est activée.
Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant : si spécifié, le paramètre de configuration hdbuserstore_key
est préféré au paramètre hana_db_password
, qui est préféré au paramètre hana_db_password_secret_name
. Nous vous recommandons de ne définir qu'une seule option d'authentification dans votre fichier de configuration.
- L'exemple suivant utilise une clé de magasin d'utilisateurs sécurisé (
hdbuserstore
) pour l'authentification SAP HANA :{ "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" }, "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, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } } - L'exemple suivant utilise un nom d'utilisateur et un secret Secret Manager pour l'authentification SAP HANA :
{ "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 }, "cloud_properties": { "project_id": "my-project", "instance_name": "bms-machine-1", "region": "us-central1" "image": "rhel-8" },
"discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } } - L'exemple suivant utilise un nom d'utilisateur et un mot de passe pour l'authentification SAP HANA. Nous vous recommandons d'utiliser plutôt un secret Secret Manager ou une clé de magasin d'utilisateurs sécurisé (
hdbuserstore
) pour l'authentification SAP HANA.{ "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": "TempPa55word", "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, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Paramètres de configuration
Le tableau suivant explique les paramètres de configuration de l'agentGoogle Cloudpour 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 |
Pour activer la collecte des métriques requises par l'agent hôte SAP, spécifiez |
bare_metal |
Lorsque l'agent est installé sur un serveur de solution Bare Metal, spécifiez |
log_level |
Pour définir le niveau de journalisation de l'agent, définissez la valeur requise. Les niveaux de journalisation disponibles sont les suivants :
La valeur par défaut est |
log_to_cloud |
Pour rediriger les journaux de l'agent vers Cloud Logging, spécifiez |
cloud_properties.project_id |
Si votre système SAP s'exécute sur un serveur de solution Bare Metal, spécifiez l'ID du projet que vous utilisez avec la solution Bare Metal. Google Cloud |
cloud_properties.instance_name
|
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. |
cloud_properties.region |
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. |
cloud_properties.zone |
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 |
Indiquez le nom d'image de l'OS de l'instance. |
cloud_properties.numeric_project_id |
Spécifiez l'ID numérique du projet Google Cloud dans lequel le système SAP est exécuté. |
discovery_configuration.enable_workload_discovery |
Pour permettre à l'agent de collecter les noms et les versions des produits SAP exécutés sur l'hôte, spécifiez Pour plus d'informations, consultez le codebase de l'agent dans le dépôt GitHub |
discovery_configuration.enable_discovery |
Pour envoyer à Cloud Logging les informations collectées par l'agent sur les produits SAP exécutés sur l'hôte, spécifiez Si vous spécifiez la valeur |
collection_configuration.collect_workload_validation_metrics |
Pour activer la collecte des métriques d'évaluation du gestionnaire de charges de travail, spécifiez |
collection_configuration.workload_validation_metrics_frequency |
Fréquence de collecte des métriques d'évaluation du gestionnaire de charges de travail, en secondes. La valeur par défaut est de Si vous devez modifier la fréquence de collecte des métriques du gestionnaire de charges de travail, ajoutez le paramètre |
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Facultatif. La valeur par défaut est |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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 |
Spécifiez le mot de passe du compte utilisateur utilisé pour interroger l'instance SAP HANA. Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant : si spécifié, le paramètre de configuration |
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
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 Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant : si spécifié, le paramètre de configuration |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Pour vous connecter de manière sécurisée à un système SAP HANA, spécifiez une clé de magasin d'utilisateurs sécurisé ( Pour utiliser une clé
Ce paramètre de configuration est compatible avec la version 3.3 de l'agent. Si vous spécifiez Pour l'authentification SAP HANA, l'agent utilise l'ordre de préférence suivant : si spécifié, le paramètre de configuration |
collection_configuration.workload_validation_db_metrics_config.sid |
Spécifiez le SID de votre instance SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Spécifiez l'identifiant de la machine locale ou distante qui héberge votre instance SAP HANA. Les valeurs acceptées sont les suivantes :
|
collection_configuration.workload_validation_db_metrics_config.port |
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 |
collection_configuration.workload_validation_db_metrics_frequency |
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 |
Valider la configuration pour la collecte des métriques d'évaluation du gestionnaire de charges de travail
Vous pouvez vérifier si vous avez configuré correctement Google Cloud pour la collecte des métriques d'évaluation du gestionnaire de charges de travail en exécutant la commande status
de l'agent. Cette commande est compatible avec la version 3.7 de l'agent.
Pour valider la configuration de Google Cloud , procédez comme suit :
- Établissez une connexion SSH avec votre instance Compute Engine.
- Exécutez la commande suivante :
sudo /usr/bin/google_cloud_sap_agent status
Si votre configuration pour la collecte des métriques d'évaluation du gestionnaire de charges de travail est correcte, la sortie inclut les éléments suivants. Google Cloud Votre configuration peut comporter d'autres valeurs que celles de
default
.Agent Status: ... Systemd Service Enabled: True Systemd Service Running: True Cloud API Full Scopes: True Configuration File: /etc/google-cloud-sap-agent/configuration.json Configuration Valid: True ... ---------------------------------------------------------------------------- System Discovery: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: enable_discovery: true (default) enable_workload_discovery: true (default) sap_instances_update_frequency: 60 (default) system_discovery_update_frequency: 14400 (default) ---------------------------------------------------------------------------- Workload Manager Evaluation: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: collect_workload_validation_metrics: true (default) config_target_environment: PRODUCTION (default) fetch_latest_config: true (default) workload_validation_db_metrics_frequency: 3600 (default) workload_validation_metrics_frequency: 300 (default) ...
- Si la sortie indique qu'une configuration est manquante, consultez les informations fournies dans les sections précédentes, effectuez les actions requises, puis exécutez à nouveau la commande
status
pour valider à nouveau la configuration.
Afficher les métriques collectées
Pour afficher les métriques d'évaluation du gestionnaire de charges de travail que l'agent collecte, procédez comme suit :
Consultez le fichier journal de l'agent :
Définissez le niveau de journalisation de l'agent sur
DEBUG
:sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
Une fois l'agent redémarré pour appliquer le nouveau niveau de journalisation, consultez le fichier journal de l'agent :
/var/log/google-cloud-sap-agent.log
Dans le fichier journal, recherchez les entrées contenant les éléments suivants :
workload.googleapis.com/sap/validation/
Voici un exemple qui montre les métriques d'évaluation du gestionnaire de charges de travail dans le fichier journal de l'agent :
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/system","value":1} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"instance_name","value":"n1-hana-sles15"} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"os","value":"sles-15-SP4"} ... {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/corosync","value":0} ...
Si votre instance d'agent est configurée pour envoyer des journaux à Cloud Logging, vous pouvez afficher les journaux de l'agent dans Cloud Logging.
Créez et exécutez une évaluation de votre charge de travail SAP dans le gestionnaire de charges de travail. Pour en savoir plus, consultez la section Créer et exécuter une évaluation.
Pour en savoir plus sur les bonnes pratiques compatibles avec Workload Manager pour évaluer les charges de travail SAP exécutées sur Google Cloud, consultez la page Bonnes pratiques pour le gestionnaire de charges de travail SAP.