# Manuel de &ksysguard;

## Introduction

&ksysguard; est le gestionnaire de tâches et le surveillant des performances de &kde;. Il présente une architecture client/serveur qui permet la surveillance aussi bien d'un hôte local que d'un hôte distant. L'interface graphique utilise ce qu'on appelle des mesures pour recevoir les informations qu'elle affiche. Une mesure peut retourner des valeurs simples ou plus complexes, comme des tableaux. Pour chaque type d'information, un ou plusieurs modes d'affichage sont proposés. Les modes d'affichage sont organisés en feuilles de données qui peuvent être enregistrées et chargées indépendamment les unes des autres. &ksysguard; n'est donc pas seulement un simple gestionnaire de tâches, c'est aussi un outil de contrôle très puissant pour de larges baies de serveurs.

## Utilisation de &ksysguard;

### Premiers pas

&ksysguard; peut être lancé à partir du menu de démarrage, en utilisant l'entrée Surveillance du système dans le menu Système. Sinon, vous pouvez lancer le programme en saisissant `ksysguard` dans un terminal.

La fenêtre principale de &ksysguard; se compose d'une barre de menus, d'une barre d'outils optionnels, d'une barre d'état, de la liste des mesures et de l'espace de travail. Lorsque vous lancerez le programme pour la première fois, vous observerez que votre machine apparaît en tant que localhost dans la liste des mesures et qu'il y a 2 pages disponibles dans l'espace de travail. C'est la configuration par défaut.

Cette configuration par défaut est suffisante pour permettre à un utilisateur inexpérimenté de gérer n'importe quel système. Un utilisateur expérimenté ou l'administrateur système d'un large parc d'ordinateurs a des besoins différents. Afin de répondre aux besoins d'un large public, &ksysguard; est extrêmement flexible.

### La liste des mesures

La liste des mesures affiche les hôtes répertoriés et leurs mesures sous forme d'arborescence. Cliquez sur les poignées de l'arborescence pour ouvrir ou fermer une sous-arborescence. Chaque mesure surveille une certaine valeur du système.

#### Connexion à d'autres hôtes

Pour se connecter à un nouvel hôte, utilisez Se connecter à l'hôte... dans le menu Fichier. Une boîte de dialogue apparaît alors afin de vous permettre de saisir le nom de l'hôte auquel vous souhaitez vous connecter. Au-dessous du nom, vous pouvez choisir la méthode de connexion. Par défaut, il s'agit de ssh, le shell sécurisé. Le shell distant rsh peut également être utilisé. Cliquez sur OK pour établir la connexion. Peu après, le nouvel hôte apparaît dans la liste et vous pouvez parcourir la liste de ses mesures.

Pour établir la connexion, un programme appelé ksysguardd, doit être installé sur le nouvel hôte. Ce programme peut être démarré dans les deux modes suivants :

mode démon

- Vous pouvez lancer ksysguardd au démarrage en mode Démon en passant `-d` comme argument. Dans ce cas, vous aurez à sélectionner le mode démon dans la boîte de dialogue de connexion de ksysguard. L'inconvénient de ce type de connexion est que vous ne pourrez pas tuer ou changer la courtoisie d'un processus avec le Contrôleur de processus, et les échanges de données sur le réseau ne seront pas codées.

mode shell

- Dans ce mode, ksysguardd est démarré au moment de la connexion par ksysguard. Pour que cela soit possible, son emplacement doit être inclus dans votre `PATH`. Malheureusement, ssh ne lit pas votre fichier `.profile`, donc votre paramètre `PATH` habituel ne sera pas disponible. Au lieu de cela, il utilise un `PATH` par défaut, du genre `/bin:/usr/bin`. Comme il est probable que &kde; ne soit pas installé dans ces dossiers, vous aurez besoin de créer ou de mettre à jour un fichier dans votre dossier home. Ce fichier se nomme `environment` et doit être placé dans un dossier caché appelé `.ssh`. Consultez la page du manuel sur ssh pour plus de détails. Le fichier doit contenir une ligne qui ressemble à celle qui suit :

      PATH=/bin:/usr/bin:/opt/kde/bin

  en supposant que ksysguardd puisse être trouvé dans `/opt/kde/bin/ksysguardd`.

  Si vous utilisez ssh, vous devez vous assurer que votre `identity.pub` est installé sur la machine distante et que la clef d'hôte de la machine distante est déjà enregistrée sur votre machine. La manière la plus simple de vérifier est de saisir `ssh `remotehost ksysguardd`` dans un terminal. Si vous lisez ksysguardd, vous pouvez alors saisir `quit` et tout est en ordre.

