# O Manual do &ksysguard;

## Introdução

O &ksysguard; é o Monitor de Performance e Tarefas do &kde;.

Baseia-se numa arquitectura cliente/servidor que permite a monitorização das máquinas locais e remotas. A interface gráfica usa alguns sensores para obter a informação que mostram. O sensor poderá devolver valores simples ou mesmo informações complexas como, por exemplo, tabelas. Para cada tipo de informação, existem uma ou mais áreas de visualização. As áreas estão organizadas em folhas de trabalho que podem ser gravadas e carregadas independentemente umas das outras. Como tal, o &ksysguard; não só é um gestor de tarefas simples como também é uma ferramenta bastante poderosa para controlar as várias colónias de servidores.

## Usar o &ksysguard;

### Introdução

&ksysguard; can be started from the &kmenu;, using the entry System Monitor in the Applications System menu. Alternatively, you can start it by typing `ksysguard` in a terminal.

A janela principal do &ksysguard; consiste numa barra de menu, numa barra de ferramentas opcional e numa barra de estado, assim como no gestor de sensores e no espaço de trabalho.

By default &ksysguard; shows two worksheets: "Process Table" and "Sensor Load". The Process Table lists the running processes and lets the user control them. Multiple processes can be selected and controlled at once. The Sensor Load worksheet shows graphs of system utilization: (clockwise from Top-Left) CPU Load, the system Load Average over the past minute, Physical Memory (RAM) usage, and finally Swap Memory usage.

Esta mesma configuração é o suficiente para um utilizador inexperiente fazer alguma gestão do sistema. Um utilizador mais experiente ou mesmo um administrador de sistemas de um laboratório com grandes computadores têm diferentes necessidades. Para se acomodar a um conjunto vasto de utilizadores, o &ksysguard; é altamente flexível.

### The Sensor Browser

The sensor browser exposes &ksysguard;'s advanced functionality. To use it, you must first go to the file menu and create a new worksheet. It is shown whenever a custom worksheet is selected.

A lista de sensores mostra as máquinas registadas e os sensores no formato de uma árvore. Carregue nos nós da árvore para abrir ou fechar uma ramificação. Cada sensor vigia um dado valor do sistema.

#### Estabelecer ligações a outros computadores

To connect to a new host use Monitor remote machine... from the File menu. A dialog box will appear and allows you to enter the name of the host you want to connect to. Below the name you can choose the connection method. The default is ssh, the secure shell. Alternatively the rsh, the remote shell, or the daemon mode can be used. Click OK to establish the connection. Shortly afterwards the new host will appear in the sensor browser and you can browse the list of sensors.

Para estabelecer uma ligação, deve-se instalar na nova máquina um programa chamado ksysguardd, o qual poderá ser iniciado nos dois modos seguintes.

modo servidor

- You can start ksysguardd at boot time in Daemon mode by adding `-d` as the argument. In this case, you have to select daemon mode at the connection dialog of ksysguard. A disadvantage of this connection type is that you won't be able to kill or renice a process with the Process Controller and the data exchange over network won't be encrypted. As a result, daemon mode is not recommended.

modo da linha de comandos

- Neste modo, o ksysguardd é iniciado na altura da ligação pelo ksysguard. Para tornar isto possível, a sua localização deverá ser incluída na sua `PATH`. Infelizmente, o 'ssh' não executa o seu ficheiro `.profile`, como tal a sua configuração da `PATH` normal não estará disponível. Em vez disso, utiliza uma `PATH` por omissão do tipo `/bin:/usr/bin`. Dado que é muito provável que o KDE não esteja instalado nessas pastas, o utilizador terá de criar ou actualizar um ficheiro na sua pasta pessoal. Esse ficheiro chama-se `environment` e necessita estar numa pasta escondida chamada `.ssh`. Veja a página do manual do ssh para mais detalhes. O ficheiro necessita ter uma linha semelhante a:

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

  assumindo que o ksysguardd pode ser encontrado em `/opt/kde/bin/ksysguardd`.

  Ao usar o ssh terá de confirmar se tem o `identity.pub` instalado na máquina remota e se a chave da mesma máquina se encontra registada na sua máquina. Se não configurar o `identity.pub`, ser-lhe-á pedida a senha sempre que iniciar o ksysguard. A forma mais fácil de verificar isso é escrever `ssh `maquina_remota ksysguardd`` numa linha de comandos. Se o ksysguardd o atender, o utilizador poderá escrever `quit` e está tudo pronto.

Para os peritos: o ksysguardd é uma aplicação muito pequena que só está compilada com a 'libc'. Como tal poderá ser usada nas máquinas que não tenham uma instalação completa do &kde;, como acontece nos servidores. Muitas das distribuições oferecem um pacote ksysguardd separado para sua conveniência. Se escolher a opção do comando personalizado na ligação à máquina terá de especificar o comando completo para iniciar o ksysguardd.

#### Disconnecting hosts

To disconnect from a host, select the host in the sensor browser and choose Disconnect Host from the File menu. If you still have sensors in use, the display frames will be grayed and the displays won't update any longer.

### The Work Space

The work space is organized as worksheets. Select New Worksheet... from the File menu to create a new worksheet. A dialog will appear where you can set the name, the dimension and the update interval of the worksheet. To remove a worksheet again, select Close from the File menu. Any modifications will be saved to the worksheet file. If a worksheet has never been saved, you will be asked for a file name. Worksheets consist of cells organized as a grid.

