# O Manual do &ksysguard;

&Chris.Schlaeger;&Chris.Schlaeger.mail;
John
Tapsell
john@geola.co.uk
&Chris.Schlaeger;&Chris.Schlaeger.mail;
&Tobias.Koenig;&Tobias.Koenig.mail;
José
Pires

    jncp@netcabo.pt

Tradução
2000
&Chris.Schlaeger;
&FDLNotice;
2000-12-14
1.00.00

&ksysguard; is a network enabled task manager and system monitor application, with the additional functionality of top.

KDE
KSysGuard
monitor de processos
top
ps

## Introdução

&ksysguard; is the &kde; Task Manager and Performance Monitor. It features a client/server architecture that allows monitoring of local as well as remote hosts. The graphical front end uses so-called sensors to retrieve the information it displays. A sensor can return simple values or more complex information like tables. For each type of information, one or more displays are provided. Displays are organized in work sheets that can be saved and loaded independently from each other. So, &ksysguard; is not only a simple task manager but also a very powerful tool to control large server farms.

## Usar o &ksysguard;

### Introdução

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

The &ksysguard; main window consists of a menu bar, an optional tool bar and status bar, the sensor browser and the work space. When first started you see your local machine listed as localhost in the sensor browser and 2 pages in the work space area. This is the default setup.

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.

### A Lista de Sensores

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 Connect Hosts 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.

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

  When using ssh you should make sure that you have your `identity.pub` installed on the remote machine and the host key of the remote machine is already registered on your machine. The easiest way to check this is to type `ssh `remotehost ksysguardd`` in a shell. If you are greeted by ksysguardd you can type `quit` and everything is in order.

For experts: ksysguardd is a very small program that is only linked against the libc. So it can also be used on machines that do not have a full blown &kde; installed, such as servers. If you choose the custom command option in the host connector you need to specify the complete command to start ksysguardd.

#### Desligar das máquinas

Para se desligar de uma máquina, seleccione-a na lista de sensores e seleccione Desligar da Máquina no menu Ficheiro. Se tiver sensores em uso, as áreas de visualização ficarão acinzentadas e não serão mais actualizadas.

### O Espaço de Trabalho

The work space is organized as work sheets. Select New from the File menu to create a new work sheet. A dialog will appear where you can set the name, the dimension and the update interval of the work sheet. To remove a work sheet again, select Close from the File menu. Any modifications will be saved to the work sheet file. If a work sheet has never been saved, you will be asked for a file name. Work sheets 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.

Work sheets 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.

A opção Configurar o Estilo do menu Configuração dá-lhe a possibilidade de configurar os atributos globais de estilo e aplicá-los à folha de trabalho actual.

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 work sheet, change its update interval type and value or pause and restart its updating.

#### Desenho do Sinal

O desenhador do sinal imprime as amostras de um ou mais sensores ao longo do tempo. Se forem apresentados vários sensores, os valores serão sobrepostos em diferentes cores. Se a área for suficientemente grande, será desenhada um grelha para mostrar o intervalo das amostras desenhadas. Por omissão, o modo de intervalo automático está activo para que os valores máximos e mínimos sejam definidos automaticamente. Por vezes, o utilizador poderá desejar valores mínimos e máximos fixos. Nesse caso, poderá desactivar o modo do intervalo automático e definir os valores na janela de propriedades.

#### Multímetro

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.

#### Controlador do Processo

O Controlador de Processos dá-lhe uma lista dos processos no seu sistema. A lista poderá ser ordenada de acordo com qualquer coluna. Basta carregar com o botão esquerdo do rato no cabeçalho da coluna.

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

  O nome do executável que iniciou o processo.

PID

  O ID do Processo. É um número único para cada processo.

PPID

  O ID de processo do pai do processo.

UID

  O ID do utilizador que iniciou o processo.

GID

  O ID do grupo a que o utilizador pertence.

Estado

  O estado do processo.

% Utilizador

  A carga de processador do processo no espaço do utilizador (em percentagem).

% Sistema

  A carga de processador do processo no espaço do sistema (em percentagem).

'Nice'

  A prioridade do escalonamento.

TamVm

  A quantidade total de memória virtual usada pelo processo (em kBytes).

RssVm

  A quantidade total de memória física usada pelo processo (em kBytes).

Utilizador

  O nome do utilizador que iniciou o processo.

Comando

  O comando completo inicial do processo.

Por baixo da tabela irá encontrar quatro botões que serão descritos agora, da esquerda para a direita.

##### A Vista em Árvore

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.

##### O Filtro de Processos

O Filtro de Processos poderá ser usado para reduzir o número de processos mostrados na tabela. O utilizador poderá filtrar os processos nos quais não está interessado. De momento, poderá mostrar todos os processos, só os processos de sistema, só os processos de utilizador ou apenas os seus próprios processos.

##### O Botão Refrescar

Este botão poderá ser usado para forçar uma actualização automática da lista de processos.

##### O Botão Terminar

Se tiver seleccionado um ou mais processos, poderá carregar no botão de terminação para os matar. Será enviado um SIGKILL aos processos, o que faz com que estes terminem imediatamente. Se estas aplicação mantiverem à mesma os dados não gravados, estes serão perdidos. Por isso, utilize este botão com cuidado.

#### BarGraph

O gráfico de barras mostra os valores dos sensores como barras dançantes. Na janela de propriedades poderá especificar os valores máximo e mínimo do intervalo, assim como um limite inferior e um superior. Se esse valor for excedido, a área é colorida com a cor do alarme.

#### Registo dos Sensores

O registo dos sensores não mostra nenhuns valores, mas sim guarda-os num ficheiro com a informação adicional da data e hora. Para todos os sensores poderá especificar um limite inferior e superior na janela de propriedades. Se esse intervalo for excedido, o item da tabela de sensores é colorido com a cor do alarme e é então enviado um evento do knotify.

#### Ficheiro de Registo

O monitor do ficheiro de registo mostra o conteúdo de um ficheiro, como por exemplo o `/var/log/messages`. Na janela de propriedades poderá compor uma lista de expressões regulares, as quais serão comparadas com o conteúdo ficheiro. Se uma das expressões corresponder, será enviado um evento do knotify.

#### Vista em Lista

A lista mostra os dados de alguns dos sensores sob a forma de uma tabela.

## 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 jncp@netcabo.pt

&underFDL; &underGPL;