> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciador de Processos

> Mostra os programas que estão rodando no servidor, quanto de processador e de memória cada um usa, e encerra um processo ou todos os de um usuário.

**Caminho no painel:** menu da esquerda > **Status do Sistema** > **Gerenciador de
Processos**, no cartão **Processos**. O **Gerenciar** da linha **Processos**, no
cartão **Uso do servidor** do
[Painel de Controle](/keyhelp-admin/painel-de-controle), abre a mesma
tela.

![Alto da tela: as notas sobre CPU e memória, os botões Processos por usuário e Lista completa de processos, e os cartões Processos, Uso de CPU e Uso de memória](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/proc-resumo.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=9bc4bc3384eb9af48073ef48911fb19c)

As duas tabelas, **Processos por usuário** e **Lista completa de processos**, ficam
na mesma página, uma embaixo da outra. Os dois botões do alto descem a tela até
cada uma.

## O resumo

| Cartão | O que mostra |
| - | - |
| **Processos** | quantos processos há, e quantos em cada estado: **Executando**, **Ocioso**, **Adormecido**, **Parado** e **Zumbi** |
| **Uso de CPU** | o **Uso médio**, com a carga média de 1, 5 e 15 minutos entre parênteses, e o **Uso atual**, dividido entre **Por sistema** e **Por clientes**, os processos das contas de cliente |
| **Uso de memória** | a **Memória disponível** e o **Uso atual**, dividido do mesmo jeito |

**A Memória disponível é a memória total do servidor**, e não a que está livre.
Medido: *985,10 MB*, igual à memória total que o sistema informa.

**Os números são de um instante**, o da abertura da tela. Medido: o **Uso atual de
CPU** deu *69,80%* numa abertura e *4,60%* noutra. Na primeira, o próprio painel,
montando a tela, aparecia na lista com 68,40%.

**O uso de memória pode passar de 100%.** A tela explica o motivo: cada processo é
contado como se estivesse sozinho no servidor, e as bibliotecas que os processos
dividem entram várias vezes na soma. Medido: *101,31%*, 998,00 MB, com 985,10 MB de
memória no servidor. A tela avisa também que o uso de CPU leva em conta quantos
núcleos o processador tem.

## Processos por usuário

![Tabela Processos por usuário com os usuários dos serviços do servidor, a quantidade de processos, o uso de CPU e de memória e o Encerrar processos em cada linha, menos na do root](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/proc-usuarios.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=f8bfc5c2f408d3e8eea2a242b5910e91)

Uma linha por usuário do sistema que tem processo rodando: os dos serviços, como
`mysql` (o banco de dados), `postfix` e `dovecot` (o e-mail), `www-data` (o
servidor web) e `keyhelp` (o próprio painel), e as contas de cliente que estiverem
com algum programa rodando naquele instante.

| Coluna | O que é |
| - | - |
| **PROCESSOS** | quantos processos o usuário tem |
| **USO DE CPU** e **USO DE MEMÓRIA** | a soma dos processos dele, a memória em porcentagem e em tamanho |
| **TEMPO DE CPU ACUMULADO** | quanto tempo de processador os processos dele já gastaram |
| **AÇÕES** | **Encerrar processos**, em todas as linhas menos na do `root` |

## Lista completa de processos

Uma linha por processo. Medido: 185 processos neste servidor. A tabela é mais larga
que a tela, e rola para o lado.

| Coluna | O que é |
| - | - |
| **ID DO PROCESSO** | o número do processo no sistema |
| **NOME DE USUÁRIO** | o usuário dono do processo |
| **PRIORIDADE** e **NICE** | a prioridade que o sistema dá ao processo |
| **ESTADO** | o código do sistema e a palavra, como *Ss Adormecido* |
| **USO DE CPU**, **USO DE MEMÓRIA** e **TEMPO DE CPU ACUMULADO** | como na tabela por usuário, só deste processo |
| **COMANDO** | o programa e o que foi passado para ele |
| **AÇÕES** | **Encerrar processo**, em todas as linhas |

## Encerrar processos

![Janela Encerrar processo, com o ID do processo, o nome de usuário, o comando e os botões Ok e Cancelar](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/proc-encerrar.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=0f91028a466723dd154a9ade0a4b8182)

**Um processo:**

1. Em **Lista completa de processos**, na linha do processo, clique em **Encerrar processo**.
2. Na janela, confira o **ID do processo**, o **Nome de usuário** e o **Comando**.
3. Clique em **Ok**.

A tela responde *"O ID do processo #`<número>` foi eliminado."*

**Todos os processos de um usuário:**

1. Em **Processos por usuário**, na linha do usuário, clique em **Encerrar processos**.
2. A janela mostra o usuário e quantos processos ele tem. Clique em **Ok**.