Pour les experts : ksysguardd est un tout petit programme qui ne dépend que de libc. Il peut ainsi être utilisé sur des machines où &kde; n'a pas été installé en totalité, comme par exemple des serveurs. Si vous choisissez l'option de commande personnalisée dans la fenêtre de connexion à un nouvel hôte, vous devrez spécifier la commande complète pour démarrer ksysguardd.

#### Se déconnecter de l'hôte

Pour se déconnecter d'un hôte, sélectionnez l'hôte dans la liste des mesures et choisissez Se déconnecter de l'hôte dans le menu Fichier. Au cas où vous auriez encore des mesures en cours, les cadres de l'affichage apparaîtront grisés et les données ne seront plus mises à jour.

### L'espace de travail

L'espace de travail est organisé en feuilles de données. Sélectionnez Nouveau dans le menu Fichier pour créer une nouvelle feuille de données. Une boîte de dialogue apparaîtra alors dans laquelle vous pourrez indiquer le nom, la dimension et l'intervalle de mise à jour de la feuille de données. Pour supprimer une feuille de données, sélectionnez Fermer dans le menu Fichier. Toutes les modifications seront enregistrées dans le fichier de la feuille de données. Si la feuille de données n'a jamais été enregistrée, on vous demandera de lui donner un nom de fichier. Les feuilles de données sont composées de cellules présentées sous forme de grille.

Chaque cellule peut afficher une ou plusieurs mesures. Vous pouvez remplir une cellule en glissant-déposant une mesure à partir de la liste des mesures dans une cellule. Dans les cas où il y a plus d'un mode d'affichage disponible pour le type de mesure sélectionné, un menu surgissant apparaît. Vous pouvez alors sélectionner le mode d'affichage que vous préférez utiliser. Certains modes d'affichage peuvent montrer plus d'une mesure. Ajoutez des mesures supplémentaires à un mode d'affichage en glissant-déposant ces mesures à partir de la liste des mesures dans l'affichage existant.

Les feuilles de données peuvent être configurées en cliquant sur Configurer la feuille de données, dans le menu Édition. Dans la boîte de dialogue qui apparaît, vous pouvez ajuster la dimension et l'intervalle de mise à jour. Cet intervalle de mise à jour est utilisé par tous les affichages de la feuille de données qui a l'option Utiliser l'intervalle de rafraîchissement de la feuille de données activée dans sa boîte de dialogue de configuration du temps.

L'entrée Configurer le style... du menu Configuration vous donne la possibilité de configurer les attributs de style globaux, puis de les appliquer à la feuille de données active.

Les affichages peuvent être configurés en cliquant dessus avec le bouton droit de la souris. Un menu contextuel apparaît, dans lequel vous pouvez choisir de modifier les propriétés de l'affichage sélectionné, de le supprimer de la feuille de données, de changer le type et la valeur de son intervalle de mise à jour ou d'arrêter ou recommencer sa mise à jour momentanément.

#### Traceur

Le traceur de signaux affiche les niveaux d'une ou plusieurs mesures sur la durée. Dans les cas où plusieurs mesures sont affichées en même temps, les niveaux sont affichées de différentes couleurs. Si l'affichage est suffisamment grand, une grille sera affichée afin de montrer la valeur des niveaux tracés. Comme, par défaut, la mise à l'échelle automatique est active, les valeurs minimales et maximales seront fixées automatiquement. Parfois, vous voudrez des valeurs minimales et maximales déterminées. Dans ce cas, vous pouvez désactiver la mise à l'échelle automatique et ajuster les valeurs dans la boîte de dialogue des propriétés.

#### Multimètre

Le multimètre affiche les niveaux de mesure sous forme de multimètre numérique. Dans la boîte de dialogue des propriétés, vous pouvez spécifier les valeurs minimales et maximales. Dans les cas où la limite est dépassée, l'affichage est coloré dans la couleur d'alarme.

#### Contrôleur de processus

Le contrôleur de processus vous donne une liste des processus de votre système. La liste peut être triée par colonne. Il suffit de cliquer sur l'en-tête de la colonne choisie avec le bouton gauche de la souris.

La liste affiche les informations suivantes pour tout processus. Veuillez noter que toutes ces propriétés ne sont pas disponibles sur tous les systèmes d'exploitation.

Nom

- Le nom de l'exécutable qui a lancé le processus.

PID

- L'ID du processus. Un chiffre unique pour chaque processus.

PPID

- L'ID du processus parent.

UID

- L'ID de l'utilisateur qui a lancé le processus.

GID

- L'ID du groupe auquel le processus appartient.

