# Le manuel de &ksysguard;

Chris
Schlaeger

    cs@kde.org

Chris
Schlaeger

    cs@kde.org

Développeur
Lauri
Watts

    vampyr@atconnex.net

Relecteur
Philippe
Guilbert

    guilbertph@wanadoo.fr

Traduction française
2000
Chris Schlaeger
&FDLNotice;
2000-12-14
1.00.00

&ksysguard; est une application de gestion de tâches avec fonctionnalités réseau et une application de surveillance système avec les fonctionnalités supplémentaires de top

KDE
KSysGuard
Surveillance de processus
top
ps

## Introduction

&ksysguard; prend en charge la gestion des tâches et la surveillance 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 retrouver l'information qu'elle affiche. Une mesure peut retourner des valeurs simples ou plus complexes comme des tables. 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 appelées indépendamment les unes des autres. &ksysguard; n'est donc pas seulement un gestionnaire de tâches, c'est aussi un outil de contrôle très puissant pour de large batteries de serveurs.

## Utilisation de &ksysguard;

### Démarrage

&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 de statuts, 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, utiliser 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 une connexion, un programme dénommé ksysguardd est lancé sur le nouvel hôte. Ce programme doit être installé sur la machine et doit être référencé dans le `PATH`. Malheureusement, ssh n'édite pas votre fichier `.profile`, votre configuration actuelle du `PATH` ne sera donc pas disponible. Il utilise à la place un `PATH` par défaut, comme `/bin:/usr/bin`. Comme KDE n'est sans doute pas installé dans ces dossiers, vous aurez besoin de créer et de mettre à jour un fichier dans votre dossier home. Ce fichier se nomme `environment` et doit être placé dans un dossier caché appelé `.ssh`. Voir 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/kde2/bin

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

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.

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.

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

Pour se déconnecter d'un hôte, sélectionnez les hôtes 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 et la dimension 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. 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é, une fenêtre de dialogue 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 affichages peuvent être configurés en cliquant dessus avec le bouton droit de la souris. Une fenêtre de dialogue apparaît, dans laquelle vous pouvez choisir soit de modifier les propriétés de l'affichage sélectionné, soit de le supprimer de la feuille de données.

#### Traceur

Le traceur 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. Si vous paramétrez les valeurs maximum et minimum sur 0 dans la boîte de dialogue des propriétés, le traceur fonctionnera en mode automatique. Sinon, ce sont les valeurs spécifiées qui seront utilisées.

#### 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 maximum et minimum. Dans les cas où la limite est dépassée, l'affichage apparaît en rouge et un message d'alarme est affiché.

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

PID

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

Nom

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

UID

  Le login de l'utilisateur qui a lancé le processus.

CPU

  La charge du processeur liée au processus (exprimée en pourcentage).

Temps

  Le cumul du temps total d'exécution du processus.

Nice

  L'indice de priorité du processus.

Statut

  L'état du processus.

VmSize

  L'espace total de mémoire (en Kilo-octets) utilisé par le processus. Cela inclut la mémoire partagée.

VmRss

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

VmLib

  L'espace total de mémoire (en kilo-octets) que le processus partage avec d'autres 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.

##### La case à cocher Pause

Cochez la case pause, si vous voulez interrompre la mise à jour automatique de la liste des 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 SIGKIL 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.

## 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 plateformes autres que Linux a été réalisé par :

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

&underFDL; &underGPL;

## Installation

### Comment obtenir &ksysguard;

&ksysguard; fait partie du projet KDE http://www.kde.org. &ksysguard; peut être trouvé sur ftp://ftp.kde.org/pub/kde/, le site ftp principal du projet KDE.

### Configuration requise

Pour réussir à compiler &ksysguard;, vous avez besoin de KDE 2.0 et de Qt 2.2.x. Toutes les librairies requises ainsi que &ksysguard; lui-même peuvent être trouvés à l'adresse suivante : ftp://ftp.kde.org/pub/kde/.

L'interface graphique est disponible sur toutes les plateformes supportant KDE. Cette interface est pour le moment disponible pour différentes déclinaisons d'UNIX :

Linux 2.x

  Pour faire fonctionner &ksysguard; 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 la possède.

FreeBSD

  Le programme &ksysguard; doit faire partie du groupe kmem et son bit "setgid" doit être activé.

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

### Compilation et installation

Afin de compiler et d'installer &ksysguard; sur votre système, saisissez les commandes suivantes dans le dossier de base de la distribution de kdeutils :

    % ./configure
    % make
    % make install

Si vous deviez rencontrer des difficultés, rapportez-les sur les listes de diffusion de KDE.