A tela responde *"Os seguintes processos do usuário `<nome>` foram eliminados:"*,
com o número de cada um. O **Registro de Eventos**, em **Status do Sistema**, ganha
uma linha em inglês nos dois casos, como *"Process ID #`<número>` killed."*.

> [!WARNING]
>
> **O processo é encerrado à força, sem chance de terminar o que fazia**
>
> Medido com um programa de teste preparado para anotar o aviso de encerramento
> que os programas recebem normalmente: nos dois casos ele sumiu sem anotar nada.
> O painel não pede para o programa fechar; ele o derruba.

**Com o site da conta no ar, o site volta sozinho.** Medido encerrando os
processos de uma conta enquanto uma página PHP dela carregava: quem esperava a
página recebeu, no mesmo instante, o erro *"503 Service Unavailable"*. O PHP da
conta subiu de novo sem nenhuma ação, e o acesso seguinte abriu normalmente. O que
se perde é o trabalho que estava em andamento naquela hora.

> [!WARNING]
>
> **Dá para encerrar os processos dos serviços do servidor**
>
> **Encerrar processos** aparece em todos os usuários menos no `root`, inclusive
> `mysql`, `postfix`, `www-data` e `keyhelp`, o do próprio painel. **Encerrar
> processo** aparece em todos os processos da lista, inclusive os do `root`. A
> janela de confirmação é a única trava. Para reiniciar um serviço, o caminho é o
> [Gerenciamento de Serviços do Servidor](/keyhelp-admin/gerenciamento-de-servicos-do-servidor).

**Medido com o usuário `mysql`, o do banco de dados:**

* o banco caiu na hora, e a tela do painel trocou tudo por uma linha só: *"MySQL - Connection Error: Connection refused - 2002 (Connection refused)"*;
* o sistema subiu o banco sozinho seis segundos depois, e o painel voltou a abrir;
* o banco subiu fazendo a recuperação de uma queda, como depois de uma falta de energia, e terminou sem erro;
* **o Registro de Eventos ficou sem a linha desse encerramento**, porque o banco estava fora do ar quando o painel foi anotá-la.

O banco volta sozinho porque o sistema está configurado para subi-lo de novo
depois de uma queda. Nem todo serviço do servidor tem essa configuração.

**Medido com o usuário `postfix`, o do servidor de e-mail:**

* foram encerrados 5 processos, os auxiliares do Postfix que estavam no ar. O processo principal do Postfix não é desse usuário, e continuou rodando;
* o Postfix subiu os auxiliares de novo sozinho, mas aos poucos: o que recolhe as mensagens mandadas pelo próprio servidor, como as dos sites, voltou em 26 segundos, e **o que entrega voltou só 4 minutos e 25 segundos depois**. Nesse intervalo, as mensagens ficariam esperando na fila.

**O usuário `dovecot`, o da leitura de e-mail, não tinha processo** para encerrar no
momento: o processo principal do Dovecot é de outro usuário.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O uso de memória passa de 100%** | a memória que os processos dividem é contada em cada um | ler a linha **Memória** do cartão **Uso do servidor**, no Painel de Controle, com o livre, o usado e o total do servidor |
| **O painel aparece usando muita CPU** | a tela mede no instante em que o próprio painel trabalha para montá-la | abrir de novo |
| **A Memória disponível não bate com o que está livre** | ela é a memória total do servidor | ler a livre no Painel de Controle |
| **A linha do root não tem Encerrar processos** | a tela não oferece encerrar todos os processos do root | encerrar um processo por vez, na lista completa |
| **Um visitante viu o erro 503 logo depois de eu encerrar os processos de uma conta** | a página dele estava sendo montada naquele instante | nada: o acesso seguinte abre normalmente |
| **O painel mostra só "MySQL - Connection Error"** | os processos do usuário `mysql` foram encerrados, e o banco do painel caiu | esperar alguns segundos e abrir de novo: o sistema sobe o banco sozinho |
| **Encerrei os processos do `mysql` e o Registro de Eventos não mostra** | o banco estava fora do ar na hora de anotar | é o efeito do encerramento: a linha não é gravada |
| **Os e-mails demoram alguns minutos para sair depois de eu encerrar os processos do `postfix`** | o Postfix sobe de novo o processo que entrega só no acionamento seguinte, em até 5 minutos | esperar, ou reiniciar o Postfix pelo [Gerenciamento de Serviços do Servidor](/keyhelp-admin/gerenciamento-de-servicos-do-servidor) |

## Ver também

* [Gerenciamento de Serviços do Servidor](/keyhelp-admin/gerenciamento-de-servicos-do-servidor), o outro item deste cartão, para iniciar, parar e reiniciar os serviços
* [Painel de Controle](/keyhelp-admin/painel-de-controle), cujo cartão **Uso do servidor** leva a esta tela


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.