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

# Registro de Eventos

> Lista o que aconteceu no painel e no servidor: entradas no painel, mudanças feitas por administradores e clientes, tarefas de manutenção e os erros que elas encontraram. Cada…

**Caminho no painel:** menu da esquerda > **Status do Sistema** > **Registro de
Eventos**, no cartão **Painel de Controle**

![Tela Registro de Eventos: o botão Opções, a barra de busca com Visualização personalizada e a lista de eventos, a mais nova em cima](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/eventos-lista.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=2272e9613efe31d9102c9f7eebaabab0)

**As mensagens são em inglês**, mesmo com o painel em português. A lista vem com o
evento mais novo em cima, 50 por página, e o rodapé diz quantos estão na página e
quantos há no total.

## As colunas

| Coluna | O que é |
| - | - |
| **DATA** | o dia e a hora do evento |
| **NÍVEL** | a gravidade, na tabela logo abaixo |
| **MENSAGEM** | o que aconteceu. As mensagens longas, como um erro de configuração do Apache, ocupam várias linhas |
| **USUÁRIO** | quem fez. Quando é um cliente, o nome é link e **entra na conta dele**. Nas tarefas de manutenção e nas chamadas da API, fica vazio |
| **IP** | de onde veio o pedido. É link para a [Pesquisa de IP Whois](/keyhelp-admin/pesquisa-de-ip-whois), que abre numa janela. As tarefas de manutenção aparecem com `127.0.0.1`, o próprio servidor |
| **CANAL** | por onde o evento entrou: **User Interface** (as telas do painel), **API**, ou **Maintenance** com o nome da tarefa entre parênteses |

**O nome entre parênteses do canal é o do arquivo da tarefa** em
[Registros](/keyhelp-admin/registros): *Maintenance (update)* é a tarefa **Processar tarefas**,
cujo detalhe está no `update.log`; *Maintenance (avscan)*, a verificação de vírus,
no `avscan.log`.

### Os níveis

| Nível | Cor do ponto | Exemplos medidos neste servidor |
| - | - | - |
| **Depurar** | escuro | *"Event log IPs anonymized."*, e cada e-mail de aviso enviado. **Fica escondido de fábrica** |
| **Informação** | azul | *"User ... logged in."*, *"Client account ... updated."* |
| **Notificação** | azul | *"Notification settings updated."*, *"Webmail settings updated."* |
| **Aviso** | laranja | *"Server reboot requested."*, *"Firewall backup restored after admin has been locked out from server."* |
| **Erro** | vermelho | *"Error occurred while adding system user ..."*, *"Failed to aquire a Let's Encrypt certificate for ..."* |
| **Alerta**, **Crítico** e **Emergência** | vermelho | *"Web server (Apache) reported syntax errors."*, *"Mail Delivery Agent (Dovecot) reported syntax errors."*, os dois **Crítico** |

## Mostrar os eventos de depuração

![Balão Mostrar níveis do registro, com as oito caixas, Depurar desmarcada, e o botão Salvar](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/eventos-niveis.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=108ac83e2389d35ff3b7425bc9cce15a)

1. Na barra **Opções de visualização**, clique em **Visualização personalizada**.
2. No balão **Mostrar níveis do registro**, marque ou desmarque os níveis.
3. Clique em **Salvar**.

**Medido:** com **Depurar** desmarcado, como vem, a tela mostrava 1.465 eventos;
marcado, 1.584, que é o total guardado. Os 119 de diferença eram os de nível
Depurar. A escolha fica guardada na sessão, até sair do painel.

## Buscar

* Na barra **Opções de visualização**, escolha onde procurar, digite o termo e
  clique em **Busca**.

O seletor oferece **Todos os campos**, **Data**, **Mensagem**, **Usuário**, **IP**
e **Canal**. Medido: *logged in* em **Mensagem** trouxe 237 eventos, o mesmo número
do banco do painel.

**A busca continua valendo depois que você sai da tela**, como na
[Administração do Usuário](/keyhelp-admin/administracao-do-usuario).
Para ver tudo de novo, apague o campo e clique em **Busca**.

## Ordenar

* Clique no título de uma coluna.