État

- L'état du processus.

Utilisateur%

- La charge du processeur liée au processus dans l'espace utilisateur (en pourcentage).

Système%

- La charge du processeur liée au processus dans l'espace système (en pourcentage).

Courtoisie

- L'indice de priorité du processus.

VmSize

- L'espace total de mémoire virtuelle (en kilo-octets) utilisé par le processus.

VmRss

- L'espace total de mémoire physique (en kilo-octets) utilisé par le processus.

Connexion

- Le nom de connexion de l'utilisateur qui a lancé le processus.

Commande

- La commande de démarrage complète du processus.

Sous le tableau, vous trouverez quatre boutons que nous allons décrire de gauche à droite.

##### L'Arborescence

L'arborescence est destinée à montrer les rapports entre les processus exécutés. Un processus qui est exécuté par un autre processus est appelé l'enfant de ce dernier processus. Une arborescence est une manière élégante de montrer les rapports parent-enfant entre les processus. Le processus init est leur ancêtre à tous.

Si vous ne vous intéressez pas aux enfants d'un processus particulier, cliquez sur la petite case à gauche du parent et la sous-arborescence disparaîtra. Un autre clic sur cette même case déploiera à nouveau la sous-arborescence.

##### Le filtre de processus

Le filtre de processus peut être utilisé pour réduire le nombre de processus affichés dans le tableau. Vous pouvez filtrer les processus qui ne vous intéressent pas. Vous pouvez afficher tous les processus, seulement les processus système, les processus utilisateurs ou bien vos propres processus.

##### Le bouton Rafraîchir

Ce bouton peut être utilisé pour forcer une mise à jour immédiate de la liste des processus.

##### Le bouton Tuer

Si vous avez sélectionné un ou plusieurs processus, vous pouvez les tuer en appuyant sur le bouton Tuer. Un signal SIGKILL est envoyé aux processus, ce qui les force à se terminer immédiatement. Si ces applications possèdent des données non enregistrées, ces données sont perdues. Il faut donc utiliser ce bouton avec précaution.

#### Graphe en barres

Le graphe en barres affiche les valeurs des capteurs sous forme d'histogramme. Dans la boîte de dialogue des propriétés, vous pouvez spécifier les limites inférieures et supérieures. Dans les cas où la limite est dépassée, l'affichage est coloré dans la couleur d'alarme.

#### Journalisation des capteurs

La journalisation des capteurs n'affiche aucune valeur, mais enregistre ces valeurs dans un journal avec des informations supplémentaires à propos de la date et de l'heure. Pour chaque capteur, vous pouvez spécifier les limites inférieures et supérieures dans la boîte de dialogue des propriétés. Au cas où la limite est dépassée, l'entrée dans la table des capteurs est colorée dans la couleur d'alarme et un événement knotify est envoyé.

#### Journal

Le moniteur de journal affiche le contenu d'un fichier, &pex; `/var/log/messages`. Dans la boîte de dialogue des propriétés, vous pouvez définir une liste d'expressions rationnelles qui seront comparées avec le contenu du fichier. Si l'une de ces expressions correspond, un événement knotify sera envoyé.

#### Vue en liste

La vue en liste affiche des données de certains capteurs sous forme de tableau.

## Configuration de ksysguardd

L'interface graphique est disponible sur toutes les plates-formes supportant &kde;. Cette interface est pour le moment disponible pour différentes déclinaisons d'&UNIX; :

&Linux; 2.x

- Pour faire fonctionner ksysguardd, il est nécessaire de compiler le noyau &Linux; avec le système de fichiers `/proc` activé. C'est la configuration par défaut la plus courante et la plupart des distributions &Linux; l'ont déjà.

FreeBSD

- Le programme ksysguardd doit faire partie du groupe `kmem` et son bit "setgid" doit être activé.

&Solaris;

- À écrire

Le support pour d'autres plates-formes est en préparation. Votre aide serait grandement appréciée.

## Remerciements et licences

&ksysguard; est développé et maintenu par Chris Schlügercs@kde.org. &ksysguard; est une réécriture de KTop, le gestionnaire de tâches pour KDE 1.x. Plusieurs autres personnes ont travaillé sur KTop :

- A. Sanda alex@darkstar.ping.at

- Ralf Mueller ralf@bj-ig.de

- Bernd Johannes Wuebben wuebben@math.cornell.edu

- Nicolas Leclercq nicknet@planete.net

Le portage sur des plates-formes autres que &Linux; a été réalisé par :

- FreeBSD : Hans Petter Bieker zerium@traad.lavvu.no

&underFDL; &underGPL;