Configurer l'agent pour SAP pour la collecte de métriques

L'agent pour SAP deGoogle Cloudpermet de surveiller vos charges de travail SAP exécutées sur des instances Compute Engine et vous aide à exécuter des systèmes SAP de manière efficace sur Google Cloud. Vous devez installer l'agent pour SAP de Google Cloudsur toutes les VM exécutant un système SAP. Cet agent collecte et envoie toutes les informations requises par SAP à l'agent hôte SAP. Pour en savoir plus, consultez la note SAP 2469354.

Pour collecter les métriques d'infrastructure et d'application sous-jacentes utilisées pour l'observabilité, vous devez activer des fonctionnalités supplémentaires pour l'Agent pour SAP.

Ce document explique comment activer ces fonctionnalités dans Agent pour SAP.

Checklist pour l'agent pour SAP

La checklist suivante récapitule les tâches que vous devez effectuer pour vous assurer que l'Agent pour SAP est correctement configuré pour l'observabilité:

Installer et configurer l'agent pour SAP
Installez et configurez l'agent Google Cloudpour SAP sur chaque VM Compute Engine que vous souhaitez surveiller.
L'agent pour SAP est empaqueté avec les images d'OS publiques "pour SAP" suivantes :
  • RHEL : toutes les images "for SAP"
  • SLES : SLES 15 SP4 pour SAP et versions ultérieures

Pour en savoir plus, consultez Installer et configurer l'Agent pour SAP sur une VM.

Mettre à jour l'agent pour SAP
La version 3.5 de l'Agent pour SAP contient toutes les fonctionnalités requises pour configurer l'observabilité pour SAP. Si l'agent a déjà été installé, nous vous recommandons de passer à la dernière version.

Pour en savoir plus, consultez Mettre à jour l'agent Google Cloudpour SAP.

Activer la fonctionnalité de détection de système de l'agent pour SAP
Dans le fichier de configuration de l'agent, les paramètres suivants doivent être définis sur true. Si vous avez installé l'agent après le 14 février 2024, ces indicateurs sont définis sur true par défaut et aucune modification n'est requise.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Si vous avez installé l'agent avant le 14 février 2024 ou si vous avez désactivé la fonctionnalité de découverte du système, exécutez les commandes suivantes:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

Pour en savoir plus, consultez Configurer l'agent Google Cloudpour SAP.

Activer la collecte des métriques de surveillance des processus de l'Agent pour SAP
Dans le fichier de configuration de l'agent, le paramètre collection_configuration.collect_process_metrics doit être défini sur true. Pour activer la fonctionnalité, exécutez la commande suivante:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Pour en savoir plus, consultez Configurer la collecte des métriques de surveillance de processus.

Activer la collecte des métriques de surveillance SAP HANA par l'agent pour SAP
Sur les VM HANA, vous devez activer la collecte des métriques de surveillance des processus HANA. Pour activer cette fonctionnalité, exécutez la commande suivante:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

Modifiez la section hana_monitoring_configuration dans le fichier de configuration de l'agent pour indiquer le nom, le SID, l'hôte, le port, l'utilisateur et le mot de passe de l'instance HANA (à l'aide d'un secret ou d'une clé hdbuserstore).

Notez que l'utilisateur HANA spécifié doit disposer d'un accès en lecture aux tables interrogées par les requêtes par défaut.

Pour en savoir plus, consultez Configurer la collecte de métriques de surveillance SAP HANA.

Valider la configuration et la Google Cloud configuration de l'agent
Vérifiez que l'agent est correctement configuré en exécutant la commande suivante:
         sudo /usr/bin/google_cloud_sap_agent status

Pour en savoir plus, consultez Valider la configuration pour l'observabilité du gestionnaire de charges de travail.

Redémarrer l'agent pour SAP
Redémarrez l'agent pour que les modifications prennent effet en exécutant la commande suivante :
         sudo systemctl restart google-cloud-sap-agent

Pour en savoir plus, consultez la section Redémarrer l'agent.

Valider la configuration de l'observabilité du gestionnaire de charges de travail

Vous pouvez vérifier si vous avez correctement configuré Google Cloud le service d'observabilité 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:

  1. Établissez une connexion SSH avec votre instance Compute Engine.
  2. Exécutez la commande suivante :

    sudo /usr/bin/google_cloud_sap_agent status
    

    Si votre configuration pour utiliser le service d'observabilité 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:
        Installed version: 3.7-....
        ...
        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
    ...
    ----------------------------------------------------------------------------
    Process Metrics: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_process_metrics:        true (configuration file)
            process_metrics_frequency:      5    (default)
            process_metrics_to_skip:        []   (default)
            slow_process_metrics_frequency: 30   (default)
    ...
    ----------------------------------------------------------------------------
    HANA Monitoring Metrics: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            connection_timeout:       120   (default)
            enabled:                  true  (configuration file)
            execution_threads:        10    (default)
            max_connect_retries:      1     (default)
            query_timeout_sec:        300   (default)
            sample_interval_sec:      300   (default)
            send_query_response_time: false (default)
    ...
    ----------------------------------------------------------------------------
    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)
    ...
    
  3. Si la sortie indique qu'une configuration est manquante, examinez 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.

Exemple de fichier de configuration

Une fois que vous avez activé les fonctionnalités d'observabilité, le fichier de configuration de l'Agent pour SAP se présente comme suit:

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true
  },
  "discovery_configuration": {
     "enable_workload_discovery": true,
     "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }
  

Étape suivante