# Manuel utilisateur de &ksysguard;

## Introduction

&ksysguard; est en charge de la surveillance des performances et des tâches de &plasma;.

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 capteurs pour recevoir les informations qu'elle affiche. Un capteur 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 travail 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;

### Prise en main

&ksysguard; peut être lancé à partir du &menuk;, en utilisant l'entrée Surveillance du système dans le menu Application 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 optionnelle, d'une barre d'état, et de l'espace de travail. Les feuilles de travail personnalisées afficheront aussi le navigateur de capteurs.

Par défaut, &ksysguard; affiche deux feuilles de travail : la Table des processus et la Charge système. La Table des processus liste les processus en cours et permet à l'utilisateur de les contrôler. Plusieurs processus peuvent être sélectionnés et contrôlés à la fois. La Charge système affiche des graphiques de l'utilisation du système : Historique du processeur, Historique de la mémoire et de l'espace d'échange et Historique du réseau.

Cette configuration par défaut est suffisante pour permettre à un utilisateur inexpérimenté de faire un peu de gestion de système. Un utilisateur expérimenté ou même un 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.

Vous pouvez lancer la Table des processus en utilisant le raccourci global &Ctrl; &Echap; à n'importe quel moment. La table des processus est affichée dans une fenêtre nommée Activité du système.

### Table des processus

La table des 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.

Utilisez l'aide de Qu'est-ce que c'est ? pour le titre des colonnes afin avoir des informations supplémentaires sur les valeurs affichées ici.

Dans le menu contextuel d'un processus, depuis l'affichage de la liste, vous trouverez des actions supplémentaires comme régler la priorité, envoyer des signaux aux processus, afficher la fenêtre de l'application, afficher des informations détaillées sur la mémoire et terminer le processus.

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

### Colonnes par défaut dans la table des processus

Nom | Le nom de l'exécutable qui a lancé le processus.
Utilisateur | L'utilisateur propriétaire du processus
% processeur | L'utilisation actuelle du processeur par le processus, divisée par le nombre de cœurs du processeur de la machine.
Mémoire | C'est le quantité de mémoire physique réelle que le processus utilise à lui seul et donne une approximation de la quantité de mémoire privée que le processus utilise. Cela n'inclut pas la mémoire partagée, ni la taille du code de ses bibliothèques partagées. C'est souvent l'indicateur le plus intéressant pour évaluer l'utilisation de la mémoire par un processus.
Mém. partagée | C'est approximativement la quantité de mémoire physique réelle que les bibliothèques partagées nécessaires à l'exécution de ce processus utilisent. Cette mémoire est partagée par tous les processus qui utilisent cette bibliothèque.
Titre de la fenêtre | Le titre de toute fenêtre que ce processus affiche.

### Colonnes additionnelles de la tables des processus

PID | L'identifiant unique de ce processus.
TTY | Le terminal de contrôle dans lequel s'exécute ce processus
Courtoisie | La priorité avec laquelle s'exécute ce processus. Pour l'outil d'ordonnance normal, elle est situé entre 19 (très courtois, la priorité la moindre) et -19 (priorité maximum).
Temps processeur | Le temps utilisateur et système total pendant lequel ce processus s'est exécuté, affichée au format « minute : seconde ».
Lecture I/O | Le nombre d'octets lus. La Plage d'affichage et les Informations affichées peuvent être changés en utilisant le menu contextuel de l'en-tête de la colonne.
Écriture I/O | Le nombre d'octets écrits. La Plage d'affichage et les Informations affichées peuvent être changés en utilisant le menu contextuel de l'en-tête de la colonne.
Taille virtuelle | C'est la quantité d'espace mémoire virtuelle que le processus utilise, en prenant en compte les bibliothèques partagées, la mémoire graphique, les fichiers sur le disque et d'autres choses. Ce nombre n'a presque pas de sens. Utilisez le menu contextuel pour sélectionner la Plage d'affichage.
Commande | La commande par laquelle le processus a été lancé.

Au dessus du tableau, vous trouverez trois boutons que nous allons décrire de gauche à droite.

#### Mettre fin au processus

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

#### Barre de recherche

Le filtre est montré par le texte donnée ici. Le texte peut consister en une chaîne de caractère incomplète correspondant au Nom, à la Commande, ou au Titre de la fenêtre du processus. Il peut aussi être un Utilisateur ou un numéro PID.

#### 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 en vue à plat ou en arborescence, seulement les Processus système, les Processus utilisateurs, Mes propres processus ou bien Seulement les programmes.

L'arborescence est destinée à afficher 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 d'afficher 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.

### Espace de travail