No **NÍVEL**, o primeiro clique põe os menos graves em cima, e o segundo põe os
mais graves: medido, os **Crítico** subiram para o começo da lista. Na **DATA**, o
primeiro clique põe o mais antigo em cima, e o segundo volta ao mais novo. A ordem
fica guardada na sessão.

## Opções: IPs anônimos e quanto tempo os eventos ficam

![Janela Opções: Tornar endereços IP anônimos ativado, e a Rotação do registro com as três escolhas](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/eventos-opcoes.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=7310ef270c8dd9247dac71b0d2b41970)

1. No canto superior direito, clique em **Opções**.
2. Ajuste os campos da tabela abaixo.
3. Clique em **Salvar**.

| Campo | Neste servidor | O que faz |
| - | - | - |
| **Tornar endereços IP anônimos** | **Ativado** | a tela diz: *"Esta configuração faz com que os endereços IP se tornem anônimos após 14 dias."* Medido: nos eventos de mais de 14 dias, **o último número do IP vira `0`**. A troca acontece uma vez por dia, à meia-noite: às 16h do dia 2, os eventos da manhã de 14 dias antes ainda tinham o IP inteiro |
| **Rotação do registro** | a primeira escolha, *"Mantenha apenas os registros com menos de XX dias"*, com **120** | quais eventos o painel apaga. O `XX` do rótulo é o número do campo logo abaixo. As outras escolhas são **Manter no máximo XX registros** (com **30000** no campo) e **Não deletar os registros** |

O painel responde *"As configurações foram atualizadas."*, e o próprio Registro de
Eventos ganha *"Event log settings updated."*. A rotação e a anonimização rodam
todo dia à meia-noite, e cada uma deixa um evento de nível **Depurar**: *"Event log
rotation performed."* e *"Event log IPs anonymized."*.

**Estas opções valem só para esta lista.** Os registros de acesso dos sites e do
painel têm a própria anonimização, em
[Política de Dados](/keyhelp-admin/politica-de-dados).

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Um evento que devia estar ali não aparece** | ele é de nível **Depurar**, escondido de fábrica, ou uma busca antiga ainda vale | marcar **Depurar** em **Visualização personalizada**, e apagar o campo de busca |
| **Erro** *"Error occurred while adding system user ..."* | o painel não terminou de criar a conta no servidor | ver [Administração do Usuário](/keyhelp-admin/administracao-do-usuario) |
| **Erro** *"Failed to aquire a Let's Encrypt certificate for ..."* | o domínio não aponta para este servidor | ver [Editar um domínio](/keyhelp-admin/editar-dominio) |
| **Crítico** *"Web server (Apache) reported syntax errors."* | o Apache recusou uma configuração nova. A mensagem diz o arquivo e a linha | ver [Servidor Web](/keyhelp-admin/servidor-web) |
| **Crítico** *"Mail Delivery Agent (Dovecot) reported syntax errors."* | o servidor de e-mail recusou uma configuração nova | ver [Servidor de E-mail](/keyhelp-admin/servidor-de-email) |
| **Aviso** *"Firewall backup restored after admin has been locked out from server."* | uma regra nova do firewall trancou o administrador fora, e o painel voltou às regras anteriores | ver [Mudar as regras do firewall](/keyhelp-admin/mudar-as-regras-do-firewall) |
| **O IP de um evento antigo termina em `0`** | a anonimização depois de 14 dias | é o comportamento da opção **Tornar endereços IP anônimos** |
| **Eventos antigos com a hora adiantada ou atrasada** | foram gravados com outro fuso horário | ver [Hora do Sistema](/keyhelp-admin/hora-do-sistema) |

## Ver também

* [Registros](/keyhelp-admin/registros), os arquivos de registro de cada tarefa de manutenção, com o detalhe que a mensagem do evento resume
* [Pesquisa de IP Whois](/keyhelp-admin/pesquisa-de-ip-whois), que abre ao clicar num IP
* [Política de Dados](/keyhelp-admin/politica-de-dados), a anonimização dos registros dos sites e do painel
* [Sessões Ativas](/keyhelp-admin/sessoes-ativas), quem está conectado agora


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