Cette page a été traduite par l'API Cloud Translation.

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

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 3.6 (la plus récente) de l'agent Google Cloud pour SAP sur une instance Compute Engine, consultez la page Installer l'agent Google Cloud pour SAP sur une instance 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 la dernière version de 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

Pour installer l'agent Google Cloud pour SAP sur un serveur de solution Bare Metal, procédez comme suit :

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

Dans votre terminal, installez l'agent en exécutant la commande spécifique à votre système d'exploitation :

(Recommandé) Pour installer la version 3.6 (la plus récente) de l'agent:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent

SLES 15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

Pour installer une version spécifique de l'agent :

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
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 exemple 3.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.

Ouvrez le fichier de configuration suivant :
```
/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 Cloud pour SAP.
Modifiez ou ajoutez les paramètres suivants au fichier de configuration :
- Dans la première section :
  - bare_metal : défini sur true.
- Ajoutez la section cloud_properties et spécifiez les paramètres suivants :
  - project_id : spécifiez votre projet Google Cloud.
  - instance_name : spécifiez le nom de votre serveur de solution Bare Metal.
  - region : spécifiez la région du serveur de solution Bare Metal.
Enregistrez le fichier de configuration.

Redémarrez l'agent :

sudo systemctl restart google-cloud-sap-agent

Pour en savoir plus sur les paramètres de configuration, consultez Paramètres de configuration et Exemple de configuration.

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

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

Exécutez la commande suivante :

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 :

Dans votre système SAP, saisissez la transaction ST06.
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 activer d'autres fonctionnalités de l'agent en effectuant les configurations suivantes. Par défaut, la collecte des métriques de l'agent hôte SAP et des métriques d'évaluation du gestionnaire de charges de travail est activée.

Prérequis

Pour permettre à l'agent d'accéder aux ressources Google Cloud à partir d'un environnement de solution Bare Metal, 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, puis attribuez-lui les rôles IAM requis. 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 d'insights du gestionnaire de charges de travail (roles/workloadmanager.insightWriter).

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

Create a service account:
1. In the Google Cloud console, go to the Create service account page.
  Go to Create service account
2. Select your project.
3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
  
  In the Service account description field, enter a description. For example, Service account for quickstart.
4. Click Create and continue.
5. Grant the Workload Manager > Workload Manager Insights Writer role to the service account.
  
  To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights Writer.
  
  Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
6. Click Continue.
7. Click Done to finish creating the service account.
  
  Do not close your browser window. You will use it in the next step.
Create a service account key:
1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

Après avoir créé le compte de service, veillez à importer son fichier de clé JSON dans un emplacement sécurisé sur le serveur Bare Metal accessible à l'agent.

Activer les fonctionnalités

Une fois que vous avez configuré un compte de service pour votre solution Bare Metal et que vous lui avez attribué les rôles requis, vous pouvez activer d'autres fonctionnalités de l'agent Google Cloud pour SAP en effectuant les configurations suivantes:

Fichier de configuration par défaut

L'extrait suivant est un exemple de configuration par défaut de la version 3.6 (la plus récente) de l'agent Google Cloud pour SAP:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Pour afficher des exemples de fichiers de configuration spécifiques à une fonctionnalité, consultez son guide de configuration.

Paramètres de configuration

Le tableau suivant décrit les paramètres de configuration de l'agent Google Cloud pour SAP qui s'exécutent sur un serveur de solution Bare Metal, y compris les paramètres liés à la collecte de métriques. Pour plus d'informations sur les paramètres de configuration liés à la fonctionnalité Backint de l'agent, consultez la section Paramètres de configuration.

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 Compute Engine, il détecte automatiquement l'ID du projet par défaut.
`cloud_properties.instance_name`	`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 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.
`discovery_configuration.enable_workload_discovery`	`Boolean` Pour permettre à l'agent de collecter les noms et les versions des produits SAP exécutés sur l'hôte, spécifiez `true`. La valeur par défaut est `true`. Pour plus d'informations, consultez le codebase de l'agent dans le dépôt GitHub `google-cloud-sap-agent` sous GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` Pour envoyer à Cloud Logging les informations collectées par l'agent sur les produits SAP exécutés sur l'hôte, spécifiez `true`. La valeur par défaut est `true`. Si vous spécifiez la valeur `false`, l'agent stocke les informations collectées sur l'hôte et ne les envoie pas à Cloud Logging.
`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` À partir de la version 2.6, ce paramètre détermine la fréquence de collecte des métriques de surveillance des processus qui évoluent rapidement, en secondes. Les métriques de surveillance des processus qui évoluent rapidement sont: `sap/hana/availability`, `sap/hana/ha/availability` et `sap/nw/availability`. La valeur par défaut pour ce paramètre est `5` secondes. Nous vous recommandons d'utiliser cette valeur par défaut. Toutes les autres métriques de surveillance du processus (à évolution lente) sont collectées à une fréquence par défaut de 30 secondes. Pour modifier la fréquence de collecte des métriques de surveillance des processus qui évoluent lentement, utilisez le paramètre `slow_process_metrics_frequency`.
`collection_configuration.slow_process_metrics_frequency`	`Int` Spécifiez la fréquence de collecte des métriques de surveillance du processus à l'évolution lente en secondes. La valeur par défaut de ce paramètre est `30` secondes.
`collection_configuration.process_metrics_to_skip`	`Array` Spécifiez les métriques de surveillance de processus que vous ne souhaitez pas que l'agent collecte. Ce paramètre accepte les noms de métriques de surveillance des processus séparés par une virgule. Par exemple : `"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]`.
`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. Au lieu de spécifier un mot de passe en texte brut, nous vous recommandons d'utiliser l'une des options suivantes : `hana_db_password_secret_name`, pour lequel vous spécifiez un secret stocké dans Secret Manager. `hdbuserstore_key`, pour lequel vous spécifiez une clé `hdbuserstore`. 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.
`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. Important:Le secret et l'instance Compute Engine hôte doivent se trouver dans le même projet Google Cloud. L'agent ne collecte les métriques liées à SAP HANA que lorsque vous spécifiez `hana_db_password_secret_name`, `hdbuserstore_key` ou `hana_db_password`. 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.
`collection_configuration.hana_metrics_config.hdbuserstore_key`	`String` Pour vous connecter de manière sécurisée à un système SAP HANA, spécifiez une clé de magasin d'utilisateurs sécurisé (`hdbuserstore`) que vous avez créée pour ce système. Pour utiliser une clé `hdbuserstore` pour l'authentification, vérifiez les points suivants : Les outils SAP `hdbsql` et `hdbuserstore` 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. L'utilisateur `SIDadm` peut interroger la base de données SAP HANA à l'aide de cette clé. Ici, `SID` fait référence à la valeur que vous avez spécifiée pour le paramètre `sid`. Vous pouvez le vérifier en exécutant la commande suivante en tant qu'utilisateur `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Ce paramètre de configuration est compatible avec la version 3.3 de l'agent. 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.
`collection_configuration.hana_metrics_config.sid`	`String` Spécifiez le SID de votre instance SAP HANA. Si vous utilisez une clé `hdbuserstore` pour vous authentifier auprès de SAP HANA, consultez la section `hdbuserstore_key`.
`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_collection_definition.fetch_latest_config`	`Boolean` Facultatif. La valeur par défaut est `true`, ce qui permet à l'agent de collecter le dernier ensemble de métriques d'évaluation du gestionnaire de charges de travail sans que vous ayez à mettre à jour l'agent. Si vous souhaitez désactiver ce comportement, spécifiez ce paramètre dans le fichier de configuration et définissez sa valeur sur `false`.
`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. 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.
`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é. 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.
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` Pour vous connecter de manière sécurisée à un système SAP HANA, spécifiez une clé de magasin d'utilisateurs sécurisé (`hdbuserstore`) que vous avez créée pour ce système. Pour utiliser une clé `hdbuserstore` pour l'authentification, vérifiez les points suivants : Les outils SAP `hdbsql` et `hdbuserstore` 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. L'utilisateur `SIDadm` peut interroger la base de données SAP HANA à l'aide de cette clé. Ici, `SID` fait référence à la valeur que vous avez spécifiée pour le paramètre `sid`. Vous pouvez le vérifier en exécutant la commande suivante en tant qu'utilisateur `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Ce paramètre de configuration est compatible avec la version 3.3 de l'agent. Si vous spécifiez `hdbuserstore_key`, vous pouvez ignorer les paramètres `hostname` et `port`. 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.
`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.
`hana_monitoring_configuration.enabled`	`Boolean` Facultatif. Pour autoriser l'agent Google Cloud pour SAP à collecter les métriques de surveillance SAP HANA, spécifiez `true`. La valeur par défaut est `false`. Les paramètres enfants suivants ne s'appliquent que lorsque vous spécifiez `hana_monitoring_configuration.enabled: true`.
`hana_monitoring_configuration.sample_interval_sec`	`Int` Facultatif. Spécifiez l'intervalle d'échantillonnage, en secondes, qui détermine la fréquence à laquelle l'agent Google Cloud pour SAP interroge vos instances SAP HANA pour collecter les métriques de surveillance SAP HANA. La valeur par défaut est de 300 secondes. Pour chaque requête définie dans le fichier de configuration de l'agent Google Cloud pour SAP, vous pouvez remplacer l'intervalle d'échantillonnage global en spécifiant l'intervalle requis sur le paramètre `sample_interval_sec`. Les intervalles d'échantillonnage doivent être d'au moins 5 secondes.
`hana_monitoring_configuration.query_timeout_sec`	`Int` Facultatif. Indiquez le délai avant expiration de chaque requête adressée aux instances SAP HANA. La valeur par défaut est de 300 secondes.
`hana_monitoring_configuration.execution_threads`	`Int` Facultatif. Spécifiez le nombre de threads utilisés pour envoyer des requêtes aux instances SAP HANA. Chaque requête s'exécute sur son propre thread. La valeur par défaut est 10.
`hana_monitoring_configuration.hana_instances.name`	`String` Spécifiez l'identifiant de nom de votre instance SAP HANA.
`hana_monitoring_configuration.hana_instances.sid`	`String` Spécifiez le SID de votre instance SAP HANA. Cette chaîne est ajoutée en tant que libellé à toutes les métriques résultant de l'interrogation de vos instances SAP HANA.
`hana_monitoring_configuration.hana_instances.host`	`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.
`hana_monitoring_configuration.hana_instances.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.
`hana_monitoring_configuration.hana_instances.user`	`String` Spécifiez le compte utilisateur utilisé pour interroger l'instance SAP HANA. Assurez-vous que cet utilisateur dispose du droit de lire les vues de surveillance de votre base de données SAP HANA. Si ce privilège n'est pas accordé, les métriques de surveillance SAP HANA associées aux vues de surveillance ne contiennent aucune donnée.
`hana_monitoring_configuration.hana_instances.password`	`String` Facultatif. Spécifiez le mot de passe, en texte brut, qui authentifie le compte utilisateur pour interroger l'instance SAP HANA. Pour l'authentification, vous devez spécifier l'un des éléments suivants : Le mot de passe en texte brut du paramètre `password`. (Recommandé) Si vous utilisez Secret Manager pour stocker le mot de passe en tant que secret, vous devez spécifier le nom de secret correspondant au paramètre `secret_name`. (Recommandé) Une clé `hdbuserstore` pour le paramètre `hdbuserstore_key`. 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 `password`, qui est préféré au paramètre `secret_name`. Nous vous recommandons de ne définir qu'une seule option d'authentification dans votre fichier de configuration.
`hana_monitoring_configuration.hana_instances.secret_name`	`String` Facultatif. Spécifiez le nom du secret dans Secret Manager qui stocke le mot de passe du compte utilisateur. 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 `password`, qui est préféré au paramètre `secret_name`. Nous vous recommandons de ne définir qu'une seule option d'authentification dans votre fichier de configuration.
`hana_monitoring_configuration.hana_instances.hdbuserstore_key`	`String` Pour vous connecter de manière sécurisée à un système SAP HANA, spécifiez une clé de magasin d'utilisateurs sécurisé (`hdbuserstore`) que vous avez créée pour ce système. Pour utiliser une clé `hdbuserstore` pour l'authentification, vérifiez les points suivants : Les outils SAP `hdbsql` et `hdbuserstore` 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. L'utilisateur `SIDadm` peut interroger la base de données SAP HANA à l'aide de cette clé. Ici, `SID` fait référence à la valeur que vous avez spécifiée pour le paramètre `sid`. Vous pouvez le vérifier en exécutant la commande suivante en tant qu'utilisateur `SIDadm`: hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" Ce paramètre de configuration est compatible avec la version 3.3 de l'agent. Si vous spécifiez `hdbuserstore_key`, vous pouvez ignorer les paramètres `host` et `port`.
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` Facultatif. Indique si SSL est activé ou non dans votre instance SAP HANA. La valeur par défaut est `false`.
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` Si vous spécifiez `enable_ssl: true` pour une instance SAP HANA, vous devez spécifier le nom d'hôte défini dans le certificat SSL.
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` Si vous spécifiez `enable_ssl: true` pour une instance SAP HANA, vous devez spécifier le chemin d'accès à votre certificat de sécurité.
`hana_monitoring_configuration.queries.enabled`	`Boolean` Facultatif. Pour activer une requête SQL pour toutes vos instances SAP HANA, spécifiez la valeur `true` du paramètre `enabled` pour cette requête SQL.
`hana_monitoring_configuration.queries.name`	`String` Si vous avez défini des requêtes personnalisées dans votre fichier de configuration, vous devez spécifier un nom unique pour chacune d'entre elles. Le nom de la requête doit être unique, car il permet de créer l'URL par défaut de la métrique dans Monitoring.
`hana_monitoring_configuration.queries.sql`	`String` Spécifiez l'instruction SQL que l'agent émet à vos instances SAP HANA. L'instruction SQL doit être conforme à la syntaxe SQL définie par SAP dans la documentation SAP HANA SQL and System Views Reference.
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` Facultatif. Spécifiez l'intervalle d'échantillonnage pour la requête SQL. Cette opération remplace l'intervalle d'échantillonnage global. Sa valeur doit être d'au moins 5 secondes.
`hana_monitoring_configuration.queries.columns.name`	`String` Spécifiez un nom qui identifie de manière unique chaque colonne. Le nom de colonne doit être unique, car il permet de créer l'URL par défaut de la métrique dans Monitoring.
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Pour le traitement par Monitoring, spécifiez l'un des types de métriques suivants : `METRIC_LABEL`, `METRIC_GAUGE` ou `METRIC_CUMULATIVE`. Les métriques de type `METRIC_LABEL` sont ajoutées en tant que libellés à toutes les métriques `METRIC_GAUGE` et `METRIC_CUMULATIVE` envoyées à Monitoring.
`hana_monitoring_configuration.queries.columns.value_type`	`String` Pour la gestion par Monitoring, spécifiez un type de données compatible avec le type de métrique. Les types de données acceptés sont les suivants : `VALUE_BOOL`, `VALUE_INT64`, `VALUE_STRING` ou `VALUE_DOUBLE`. Pour en savoir plus, consultez la page Combinaison acceptée.
`hana_monitoring_configuration.queries.columns.name_override`	`String` Facultatif. Pour le traitement par Monitoring, spécifiez le chemin d'accès que vous souhaitez afficher dans l'URL de la métrique au lieu des noms de requête et de colonne. Exemple : URL par défaut de la métrique : `workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME` URL de métrique utilisant un chemin personnalisé : `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

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.