Commandes de configuration pour l'agent Google Cloud pour SAP

Ce document présente les commandes que vous pouvez utiliser pour modifier la configuration de l'agent Google Cloud pour SAP. Ces commandes sont compatibles avec la version 3.2 de l'agent.

Les commandes de configuration constituent une alternative à la modification du fichier de configuration de l'agent : /etc/google-cloud-sap-agent/configuration.json. Chaque commande de configuration redémarre également l'agent pour vous assurer que la modification prend effet.

Limite de redémarrage de l'agent

Vous pouvez redémarrer l'agent Google Cloud pour SAP jusqu'à trois fois en 60 secondes. Pendant cette période, bien que vous puissiez continuer à configurer l'agent en exécutant les commandes de configuration, toutes les opérations de redémarrage automatique au-delà de cette limite échouent avec le résultat : Could not restart the agent.

Si vous voyez ce résultat, après avoir exécuté toutes les commandes de configuration requises, vous devez redémarrer manuellement l'agent pour que les modifications prennent effet. Pour obtenir des instructions, consultez la section Redémarrer l'agent.

Commandes d'aide

Pour afficher une aide récapitulative pour la commande google_cloud_sap_agent configure de l'agent, puis quitter, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -help
```
Pour imprimer l'état des caractéristiques de votre instance d'agent, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -showall
```
Pour imprimer la version de votre instance d'agent, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -version
```

Pour plus d'informations sur les arguments acceptés par la commande google_cloud_sap_agent configure, consultez la page Arguments acceptés.

Pour les paramètres de premier niveau

Pour configurer l'agent pour un serveur de solution Bare Metal, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable
```
Pour configurer l'agent pour une instance de VM Compute Engine, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable
```
Pour définir le niveau de journalisation de l'agent, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL
```
Remplacez LOG_LEVEL par l'un des niveaux de journalisation compatibles : debug, info, warn ou error.
Pour permettre à l'agent de découvrir les systèmes SAP exécutés sur votre hôte, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
```
Pour empêcher l'agent de découvrir vos systèmes SAP :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable
```

Pour la collecte des métriques de l'agent hôte SAP

Pour permettre à l'agent de collecter les métriques de l'agent hôte SAP :

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

Pour arrêter la collecte des métriques de l'agent hôte SAP :

sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable

Pour la collecte des métriques d'état de l'agent

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

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

Pour désactiver la collecte des métriques d'état de l'agent, procédez comme suit :

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

Pour 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, procédez comme suit :
```
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.
Pour modifier la fréquence à laquelle l'agent vérifie son état de fonctionnement et envoie ces informations à Cloud Monitoring, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

Pour la collecte des métriques de surveillance des processus

Pour autoriser l'agent à collecter les métriques de surveillance de processus, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
Pour arrêter la collecte des métriques de surveillance des processus :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
```
Pour modifier la fréquence à laquelle l'agent doit collecter les métriques de surveillance des processus, qui évoluent rapidement :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY
```
Pour modifier la fréquence à laquelle l'agent doit collecter les métriques de surveillance du processus, qui évoluent lentement :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY
```
Remplacez FREQUENCY par la fréquence, en secondes, à laquelle l'agent doit collecter les métriques.
Pour arrêter la collecte des métriques de surveillance des processus, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add
```
Pour reprendre la collecte des métriques de surveillance des processus que l'agent a arrêtée, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove
```
Remplacez LIST_OF_METRICS par les noms des métriques de surveillance des processus dont vous souhaitez que l'agent reprenne la collecte. Utilisez une virgule pour séparer les noms des métriques.

Pour la collecte des métriques d'évaluation du gestionnaire de charges de travail

Pour permettre à l'agent de collecter les métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -enable
```
Pour arrêter la collecte des métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -disable
```
Pour modifier la fréquence à laquelle l'agent doit collecter les métriques d'évaluation du gestionnaire de charges de travail, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_metrics_frequency=FREQUENCY
```
Remplacez FREQUENCY par la fréquence, en secondes, à laquelle l'agent doit collecter les métriques d'évaluation du gestionnaire de charges de travail.
Pour modifier la fréquence à laquelle l'agent doit collecter les métriques de la base de données SAP HANA, pour l'évaluation du gestionnaire de charges de travail, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_db_metrics_frequency=FREQUENCY
```
Remplacez FREQUENCY par la fréquence, en secondes, à laquelle l'agent doit collecter les métriques de base de données SAP HANA pour l'évaluation du gestionnaire de charges de travail.

