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

Vérifier l'installation de l'agent Google Cloud pour 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 Cloud pour SAP sous Linux.

Définir des rôles 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 rôles suivants :

Pour ajouter ces rôles requis à votre compte de service, procédez comme suit :

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

Accéder à IAM
Sélectionnez votre projet Google Cloud.
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.
Sélectionnez le rôle requis dans la liste des rôles disponibles :
- Compute Engine > Lecteur Compute
- Monitoring > Rédacteur de statistiques de surveillance
Cliquez sur Enregistrer pour attribuer les rôles au compte de service.

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 :

Établissez une connexion SSH avec votre instance de VM hôte ou votre serveur de solution Bare Metal.
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 de VM Compute Engine

L'exemple suivant est un fichier de configuration complet de l'agent Google Cloud pour SAP s'exécutant sur un une instance de VM Compute Engine, où la collecte des métriques d'état de l'agent 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": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_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 un serveur 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
  },
  "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

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.

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