NOM¶
systemd-cgtop – Affichage des groupes de
contrôle utilisant le plus de ressources
SYNOPSIS¶
systemd-cgtop [OPTIONS...] [GROUPE]
DESCRIPTION¶
systemd-cgtop affiche les plus importants groupes de
contrôle de la hiérarchie locale de groupes de contrôle
de Linux, ordonnés selon leur charge de CPU, de mémoire ou
d’E/S de disque. L’affichage est rafraichi à
intervalles réguliers (par défaut chaque seconde), de
manière similaire à top(1). Si un chemin de groupe de
contrôle est indiqué, seuls les services de ce groupe de
contrôle sont affichés.
Si systemd-cgtop n’est pas connecté à
un TTY, aucun entête de colonne n’est affiché et, par
défaut, une seule itération est réalisée.
L’argument de l’option --iterations=, si
indiqué, est respecté. Ce mode est adapté pour des
scripts.
L’utilisation de ressources est seulement prise en compte
pour les groupes de contrôle dont les contrôleurs
appropriés sont activés :
« memory » pour l’utilisation de la
mémoire et « io » pour la consommation
d’E/S de disque. Si la supervision des ressources est requise, il est
recommandé d’ajouter les réglages
MemoryAccounting=1 et IOAccounting=1 dans les fichiers
d’unité en question. Consulter
systemd.resource-control(5) pour plus de détails.
La valeur de la charge du CPU peut être entre 0 et
100 fois le nombre de processeurs du système. Par exemple, si
le système possède 8 processeurs, la valeur de la
charge du CPU sera entre 0 % et 800 %. Le nombre de
processeurs peut être trouvé dans le fichier
/proc/cpuinfo.
À souligner : à moins que
« MemoryAccounting=1 » et
« IOAccounting=1 » ne soient activés pour
les services en question, aucun comptage de ressources ne sera disponible
pour les services du système et les données affichées
par systemd-cgtop seront incomplètes.
OPTIONS¶
Les options suivantes sont comprises :
-p, --order=path
Tri selon les noms de chemin de groupe de
contrôle.
-t, --order=tasks
Tri selon le nombre de tâches/processus dans le
groupe de contrôle.
-c, --order=cpu
Tri selon la charge de CPU.
-m, --order=memory
Tri selon l’utilisation de la
mémoire.
-i, --order=io
Tri selon la charge d’E/S de disque.
-b, --batch
Exécution en mode
« batch » : ne pas accepter
d’entrée et exécuter jusqu’à ce que la
limite d’itérations définie dans l’option
--iterations= soit atteinte ou que le processus soit tué. Ce
mode peut être utile pour envoyer la sortie de
systemd-cgtop
à d’autres programmes ou dans un fichier.
Ajouté dans la version 188.
-r, --raw
Formater le compte d’octets (tel que
l’utilisation de la mémoire ou les métriques
d’E/S) et la durée CPU sous forme de valeurs numériques
brutes plutôt que sous forme humainement lisible.
Ajouté dans la version 221.
--cpu=percentage, --cpu=time
Controls whether the CPU usage is shown as percentage or
time. By default, the CPU usage is shown as percentage. When the option is
used without an argument, it is equivalent to
--cpu=time. This setting
may also be toggled at runtime by pressing the % key.
Ajouté dans la version 226.
-P
Compter seulement les processus en espace utilisateur au
lieu de toutes les tâches. Par défaut, toutes les tâches
sont prises en compte : chaque thread du noyau et chaque thread en
espace utilisateur séparément. Avec ce réglage, les
threads du noyau sont exclus du comptage et chaque processus en espace
utilisateur est compté comme une seule tâche, quel que soit le
nombre de threads dont il est composé. Ce comportement peut être
aussi modifié en pressant la touche P en cours
d’exécution. Cette option ne peut pas être
combinée avec l’option
-k.
Ajouté dans la version 227.
-k
Compter les processus en espace utilisateur et les
threads du noyau au lieu de toutes les tâches. Par défaut,
toutes les tâches sont comptées : chaque thread du noyau
et chaque thread en espace utilisateur séparément. Avec ce
réglage, les threads du noyau sont inclus dans le comptage et chaque
processus en espace utilisateur est compté comme une seule
tâche, quel que soit le nombre de threads dont il est composé.
Ce comportement peut être aussi modifié en pressant la
touche K en cours d’exécution. Cette option ne peut pas
être combinée avec l’option
-P.
Ajouté dans la version 226.
--recursive=
Controls whether the number of processes shown for a
control group shall include all processes that are contained in any of the
child control groups as well. Takes a boolean argument, which defaults to
"yes". If enabled, the processes in child control groups are
included, if disabled, only the processes in the control group itself are
counted. This setting may also be toggled at runtime by pressing the r key.
Note that this setting only applies to process counting, i.e. when the
-P or
-k options are used. When all tasks are counted, setting
this option to "no" is rejected with an error, as task counting is
always recursive.
Ajouté dans la version 226.
-n, --iterations=
Réaliser seulement ce nombre
d’itérations. Une valeur zéro indique que le programme
s’exécute indéfiniment.
Ajouté dans la version 188.
-1
Raccourci pour
--iterations=1.
Ajouté dans la version 238.
-d, --delay=
Indiquer l’intervalle de rafraichissement en
seconde (ou « ms »,
« us » ou « min » si
indiqué comme unité de durée). Ce réglage peut
aussi être augmenté ou diminué en cours
d’exécution en pressant les touches + et -.
--depth=
Profondeur maximale de parcours de l’arbre des
groupes de contrôle. Cette option précise jusqu’à
quel niveau systemd-cgtop doit parcourir les hiérarchies de
groupes de contrôle. Si 0 est indiqué, seul le groupe de
contrôle racine est supervisé. Si 1 est indiqué,
seul le premier niveau est supervisé, etc. La valeur par
défaut est 3.
-M MACHINE, --machine=MACHINE
Limiter les groupes de contrôle affichés
à ceux correspondant au conteneur
MACHINE. Cette option ne peut
pas être utilisée lorsqu’un chemin de groupe de
contrôle est indiqué.
Ajouté dans la version 227.
-h, --help
Afficher un aide-mémoire succinct et
quitter.
--version
Afficher une information de version courte et
quitter.
RACCOURCIS CLAVIER¶
systemd-cgtop est un outil interactif et peut être
contrôlé par une saisie d’utilisateur en utilisant les
touches suivantes :
h
Afficher l'aide-mémoire.
Espace
Rafraichissement immédiat de l’affichage.
Ajouté dans la version 226.
q
Fin du programme.
p, t, c, m, i
Ordonner les groupes de contrôle par chemins,
nombres de tâches, charges de CPU, utilisations de la mémoire ou
charges d’E/S, respectivement. Ces réglages peuvent être
aussi contrôlés en utilisant l’option de ligne de
commande --order=.
%
Basculer l’affichage du temps CPU entre une
durée et un pourcentage. Ce réglage peut être
contrôlé avec l’option de ligne de commande
--cpu=.
Ajouté dans la version 201.
+, -
Augmenter ou diminuer l’intervalle de
rafraichissement. Ce réglage peut être contrôlé
avec l’option de ligne de commande --delay=.
P
Afficher le comptage de toutes les tâches ou
seulement les processus en espace utilisateur. Ce réglage peut
être contrôlé avec l’option de ligne de commande
-P (voir ci-avant).
Ajouté dans la version 227.
k
Afficher le comptage de toutes les tâches ou
seulement les processus en espace utilisateur et les threads du noyau. Ce
réglage peut être contrôlé avec l’option de
ligne de commande
-k (voir ci-avant).
Ajouté dans la version 226.
r
Inclure ou exclure de l’affichage de
manière récursive les processus des groupes de contrôle
enfants dans le comptage des groupes de contrôle de processus. Ce
réglage peut être contrôlé en utilisant
l’option de ligne de commande
--recursive=. Cette touche
n’est pas disponible si toutes les tâches sont prises en compte.
Elle n’est disponible que si les processus sont comptés, lorsque
cela est activé avec les touches P ou k.
Ajouté dans la version 226.
CODE DE RETOUR¶
En cas de succès, 0 est renvoyé, autrement,
un code d'échec différent de zéro est
renvoyé.
TRADUCTION¶
La traduction française de cette page de manuel a
été créée par Jean-Paul Guillonneau
<guillonneau.jeanpaul@free.fr>
Cette traduction est une documentation libre ; veuillez
vous reporter à la
GNU General
Public License version 3 concernant les conditions de copie et de
distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page
de manuel, veuillez envoyer un message à
debian-l10n-french@lists.debian.org.
