Configurer l'agent Monitoring

Cette page explique comment configurer les métriques intégrées que l'agent Monitoring collecte à partir d'une VM Linux. Le contenu de cette page est destiné aux administrateurs système qui souhaitent modifier la configuration par défaut de l'agent Monitoring.

Vous ne pouvez pas configurer l'agent Monitoring lorsqu'il est installé sur une VM Windows.

Cette page ne décrit pas comment configurer l'agent Monitoring pour surveiller les applications tierces, ni comment utiliser l'agent pour collecter des métriques définies par l'utilisateur. Pour en savoir plus sur ces sujets, consultez les pages suivantes :

Avant de commencer

Si vous n'avez pas installé l'agent Monitoring sur une VM, consultez la page Installer l'agent Monitoring.

Modifier la configuration par défaut de l'agent Monitoring

Pour modifier la configuration de l'agent Monitoring, procédez comme suit :

  1. Modifiez le fichier de configuration de l'agent Monitoring /etc/stackdriver/collectd.conf.

  2. Redémarrez l'agent de surveillance en exécutant la commande suivante :

       sudo service stackdriver-agent restart

Arrêter la collecte des métriques de processus

Pour en savoir plus sur l'arrêt de la collecte de métriques de processus (les métriques comportant le préfixe agent.googleapis.com/processes), consultez la section Désactiver les métriques de processus sur des VM Linux.

Configurer les métriques de processeur rapportées

Par défaut, l'agent Monitoring indique l'utilisation totale du processeur par état pour tous les processeurs de la VM à l'aide du type de métrique agent.googleapis.com/cpu/utilization. Ce comportement est spécifié dans le fichier de configuration par les paramètres suivants :

  • ValuesPercentage true
  • ReportByCpu false

Vous devez modifier ces paramètres si vous souhaitez que l'agent indique les métriques d'utilisation par processeur ou les métriques de durée d'utilisation du processeur (agent.googleapis.com/cpu/usage_time) :

  • Pour configurer l'agent Monitoring de façon à indiquer l'utilisation par processeur (agent.googleapis.com/cpu/utilization), procédez comme suit :

    • Laissez ValuesPercentage avec la valeur par défaut true.
    • Définissez ReportByCpu sur true.

  • Pour configurer l'agent Monitoring de façon à indiquer la durée d'utilisation par processeur (agent.googleapis.com/cpu/usage_time), procédez comme suit :

    • Définissez ValuesPercentage sur false.
    • Définissez ReportByCpu sur true.

L'agent Monitoring peut indiquer l'utilisation du processeur ou l'usage du processeur, mais pas les deux. Il s'agit d'une limitation connue de collectd. Lorsque ReportByCpu est défini sur true, le champ ValuesPercentage détermine si l'utilisation ou l'usage est rapporté. Lorsque ReportByCpu a la valeur false, l'agent indique l'utilisation du processeur.

Dépannage

Si vous rencontrez des difficultés pour installer ou exécuter l'agent, consultez la section Résoudre des problèmes liés à l'installation de l'agent.