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

Ce document explique comment configurer Google Cloud's Agent pour SAP afin de configurer l'observabilité de votre charge de travail SAP à l'aide de Workload Manager.

Le service d'observabilité Workload Manager a besoin de l'agent pour collecter des métriques à partir de votre charge de travail SAP et de l'infrastructure sous-jacente. Pour en savoir plus, consultez la 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é d'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 règle d'extension de VM qui installe et gère Google Cloud's agent de pour SAP sur les instances de calcul qui exécutent votre charge de travail SAP :

Gestionnaire de packages

Si vous gérez manuellement le cycle de vie de l'agent au lieu d'utiliser VM Extension Manager, vous pouvez configurer Google Cloud's Agent pour 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 la section Mettre à jour Google Cloud's l'agent de pour SAP.

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

    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 des métriques à partir 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 des métriques de processus lié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 la section Configurer la collecte des métriques de surveillance des processus.

  5. Autorisez l'agent à collecter des métriques à partir 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 la section Configurer la collecte des métriques de surveillance SAP HANA.

  6. Enregistrez le fichier de configuration.

Pour afficher des exemples de configurations d'agent pour l'observabilité, consultez la section 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é d'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 Google Cloud's agent de pour SAP sur 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 règle d'extension de VM qui installe et gère Google Cloudl'agent de pour 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 VM Extension Manager, vous pouvez configurer Google Cloud's Agent pour 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 la section Mettre à jour Google Cloud's l'agent de pour SAP.

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

    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 des métriques à partir 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 des métriques de processus lié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 la section Configurer la collecte des métriques de surveillance des processus.

  5. Autorisez l'agent à collecter des métriques à partir 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 la section Configurer la collecte des 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 la section Exemples de configurations d'agent.

Valider la configuration de l'observabilité de Workload Manager

Vous pouvez vérifier si la configuration est correcte pour utiliser le service d'observabilité du Workload Manager en exécutant la commande de l'agent. Google Cloud status

Pour valider la Google Cloud configuration, 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 Google Cloud configuration de l'observabilité :

    sudo /usr/bin/google_cloud_sap_agent status

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

    Agent Status:
    Installed version: 3.13-....
    ...
    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 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 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 qui exécutent votre charge de travail.

Exemples de configurations d'agent

Les exemples suivants sont des fichiers de configuration complets de Google Cloud's Agent pour 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 Secret Manager secret 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 la section Paramètres de configuration.

Étape suivante

  • 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 Workload Manager dans la Google Cloud console.

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