Configurer la collecte de métriques d'état de l'agent

Ce guide explique comment configurer l'agent Google Cloud pour SAP afin de collecter les métriques d'état du processus daemon de l'agent sur votre instance de VM Compute Engine ou sur votre serveur de solution Bare Metal.

Pour en savoir plus sur cette fonctionnalité, consultez la section Collecte de métriques d'état de l'agent.

Avant de commencer

Définir les autorisations IAM

Pour activer la collecte des métriques d'état par l'agent Google Cloud pour SAP, vous devez vous assurer que le compte de service utilisé par votre instance de VM Compute Engine ou votre serveur de solution Bare Metal inclut les autorisations IAM requises.

Pour ajouter ces autorisations requises à votre compte de service, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page IAM.

    Accéder à IAM

  2. Sélectionnez votre projet Google Cloud.

  3. 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 Accorder l'accès et 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.

  4. Sélectionnez le rôle requis dans la liste des rôles disponibles :

    • Monitoring > Rédacteur de statistiques de surveillance

  5. Cliquez sur Enregistrer pour attribuer les rôles au compte de service.

Pour un niveau d'accès précis, vous pouvez définir les autorisations IAM suivantes sur votre propre rôle personnalisé:

  • Collecte de métriques :
    • monitoring.timeSeries.create

Pour en savoir plus sur la création d'un rôle personnalisé, consultez la page Créer et gérer les rôles personnalisés.

Activer la collecte de métriques d'état de l'agent

Pour autoriser l'agent Google Cloud pour SAP à collecter les métriques d'état de son processus daemon sur votre hôte, procédez comme suit :

  1. Établissez une connexion SSH avec votre instance Compute Engine hôte ou votre serveur de solution Bare Metal.

  2. Activez la collecte des métriques d'état de l'agent :

    Exécuter la commande

    1. Pour activer la collecte des métriques d'état de l'agent, exécutez la commande suivante :

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable

    2. Vous pouvez éventuellement modifier la fréquence à laquelle l'agent collecte les données d'utilisation du processeur et de la mémoire de son processus daemon et les envoie à Cloud Monitoring. La fréquence par défaut est de 60 secondes.

      Pour modifier cette fréquence, exécutez la commande suivante :

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

      Remplacez FREQUENCY par la valeur requise, en secondes. La fréquence ne doit pas être inférieure à 5 secondes.

    3. Vous pouvez éventuellement modifier la fréquence à laquelle l'agent vérifie son état opérationnel et envoie ces informations à Cloud Monitoring. La fréquence par défaut est de 60 secondes.

      Pour modifier cette fréquence, exécutez la commande suivante. La fréquence ne doit pas être inférieure à 5 secondes.

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

    Modifier le fichier de configuration

    Au lieu d'exécuter la commande de l'agent, vous pouvez modifier manuellement la configuration de l'agent comme suit :

    1. Ouvrez le fichier de configuration Backint :

      /etc/google-cloud-sap-agent/configuration.json

    2. Dans la section collection_configuration, incluez les éléments suivants :

      "collect_agent_metrics": true

    3. Vous pouvez éventuellement modifier la fréquence à laquelle l'agent collecte les données d'utilisation du processeur et de la mémoire de son processus daemon et les envoie à Cloud Monitoring. La fréquence par défaut est de 60 secondes.

      Pour modifier cette fréquence, incluez les éléments suivants dans la section collection_configuration.

      "agent_metrics_frequency": FREQUENCY

      Remplacez FREQUENCY par la valeur requise, en secondes. La fréquence ne doit pas être inférieure à 5 secondes.

    4. Vous pouvez éventuellement modifier la fréquence à laquelle l'agent vérifie son état opérationnel et envoie ces informations à Cloud Monitoring. La fréquence par défaut est de 60 secondes.

      Pour modifier cette fréquence, incluez les éléments suivants dans la section collection_configuration. La fréquence ne doit pas être inférieure à 5 secondes.

      "agent_health_frequency": FREQUENCY

    5. Enregistrez le fichier de configuration.

    6. Redémarrez l'agent pour que les nouveaux paramètres prennent effet :

      sudo systemctl restart google-cloud-sap-agent

Exemples de fichiers de configuration

Instance Compute Engine

L'exemple suivant est un fichier de configuration terminé de l'agent Google Cloud pour SAP s'exécutant sur unune instance Compute Engine, où la collecte des métriques d'état est activée:

{
  "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": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Serveur de solution Bare Metal

L'exemple suivant est un fichier de configuration terminé de l'agent Google Cloud pour SAP s'exécutant sur unserveur de solution Bare Metal, où la collecte des métriques d'état est activée:

{
  "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,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Paramètres de configuration

Le tableau suivant explique les paramètres de configuration de l'agent Google Cloud pour SAP qui sont spécifiques à la collecte des métriques d'état de l'agent.

Paramètres
collection_configuration.collect_agent_metrics

Boolean

Facultatif. Spécifiez true pour permettre à l'agent de collecter les informations suivantes et les envoyer à Cloud Monitoring :

  • Utilisation du processeur et de la mémoire par le processus daemon de l'agent sur votre hôte.
  • État de fonctionnement du processus daemon de l'agent sur votre hôte.

La valeur par défaut est false.
collection_configuration.agent_metrics_frequency

Int

Facultatif. Spécifiez la fréquence à laquelle l'agent collecte l'utilisation du processeur et de la mémoire de son processus daemon sur l'hôte, et les envoie à Cloud Monitoring. Ces informations sont capturées par les métriques sap/agent/cpu/utilization et sap/agent/memory/utilization. La valeur par défaut est de 60 secondes. La fréquence ne doit pas être inférieure à 5 secondes.

collection_configuration.agent_health_frequency

Int

Facultatif. Spécifiez la fréquence à laquelle l'agent vérifie son état opérationnel et envoie ces informations à Cloud Monitoring. Ces informations sont capturées par la métrique sap/agent/health. La valeur par défaut est de 60 secondes. La fréquence ne doit pas être inférieure à 5 secondes.