# O Manual do &ksysguard;

## Introdução

O &ksysguard; é o Gestor de Tarefas do &kde; e o Monitor da Performance. 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

O &ksysguard; pode ser iniciado a partir do menu inicial usando a opção Vigilante do Sistema do KDE no menu Sistema. Em alternativa, podê-lo-á iniciar escrevendo `ksysguard` num 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. Quando o inicia da primeira vez, o utilizador verá a sua máquina local como localhost na janela de sensores, assim como 2 páginas no espaço de trabalho. Esta é a configuração predefinida.

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

Para se ligar a uma nova máquina use a opção Ligar às Máquinas no menu Ficheiro. Irá aparecer uma janela que lhe permite indicar o nome da máquina à qual se quer ligar. Por baixo do nome poderá escolher o método de ligação. Por omissão é usado o método por ssh, a linha de comandos segura. Em alternativa poderá ser usado o modo do rsh, a linha de comandos remota ou mesmo o modo do servidor para estabelecer a ligação. Ao fim de algum tempo irá aparecer a nova máquina na lista de sensores para poder navegar nessa lista de sensores.

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

- O utilizador pode iniciar o ksysguardd na alturaa do arranque no modo de Servidor ao adicionar o parâmetro `-d` como argumento. Neste caso, terá de seleccionar o modo de servidor na janela de ligações do ksysguard. Uma desvantagem deste tipo de ligação é que o utilizador não será capaz de matar ou mudar a prioridade de um processo com o Controlador de Processos e, para além disso, a troca de dados não será cifrada.

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 directorias, o utilizador terá de criar ou actualizar um ficheiro na sua directoria pessoal. Esse ficheiro chama-se `environment` e necessita estar numa directoria 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. 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. Se escolher a opção do comando personalizado na ligação à máquina terá de especificar o comando completo para iniciar o 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

O espaço de trabalho está organizado em folhas de trabalho. Seleccione a opção Nova no menu Ficheiro para criar uma nova folha de trabalho. Irá aparecer uma janela onde poderá definir o nome, o tamanho e o intervalo de actualização da folha de trabalho. Para remover de novo uma folha de trabalho, seleccione o Fechar no menu Ficheiro. Todas as modificações serão gravadas no ficheiro da folha de trabalho. Se uma folha de trabalho não foi nunca gravada, ser-lhe-á pedido o nome de um ficheiro. As folhas de trabalho consistem em células organizadas numa grelha.

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.

As folhas de trabalho poderão ser configuradas ao carregar em Configurar a Folha de Trabalho no menu Editar. Na janela de aparência poderá definir o tamanho e o intervalo de actualização. Ester intervalo é usado por todas as áreas de visualização da folha de trabalho, a qual tem o intervalo de actualização da actualização da folha de trabalho definida na janela de configuração da temporização.

A opção Configurar o Estilo do menu Configuração menu gives you the possibility to configure the global style attributes and apply them to the current active worksheet.

As visualizações poderão se configuradas ao carregar com o botão direito do rato nelas. Aparecerá um menu onde o utilizador poderá seleccionar se quer alterar as propriedades dessa área, removê-la da folha de trabalho, alterar o seu intervalo de actualização, pausar ou reiniciar a sua actualização.

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

## Créditos e Licenças

O &ksysguard; está a ser desenvolvido e mantido pelo Chris Schläger cs@kde.org. 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>

&underFDL; &underGPL;

## Instalação

### Como obter o &ksysguard;

&install.intro.documentation;

### Requisitos

Para poder compilar com sucesso o &ksysguard;, irá necessitar do &kde; 2.0 e do Qt 2.2.x. Todas as bibliotecas necessárias, assim como o próprio &ksysguard; poderão ser obtidos em ftp://ftp.kde.org/pub/kde/.

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' 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;

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

### Compilação e Instalação

&install.compile.documentation;