L'espace de travail est organisé en feuilles de travail. Sélectionnez Nouvel onglet... dans le menu Fichier pour créer une nouvelle feuille de travail. 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 travail. Pour supprimer une feuille de travail, sélectionnez Fermer l'onglet dans le menu Fichier. Toutes les modifications seront enregistrées dans le fichier de la feuille de travail. Si la feuille de travail n'a jamais été enregistrée, on vous demandera de lui donner un nom de fichier. Les feuilles de travail sont composées de cellules présentées sous forme de grille.

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

Les feuilles de travail peuvent être configurées en cliquant sur Propriétés de l'onglet, dans le menu Affichage. Dans la boîte de dialogue qui apparaît, vous pouvez ajuster la dimension et l'intervalle de mise à jour.

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é ou de les supprimer de la feuille de travail.

#### Navigateur de capteurs

Le navigateur de capteurs révèle les fonctionnalités avancées de &ksysguard;. Pour les utiliser, vous devez d'abord aller dans le menu Fichier et créer une nouvelle feuille de travail. Il est affiché si une feuille de travail personnalisée est sélectionnée.

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

Après avoir configuré votre feuille de travail personnalisée, utiliser le séparateur et déplacer le vers le bord droit de la fenêtre pour masquer le navigateur de capteurs.

Si le navigateur de capteurs n'apparaît pas sur la feuille de travail personnalisée, il est probablement caché. Pour l'afficher, sélectionner le bord droit de la fenêtre et glisser le vers la gauche.

#### Graphique en lignes

Le graphique en ligne affiche les niveaux d'un ou plusieurs capteurs sur la durée. Dans les cas où plusieurs capteurs sont affichés en même temps, les niveaux sont affichés de différentes couleurs. Si l'affichage est suffisamment grand, une grille sera affichée afin de présenter la valeur des niveaux tracés. Comme la mise à l'échelle automatique est active par défaut, 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.

#### Affichage numérique

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

#### Graphique en barres

Le graphique 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érieure et supérieure. Dans les cas où la limite est dépassée, l'affichage est coloré dans la couleur d'alarme.

#### Journaliser dans un fichier

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érieure et supérieure 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.

#### Table des partitions

Utilisation de la partition possède une table spéciale de capteurs montrant des informations à propos des partitions montées.

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

Veuillez noter que l'élément de menu Surveiller l'ordinateur distant n'est uniquement disponible dans les onglets personnalisés.

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, le mode démon ou une commande personnalisé peuvent également être utilisés. 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 capteurs.

Pour se déconnecter d'un hôte, vous devez l'arrêter et relancer &ksysguard;.

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 terminer ou changer la courtoisie d'un processus dans la Table des processus, et les échanges de données sur le réseau ne seront pas chiffrées. Le mode démon n'est donc pas recommandé.

Mode shell

- Dans ce mode, l'application ksysguardd est démarrée au moment de la connexion par ksysguard. Pour que cela soit possible, son emplacement doit être inclus dans votre variable d'environnement `PATH`. Malheureusement, « ssh » ne lit pas votre fichier `.profile`, donc votre configuration de votre variable d'environnement `PATH` habituelle ne sera pas disponible. Au lieu de cela, il utilise une variable `PATH` par défaut, du genre `/bin:/usr/bin`. Comme il est probable que &plasma; ne soit pas installé dans ces dossiers, vous aurez besoin de créer ou de mettre à jour un fichier dans votre dossier utilisateur. Ce fichier se nomme `environment` et doit être placé dans un dossier caché appelé `.ssh`. Veuillez consulter la page du manuel sur ssh pour plus de détails. Le fichier doit contenir une ligne analogue à 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 clé d'hôte de la machine distante est déjà enregistrée sur votre machine. Si vous ne configurez pas `identity.pub` correctement, votre mot de passe vous sera demandé chaque fois que vous démarrez ksysguard. La manière la plus simple pour vérifier que tout fonctionne est de saisir `ssh `remotehost ksysguardd`` dans un terminal. Si ksysguardd apparaît, c'est que tout fonctionne correctement et vous pouvez alors saisir `quit` pour quitter ksysguardd.

Pour les experts : l'application ksysguardd est un tout petit programme ne dépendant que de « libc ». Il peut ainsi être utilisé sur des machines où &plasma; n'a pas été installé en totalité, comme par exemple des serveurs. Beaucoup de distributions majeures fournissent un paquet séparé de ksysguardd pour votre convenance. 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.

## Configuration de ksysguardd

L'interface graphique est disponible sur toutes les plates-formes bénéficiant de &plasma;. Cette interface est pour le moment disponible pour différentes déclinaisons d'&UNIX; :

&Linux;

- 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

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

## Remerciements et licence

&ksysguard; est actuellement développé et maintenu par &John.Tapsell; &John.Tapsell.mail;. &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

Traduction française par &YvesDessertine;, &PhilippeGuilbert;, et &RobinGuitton;.

Relecture par &LudovicGrossard;.

&underFDL; &underGPL;