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

Ce guide explique comment configurer l'agent Google Cloudpour SAP afin de collecter les métriques d'état du processus daemon de l'agent sur votre instance 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

• Vérifiez l'installation de l'agent Google Cloudpour SAP. Pour obtenir des instructions, consultez le guide d'installation pour votre scénario.
• Si vous avez installé l'agent sur un serveur de solution Bare Metal, assurez-vous de remplir les conditions préalables requises et de configurer un compte de service. Pour obtenir des instructions, consultez la page Configurer l'agent Google Cloudpour SAP sous Linux.

Rôles requis

Pour vous assurer que le compte de service dispose des autorisations nécessaires pour autoriser l'agent Google Cloudpour SAP à collecter les métriques d'état de l'agent, demandez à votre administrateur d'accorder au compte de service les rôles IAM suivants sur votre projet :

• Rédacteur de métriques Monitoring (roles/monitoring.metricWriter) : permet d'écrire les métriques collectées dans Cloud Monitoring.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour autoriser l'agent Google Cloudpour SAP à collecter des métriques sur l'état de l'agent. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Votre administrateur peut également attribuer au compte de service ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

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

Pour autoriser l'agent Google Cloudpour 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

{
  "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
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "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'agentGoogle Cloudpour SAP qui sont spécifiques à la collecte des métriques d'état de l'agent.