Pour la collecte des métriques de surveillance SAP HANA

Pour autoriser l'agent à collecter les métriques de surveillance SAP HANA, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
Pour arrêter la collecte des métriques de surveillance SAP HANA, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable
```
Pour modifier l'intervalle d'échantillonnage auquel l'agent doit collecter les métriques de surveillance SAP HANA, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL
```
Remplacez SAMPLE_INTERNAL par l'intervalle, en secondes. L'intervalle doit être d'au moins 5 secondes.
Pour modifier la valeur du délai avant expiration d'une requête adressée à votre instance SAP HANA, procédez comme suit :
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT
```
Remplacez QUERY_TIMEOUT par une valeur, en secondes.

Arguments acceptés

Le tableau suivant décrit les arguments que vous pouvez utiliser avec la commande google_cloud_sap_agent configure :

Argument	Description
`-add`	Cet argument empêche l'agent de collecter les métriques de surveillance de processus que vous spécifiez pour l'argument `-process_metrics_to_skip`.
`-disable`	Désactive la fonctionnalité ou le paramètre spécifié de l'agent.
`-enable`	Active la fonctionnalité ou le paramètre spécifié de l'agent.
`-f`=`FEATURE_NAME` ou `-feature`=`FEATURE_NAME`	`STRING` Définit la fonctionnalité d'agent que vous souhaitez configurer. Les valeurs acceptées sont les suivantes : `host_metrics` `process_metrics` `agent_metrics` `hana_monitoring` `workload_validation` `sap_discovery`
`-h` ou `-help`	Affiche les informations d'aide associées à la commande.
`-loglevel`=`LOG_LEVEL`	`STRING` Définit le niveau de journalisation de l'agent. Les valeurs acceptées sont `debug`, `info`, `warn` et `error`.
`-path`=`PATH`	`STRING` Définit le chemin d'accès au fichier de configuration de l'agent : `/etc/google-cloud-sap-agent/configuration.json`.
`-process_metrics_to_skip`="`LIST_OF_METRICS`"	`STRING` Spécifie les métriques de surveillance des processus que l'agent doit arrêter de collecter. Utilisez une virgule pour séparer les noms de métriques. Utilisez les arguments `-add` et `-remove` avec `-process_metrics_to_skip`.
`-process_metrics_frequency`=`FREQUENCY`	`INT` Définit la fréquence à laquelle l'agent collecte des métriques de surveillance des processus qui évoluent rapidement. La valeur par défaut est de `5` secondes.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Définit la fréquence à laquelle l'agent collecte des métriques de surveillance des processus qui évoluent lentement. La valeur par défaut est de `30` secondes.
`-query_timeout_sec`=`TIMEOUT`	`INT` Définit le délai avant expiration de la requête, en secondes, pour la collecte des métriques de surveillance SAP HANA.
`-remove`	Cet argument force l'agent à reprendre la collecte des métriques de surveillance de processus que vous avez arrêtées à l'aide de l'argument `-process_metrics_to_skip`.
`-sample_interval_sec`=`INTERVAL`	`INT` Définit la fréquence, en secondes, à laquelle l'agent interroge votre instance SAP HANA et collecte les métriques de surveillance SAP HANA.
`-setting`=`SETTING`	`STRING` Spécifie le paramètre d'agent que vous souhaitez configurer.
`-showall`	Affiche l'état des fonctionnalités de votre instance d'agent.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Spécifiez la fréquence de collecte des métriques de surveillance du processus à l'évolution lente en secondes.
`-v` ou `-version`	Permet d'afficher la version de l'agent.
`-workload_validation_metrics_frequency`=`FREQUENCY`	`INT` Définit la fréquence à laquelle l'agent collecte les métriques d'évaluation du gestionnaire de charges de travail.
`-workload_validation_db_metrics_frequency`=`FREQUENCY`	`INT` Définit la fréquence à laquelle l'agent collecte les métriques de base de données SAP HANA pour l'évaluation du gestionnaire de charges de travail.