Configurer l'agent pour SAP afin de configurer l'observabilité

Ce document explique comment configurer l'agent Google Cloudpour SAP afin de configurer l'observabilité de votre charge de travail SAP à l'aide du gestionnaire de charges de travail.

Le service d'observabilité du gestionnaire de charges de travail a besoin de l'agent pour collecter les métriques de votre charge de travail SAP et de l'infrastructure sous-jacente. Pour en savoir plus, consultez Présentation de l'observabilité SAP.

Avant de commencer

Configurer l'agent pour une charge de travail à zone unique

VM Extension Manager

Pour configurer et gérer l'agent sur un parc d'instances Compute Engine, vous devez créer une règle VM Extension Manager pour celui-ci.

Pour configurer l'agent afin de configurer l'observabilité pour une charge de travail SAP exécutée dans une seule zone, procédez comme suit :

  1. Configurez VM Extension Manager :

  2. Créez une stratégie d'extension de VM qui installe et gère l'agent pour SAP sur les instances de calcul qui exécutent votre charge de travail SAP : Google Cloud

Gestionnaire de packages

Si vous gérez manuellement le cycle de vie de l'agent au lieu d'utiliser le gestionnaire d'extensions de VM, vous pouvez configurer l'agent Google Cloudpour SAP à l'aide d'un gestionnaire de packages :

  1. Établissez une connexion SSH avec l'instance de calcul qui exécute votre charge de travail SAP.

  2. Vérifiez que vous exécutez la dernière version de l'agent pour SAP.

    Pour savoir comment mettre à jour l'agent, consultez Mettre à jour l'agent Google Cloudpour SAP.

  3. Pour permettre à l'agent de rechercher des informations sur la charge de travail SAP et de les envoyer au gestionnaire de charges de travail :

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

  4. Autorisez l'agent à collecter les métriques des processus exécutés dans votre charge de travail SAP :

    1. Activez la fonctionnalité de surveillance des processus de l'agent :
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Pour permettre à l'agent de collecter les métriques de processus associées à vos instances de base de données SAP HANA, vous devez configurer des paramètres supplémentaires dans la section hana_metrics_config.

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

  5. Autorisez l'agent à collecter les métriques des instances SAP HANA exécutées dans votre charge de travail SAP :

    1. Activez la fonctionnalité de surveillance SAP HANA de l'agent :
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Pour permettre à l'agent de se connecter aux instances SAP HANA et de collecter des métriques, vous devez configurer des paramètres supplémentaires.

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

  6. Enregistrez le fichier de configuration.

Pour afficher des exemples de configurations d'agent pour l'observabilité, consultez Exemples de configurations d'agent.

Configurer l'agent pour une charge de travail multizone

VM Extension Manager

Pour configurer et gérer l'agent sur un parc d'instances Compute Engine, vous devez créer une règle VM Extension Manager pour celui-ci.

Pour configurer l'agent afin de configurer l'observabilité pour une charge de travail SAP exécutée dans deux zones ou plus, procédez comme suit :

  1. Configurez VM Extension Manager :

  2. Créez une règle d'extension de VM qui installe et gère l'agent pour SAP de Google Cloudsur les instances de calcul qui exécutent le site principal de votre charge de travail SAP :

  3. Si vous exécutez une charge de travail SAP à haute disponibilité ou si vous disposez d'un site de reprise après sinistre pour votre charge de travail SAP, créez une stratégie d'extension de VM qui installe et gère l'agent Google Cloudpour SAP sur les instances de calcul qui exécutent le site secondaire ou de reprise après sinistre de votre charge de travail SAP.

Gestionnaire de packages

Si vous gérez manuellement le cycle de vie de l'agent au lieu d'utiliser le gestionnaire d'extensions de VM, vous pouvez configurer l'agent Google Cloudpour SAP à l'aide d'un gestionnaire de packages :

  1. Établissez une connexion SSH avec l'instance de calcul qui exécute votre charge de travail SAP.

  2. Vérifiez que vous exécutez la dernière version de l'agent pour SAP.

    Pour savoir comment mettre à jour l'agent, consultez Mettre à jour l'agent Google Cloudpour SAP.

  3. Pour permettre à l'agent de collecter des informations sur la charge de travail SAP et de les envoyer au gestionnaire de charges de travail :

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

  4. Autorisez l'agent à collecter les métriques des processus exécutés dans votre charge de travail SAP :

    1. Activez la fonctionnalité de surveillance des processus de l'agent :
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Pour permettre à l'agent de collecter les métriques de processus associées à vos instances de base de données SAP HANA, vous devez configurer des paramètres supplémentaires dans la section hana_metrics_config.

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

  5. Autorisez l'agent à collecter les métriques des instances SAP HANA exécutées dans votre charge de travail SAP :

    1. Activez la fonctionnalité de surveillance SAP HANA de l'agent :
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Pour permettre à l'agent de se connecter aux instances SAP HANA et de collecter des métriques, vous devez configurer des paramètres supplémentaires.

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

  6. Enregistrez le fichier de configuration.

  7. Si vous exécutez une charge de travail SAP à haute disponibilité ou si vous disposez d'un site de reprise après sinistre pour votre charge de travail SAP, répétez cette procédure pour toutes les autres instances de calcul qui exécutent votre charge de travail SAP.

Pour afficher des exemples de configurations d'agent pour l'observabilité, consultez Exemples de configurations d'agent.

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

Vous pouvez vérifier si vous avez correctement configuré Google Cloud pour utiliser le service d'observabilité Workload Manager en exécutant la commande status de l'agent.

Pour valider la configuration de Google Cloud , procédez comme suit :

  1. Établissez une connexion SSH avec l'instance Compute Engine qui exécute votre charge de travail SAP.

  2. Vérifiez la configuration de Google Cloud pour l'observabilité :

    sudo /usr/bin/google_cloud_sap_agent status

    Si votre configuration de Google Cloud pour l'utilisation du service d'observabilité Workload Manager est correcte, la sortie inclut les éléments suivants. Votre configuration peut comporter d'autres valeurs que celles de default.

    Agent Status:
    Installed version: 3.10-....
    ...
    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:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (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 votre résultat indique qu'il manque une configuration, consultez les informations fournies dans les sections précédentes, effectuez les actions requises, puis exécutez à nouveau la commande status pour revalider la configuration.

  4. Si vous utilisez plusieurs instances de calcul pour exécuter votre charge de travail, répétez cette procédure pour toutes les autres instances de calcul exécutant votre charge de travail.

Exemples de configurations d'agent

Les exemples suivants sont des fichiers de configuration terminés de l'agent Google Cloudpour SAP, configuré pour prendre en charge l'observabilité d'une charge de travail SAP HANA :

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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

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 une clé de magasin d'utilisateurs sécurisé (hdbuserstore) ou 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

Pour en savoir plus sur les paramètres de configuration compatibles avec l'agent, consultez Paramètres de configuration.

Étapes suivantes

  • Une fois que vous avez configuré l'observabilité pour une charge de travail SAP, il peut s'écouler jusqu'à 15 minutes avant que cette charge de travail n'apparaisse sur la page Observabilité du gestionnaire de charges de travail dans la console Google Cloud .

    Pour savoir comment observer votre charge de travail SAP, consultez Afficher les métriques d'observabilité pour SAP.