Cada célula poderá ser preenchida com uma área para um ou mais sensores. Poderá preencher uma célula ao arrastar um sensor a partir da lista de sensores e ao largá-la na célula. Se existir mais do que uma área disponível para esse tipo de sensor, irá aparecer um menu de contexto. Poderá então seleccionar qual a área que prefere usar. Certo tipo de áreas podem mostrar mais do que um sensor. Adicione mais sensores a uma área, bastando para tal arrastá-los da lista de sensores e largá-loas na área já existente.

Worksheets can be configured by clicking Configure Worksheet at the Edit menu. In the appearing dialog you can set the dimension and the update interval. This update interval is used by all displays of the worksheet, which has the use update interval of worksheet set in its timer configuration dialog.

The entry Configure Style of the Settings menu gives you the possibility to configure the global style attributes and apply them to the current active worksheet.

Displays can be configured by clicking with the right mouse button on them. A popup menu appear where you can select whether you want to change the properties of that display, remove it from the worksheet, change its update interval type and value or pause and restart its updating.

#### Signal Plotter

The signal plotter prints samples of one or more sensors over time. If, several sensors are displayed, the values are piled in different colors. If the display is large enough a grid will be displayed to show the range of the plotted samples. By default, the automatic range mode is active so the minimum and maximum values will be set automatically. Sometimes you want fixed minimum and maximum values. In that case, you can deactivate automatic range mode and set the values in the properties dialog.

#### Multimeter

O multímetro mostra os valores dos sensores como um multímetro digital. Nas janelas de propriedades poderá escolher um limite inferior e superior. Se o intervalo for excedido, a área é colorida com a cor do alarme.

#### Process Controller

The Process Controller gives you a list of processes on your system. The list can be sorted by each column. Just press the left mouse button at the head of the column.

A lista dá-lhe as seguintes informações sobre cada processo. Lembre-se que nem todas as propriedades estarão disponíveis em todos os sistemas operativos.

Nome

- The name of the executable that started the process.

PID

- The Process ID. A unique number for each process.

PPID

- The Process ID of the process parent.

UID

- The ID of the user that started the process.

GID

- The ID of the group the process belongs to.

Status

- The process status.

User%

- The processor load of the process in user space (in percent).

System%

- The processor load of the process in system space (in percent).

Nice

- The scheduling priority.

VmSize

- The total amount of virtual memory used by the process (in kBytes).

VmRss

- The total amount of physical memory used by the process (in kBytes).

Login

- The login name of the user that started the process.

Comando

- The complete start command of the process.

Underneath the table you find four buttons which will be described now from left to right.

##### The Tree View

A vista em árvore foi desenhada para mostrar as relações entre os processos em execução. Um processo que é iniciado por outro processo é denominado como seu filho. Uma árvore é uma forma elegante de mostrar esta relação de pai para filho. O processo init é o ascendente de todos os processos.

Se não estiver interessado nos filhos de um processo em particular poderá carregar na pequena opção à esquerda do pai para que a sua sub-árvore se feche. Se voltar a carregar no mesmo símbolo, a mesma sub-árvore abrir-se-á de novo.

##### The Process Filter

The Process Filter can be used to reduce the number of processes displayed in the table. You can filter out processes you are not interested in. Currently you can display all processes, system processes only, user processes only or your processes only.

##### The Refresh Button

This button can be used to force an immediate update of the process list.

##### The Kill Button

If you have selected one or more processes you can press the kill button to kill them. A so called SIGKILL is sent to the processes which causes them to terminate immediately. If these applications still have unsaved data this data will be lost. So use this button with care.

#### BarGraph

The bargraph displays the sensor values as dancing bars. In the properties dialog you can specify minimum and maximum values of range and a lower and upper limit. If the range is exceeded, the display is colored in the alarm color.

#### Sensor Logger

The sensor logger does not display any values, but logs them in a file with additional date and time information. For each sensor you can specify a lower and upper limit in the properties dialog. If the range is exceeded, the entry of the sensor table is colored in the alarm color and a knotify event is sent.

#### Log File

The log file monitor displays the content of a file ⪚ `/var/log/messages`. In the properties dialog, you can compose a list of regular expressions that will be compared with the content of the file. If one of the expressions match, a knotify event will be sent.

#### List View

The listview displays the data of some sensors in the form of a table.

## Configurar o ksysguardd

A interface gráfica está disponível para todas as plataformas onde o &kde; se executa. A infra-estrutura está de momento disponível para as seguintes variantes do &UNIX;:

&Linux; 2.x

- Para o ksysguardd funcionar é necessário compilar o 'kernel' do &Linux; com o suporte para o sistema de ficheiros `/proc` activo. Esta é a configuração por omissão e a maioria das distribuições do &Linux; já o têm.

FreeBSD

- O programa ksysguardd necessita de pertencer ao grupo `kmem` e necessita de ter o 'bit' 'setgid' activo.

&Solaris;

- A ser escrito

O suporte para as outras plataformas está em progresso. Agradece-se-á bastante a sua ajuda.

## Créditos e Licenças

O &ksysguard; está a ser desenvolvido e mantido pelo &John.Tapsell; &John.Tapsell.mail;. O &ksysguard; é uma reinvenção do KTop, o gestor de tarefas do &kde; 1.x. Várias outras pessoas trabalharam no 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

A passagem para outras plataformas que não o &Linux; foi feita por:

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

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;