Process

Supported OS Linux Mac OS Windows

Intégrationv2.3.0

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.

  1. 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/
  1. 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

system.processes.cpu.pct
(gauge)
The CPU utilization of a process.
Shown as percent
system.processes.cpu.normalized_pct
(gauge)
The normalized CPU utilization of a process.
Shown as percent
system.processes.involuntary_ctx_switches
(gauge)
The number of involuntary context switches performed by this process.
Shown as event
system.processes.ioread_bytes
(gauge)
The number of bytes read from disk by this process. In Windows: the number of bytes read.
Shown as byte
system.processes.ioread_bytes_count
(count)
The number of bytes read from disk by this process. In Windows: the number of bytes read.
Shown as byte
system.processes.ioread_count
(gauge)
The number of disk reads by this process. In Windows: the number of reads by this process.
Shown as read
system.processes.iowrite_bytes
(gauge)
The number of bytes written to disk by this process. In Windows: the number of bytes written by this process.
Shown as byte
system.processes.iowrite_bytes_count
(count)
The number of bytes written to disk by this process. In Windows: the number of bytes written by this process.
Shown as byte
system.processes.iowrite_count
(gauge)
The number of disk writes by this process. In Windows: the number of writes by this process.
Shown as write
system.processes.mem.page_faults.minor_faults
(gauge)
The number of minor page faults per second for this process.
Shown as occurrence
system.processes.mem.page_faults.children_minor_faults
(gauge)
The number of minor page faults per second for children of this process.
Shown as occurrence
system.processes.mem.page_faults.major_faults
(gauge)
The number of major page faults per second for this process.
Shown as occurrence
system.processes.mem.page_faults.children_major_faults
(gauge)
The number of major page faults per second for children of this process.
Shown as occurrence
system.processes.mem.pct
(gauge)
The process memory consumption.
Shown as percent
system.processes.mem.real
(gauge)
The non-swapped physical memory a process has used and cannot be shared with another process (Linux only).
Shown as byte
system.processes.mem.rss
(gauge)
The non-swapped physical memory a process has used. aka "Resident Set Size".
Shown as byte
system.processes.mem.vms
(gauge)
The total amount of virtual memory used by the process. aka "Virtual Memory Size".
Shown as byte
system.processes.number
(gauge)
The number of processes.
Shown as process
system.processes.open_file_descriptors
(gauge)
The number of file descriptors used by this process (only available for processes run as the dd-agent user)
system.processes.open_handles
(gauge)
The number of handles used by this process.
system.processes.threads
(gauge)
The number of threads used by this process.
Shown as thread
system.processes.voluntary_ctx_switches
(gauge)
The number of voluntary context switches performed by this process.
Shown as event
system.processes.run_time.avg
(gauge)
The average running time of all instances of this process
Shown as second
system.processes.run_time.max
(gauge)
The longest running time of all instances of this process
Shown as second
system.processes.run_time.min
(gauge)
The shortest running time of all instances of this process
Shown as second

É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.