L'agent Google Cloud pour SAP est requis pour la compatibilité SAP des systèmes SAP exécutés sur Google Cloud, y compris SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB, etc.
Lorsque vous installez l'agent Google Cloud pour SAP sur une instance de VM Compute Engine, pour les métriques de l'agent hôte SAP, l'agent combine les données de surveillance de Cloud Monitoring et des API Compute Engine, puis transmet ces données à l'agent hôte SAP.
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 compatibles avec l'agent Google Cloud pour SAP, consultez la page Systèmes d'exploitation compatibles.
Pour installer et configurer la version 1 de l'agent Google Cloud pour SAP sur un serveur de solution Bare Metal, consultez la section Installer l'agent Google Cloud pour SAP sur un serveur de solution Bare Metal.
Présentation de l'installation
Sous Linux, 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
systemdLinux nommégoogle-cloud-sap-agent. - Elle active et démarre le service
google-cloud-sap-agent.
Sous Windows, vous installez l'agent Google Cloud pour SAP à l'aide de la commande de gestion des packages GooGet googet. La commande de gestion des packages effectue les tâches suivantes :
- Elle télécharge l'agent Google Cloud pour SAP.
Elle crée un service Windows nommé
google-cloud-sap-agentet une tâche planifiée qui s'exécute toutes les minutes pour vérifier si le service est toujours en cours d'exécution et, si nécessaire, le redémarrer.
Prérequis pour l'agent
Avant d'installer l'agent Google Cloud pour SAP, vous devez vous assurer que les conditions préalables suivantes sont remplies.
Définir les rôles IAM requis
Au minimum, le compte de service utilisé par l'agent Google Cloud pour SAP doit inclure les rôles Lecteur Compute (roles/compute.viewer), Lecteur Monitoring (roles/monitoring.viewer) et Rédacteur d'insights Workload Manager (roles/workloadmanager.insightWriter).
Pour ajouter un rôle requis à votre compte de service, procédez comme suit :
Dans la console Google Cloud, accédez à la page 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 :
- Compute Engine > Lecteur Compute
- Monitoring > Lecteur Monitoring
- Gestionnaire de charges de travail > Rédacteur d'insights Workload Manager
Cliquez sur Ajouter ou sur Enregistrer pour appliquer le ou les rôles sélectionnés au compte de service.
Activer l'accès aux API Google Cloud
Compute Engine recommande de configurer vos instances de VM de façon à accorder un niveau d'accès complet à toutes les API Cloud et à n'utiliser que les autorisations IAM du compte de service de l'instance pour contrôler les accès aux ressources Google Cloud. Pour en savoir plus, consultez la page Créer une VM qui utilise un compte de service géré par l'utilisateur.
Si vous limitez l'accès aux API Cloud, l'agent Google Cloud pour SAP nécessite au minimum les niveaux d'accès suivants aux API Cloud sur l'instance de VM hôte :
- Cloud Platform : activé
- Compute Engine : lecture seule
- API Stackdriver Monitoring : lecture seule
Si vous exécutez des applications SAP sur une instance de VM qui ne possède pas d'adresse IP externe, vous devez activer l'accès privé à Google sur le sous-réseau de la VM afin que l'agent Google Cloud pour SAP puisse accéder aux API et services Google. Pour activer l'accès privé à Google sur un sous-réseau, consultez la page Configurer l'accès privé à Google.
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 section Installer et configurer l'agent Google Cloud pour SAP sur une instance de VM Compute Engine.
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
Pour vérifier que l'agent est en cours d'exécution, sélectionnez votre système d'exploitation, puis procédez comme suit :
Linux
Établissez une connexion SSH avec votre instance de VM hôte.
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.
Windows
Utilisez le protocole RDP pour vous connecter à l'instance de VM.
En tant qu'administrateur, exécutez la commande suivante à partir de PowerShell :
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Si l'agent est en cours d'exécution, l'état indiqueRunning.
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
- Fournisseur cloud :
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 de surveillance des processus et des métriques d'évaluation du gestionnaire de charges de travail n'est compatible que sous Linux.
Si vous activez la collecte des métriques de surveillance des processus et des métriques d'évaluation du gestionnaire de charges de travail, le compte de service de l'instance de VM hôte doit inclure le rôle IAM Rédacteur de métriques Monitoring (roles/monitoring.metricWriter).
Si vous utilisez Secret Manager pour stocker le mot de passe de la base de données SAP HANA, assurez-vous que le compte de service de l'instance de VM hôte dispose du rôle IAM Accesseur de secrets Secret Manager (roles/secretmanager.secretAccessor).
Les niveaux d'accès de l'instance de VM hôte doivent disposer de l'accès en écriture pour publier les données de métriques dans vos projets Google Cloud.
Lorsque vous créez une instance de VM Compute Engine, elle est automatiquement configurée avec le niveau d'accès en écriture https://www.googleapis.com/auth/monitoring.write.
Définir les rôles IAM requis
Pour ajouter un rôle requis à votre compte de service, procédez comme suit :
Dans la console Google Cloud, accédez à la page 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 :
- 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 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 :
- Établissez une connexion SSH avec votre instance de VM hôte.
Ouvrez le fichier de configuration suivant :
/etc/google-cloud-sap-agent/configuration.json
Dans la section
collection_configuration, définissez les paramètres suivants surtrue: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 sectionhana_metrics_configafin 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.
Si vous le souhaitez, vous pouvez mettre à jour les valeurs des paramètres définies automatiquement sous
cloud_properties. 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
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 |
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 Google Cloud que vous utilisez avec la solution Bare Metal. |
cloud_properties.instance_name
|
Indiquez le nom de votre instance de VM Compute Engine. L'agent le détecte automatiquement lors de l'installation. |
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 VM, il utilise par défaut la zone de l'instance de VM sur laquelle il est installé. |
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é. |
collection_configuration.collect_process_metrics |
Pour activer la collecte des métriques de surveillance des processus, spécifiez |
collection_configuration.process_metrics_frequency |
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 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 |
collection_configuration.hana_metrics_config.hana_db_user |
Spécifiez le compte utilisateur de base de données utilisé par l'agent pour interroger SAP HANA. La valeur par défaut est |
collection_configuration.hana_metrics_config.hana_db_password |
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 :
|
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
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. L'agent ne collecte les métriques liées à SAP HANA que lorsque vous spécifiez |
collection_configuration.hana_metrics_config.hdbuserstore_key
|
Pour vous connecter de manière sécurisée à un système SAP HANA, spécifiez une clé Magasin d'utilisateurs sécurisé ( Pour utiliser une clé
|
collection_configuration.hana_metrics_config.sid |
Spécifiez le SID de votre instance SAP HANA. |
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_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_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 |
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é
Si vous spécifiez |
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 |
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 instance de VM Compute Engine, tous les paramètres et valeurs de configuration sont facultatifs. Si le fichier de configuration n'est pas modifié, la configuration par défaut est utilisée. L'exemple suivant montre un fichier de configuration terminé pour l'installation de l'agent sur une instance de VM Compute Engine.
{
"provide_sap_host_agent_metrics": true,
"bare_metal": false,
"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"
}
}
}
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
Dans la console Google Cloud, accédez à la page Monitoring :
Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.
Cliquez sur l'onglet Exemple de bibliothèque.
Pour filtrer les tableaux de bord personnalisés spécifiques à l'agent, saisissez
Agent for SAPdans le champ Filtre.(Facultatif) Pour afficher les détails d'un tableau de bord ou pour prévisualiser son contenu, cliquez sur Aperçu.
Sélectionnez le tableau de bord que vous souhaitez installer.
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
Ouvrez Cloud Shell.
Dans Cloud Shell, clonez ou téléchargez le dépôt :
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
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_FILEpar 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'emplacementmonitoring-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 :
Dans la console Google Cloud, accédez à la page Monitoring :
Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.
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.