Présentation
Le check Process possède plusieurs applications.
- Il vous permet de recueillir des métriques d’utilisation des ressources pour des processus en cours d’exécution spécifiques sur n’importe quel host (processeur, mémoire, E/S, nombre de threads, etc.).
- Il vous aide à tirer parti des monitors de processus : vous pouvez configurer des seuils pour le nombre d’instances d’un processus spécifique à exécuter et recevoir des alertes lorsque les seuils ne sont pas atteints (voir la section Checks de service ci-dessous).
Configuration
Installation
Le check Process est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre serveur.
Configuration
Contrairement à de nombreux checks, le check Process ne surveille aucun processus utile par défaut. Vous devez configurer les processus que vous souhaitez surveiller et la méthode à employer.
- Bien qu’il n’y ait pas de configuration standard par défaut, voici un exemple de configuration
process.d/conf.yaml qui permet de surveiller les processus SSH/SSHD. Consultez le fichier d’exemple process.d/conf.yaml pour découvrir toutes les options de configuration disponibles :
init_config:
instances:
## @param name - chaîne, obligatoire
## Permet d'identifier de façon unique vos métriques en leur appliquant un tag correspondant à ce nom dans Datadog.
#
- name: ssh
## @param search_string - liste de chaînes, facultatif
## Si l'un des éléments de la liste est recherché, le nombre
## total de processus correspondant parfaitement à la chaîne est renvoyé par défaut. Pour modifier ce comportement, utilisez le
## paramètre `exact_match: false`.
##
## Remarque : vous devez définir un seul des paramètres suivants pour chaque instance : search_string, pid ou pid_file.
#
search_string:
- ssh
- sshd
Pour récupérer certaines métriques de processus, le Collector Datadog doit être exécuté avec le même utilisateur que celui du processus surveillé ou disposer des droits d'accès adéquats. Si la première option n'est pas envisageable, et que vous ne souhaitez pas exécuter le Collector Datadog en tant que `root`, l'option `try_sudo` permet au check Process d'utiliser `sudo` pour recueillir cette métrique. Pour l'instant, seule la métrique `open_file_descriptors` sur les plateformes Unix accepte ce paramètre. Attention, cette option ne fonctionne que si les règles sudoers appropriées ont été configurées :
dd-agent ALL=NOPASSWD: /bin/ls /proc/*/fd/
- Redémarrez l’Agent.
Validation
Lancez la sous-commande status de l’Agent et cherchez process dans la section Checks.
Précisions sur les métriques
Remarque : certaines métriques ne sont pas disponibles sous Linux ou OSX :
- Les métriques E/S de processus ne sont pas disponibles sous Linux ou OSX. En effet, seul le propriétaire du processus peut lire les fichiers que l’Agent doit lire (
/proc//io). Pour en savoir plus, consultez la FAQ sur l’Agent. system.cpu.iowait n’est pas disponible sous Windows.
Toutes les métriques sont envoyées pour chaque instance configurée dans process.yaml et reçoivent le tag nom_processus:<nom_instance>.
La métrique system.processes.cpu.pct envoyée par ce check est uniquement fiable pour les processus actifs pendant plus de 30 secondes. Sa valeur ne doit pas être considérée comme exacte pour les processus actifs sur de plus courtes périodes.
Pour obtenir la liste des métriques, consultez la section Métriques.
Données collectées
Métriques
Événements
Le check Process n’inclut aucun événement.
Checks de service
process.up
Renvoie OK si le check ne dépasse pas les seuils d’avertissement, renvoie WARNING s’il dépasse les seuils d’avertissement et renvoie CRITICAL s’il dépasse les seuils critiques.
Statuses: ok, warning, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
Pour aller plus loin
Pour mieux comprendre comment (ou pourquoi) surveiller l’utilisation des ressources de processus avec Datadog, lisez la série d’articles de blog de Datadog à ce sujet.
