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 la détection du système SAP

  • Pour permettre à l'agent de collecter les noms et les versions des produits SAP utilisés par votre système SAP, procédez comme suit :

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

    Pour empêcher l'agent de collecter les noms et les versions des produits SAP utilisés par votre système SAP, procédez comme suit :

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
  • Pour permettre à l'agent d'envoyer les informations système SAP découvertes à Cloud Logging et au gestionnaire de charges de travail si l'API Workload Manager est activée dans votre projet Google Cloud, procédez comme suit :

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

    Pour empêcher l'agent d'envoyer les informations découvertes à Cloud Logging et au gestionnaire de charges de travail, procédez comme suit :

    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_evaluation -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_evaluation -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_evaluation -workload_evaluation_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_evaluation -workload_evaluation_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_evaluation
  • sap_discovery
-h ou -help

Affiche des informations d'aide sur 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 les 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 permet à l'agent de reprendre la collecte des métriques de surveillance des processus que vous avez arrêté d'utiliser avec 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

Affiche la version de l'agent.

-workload_evaluation_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_evaluation_db_metrics_frequency=FREQUENCY

INT

Définit la fréquence à laquelle l'agent collecte les métriques de la base de données SAP HANA pour l'évaluation du gestionnaire de charges de travail.