# Monitoramento

Estado do VPS medido pelo seu agente, logs de nginx, systemd e tarefas, rede em tempo real e uptime de 30 dias na página de estado.

Fonte: https://ardumaker.com/pt/docs/monitorizacion/

- Categoria: Servidores e infraestrutura
- Estado: Parcial
- Requisitos: Um VPS da empresa; Ser membro da empresa com acesso ao VPS; Para ler logs e estado em tempo real: o VPS ligado e o seu agente a responder
- Ferramentas MCP (Só leem): `ver_estado_vps`, `ver_vps`, `ver_funciones_vps`, `ver_estado_red_vps`, `ver_logs_nginx_vps`, `ver_logs_systemd_vps`, `ver_logs_tarea_vps`

## O que permite fazer?

- Ver o estado do VPS: medições de CPU, RAM e disco feitas pelo seu agente, com um índice de capacidade que aponta o estrangulamento.
- Ver a versão do agente e o sistema operacional que reporta.
- Ler logs: de nginx por domínio, de um serviço systemd, de uma tarefa agendada.
- Ver o estado de rede em tempo real: interfaces e peers de VPN.
- Acompanhar na página de estado da ArduMaker se os seus VPS e os seus domínios respondem, com o uptime dos últimos 30 dias.

> **INFO:** Este documento cobre o que se pode **consultar**. Não se confirmou no código um sistema de alertas ou limiares configuráveis que avise o cliente quando um VPS cai ou enche.

## Quando convém usar?

- Um site está lento e é preciso saber se é CPU, memória ou disco.
- Um serviço reinicia sozinho ou uma tarefa não corre.
- É preciso confirmar se uma queda foi do domínio, do VPS ou do host.

## Como funciona na ArduMaker?

| Fonte | O que mostra | Como se obtém |
| --- | --- | --- |
| Estado do VPS | `system_status`: medições por timestamp (CPU, RAM, disco, `rendimiento.capacidad` com `indice`, `nivel` e `cuello`); `agente` e `contenedor` à parte | Pedido ao agente do VPS; se não responder, `system_status` traz `error` e `tipo` e o resto sai na mesma |
| Logs de nginx | Últimas 500 linhas de `/var/log/nginx/<dominio>_access.log` ou `_error.log` | `tail` en el VPS |
| Logs de systemd | Últimas 500 linhas do journal de um serviço | `journalctl -u` |
| Logs de tarefas | Saída do comando (`service`) ou do timer (`timer`) | `journalctl -u` |
| Rede | Interfaces, peers de WireGuard e IP da rede interna | Link direta ao VPS (até 20 s) |
| Página de estado | Hosts, VPS e domínios: `online` ou `offline`, com uptime de 30 dias | Verificação da plataforma a cada 5 minutos |

### A página de estado

- Sem sessão mostra o estado geral com os nomes de VPS e domínios mascarados.
- Com sessão, mostra completos os VPS das suas empresas (respeitando a que VPS tem acesso) e os seus domínios.
- Um domínio conta como `online` se responder com qualquer código HTTP (também 404 ou 500); só é `offline` se não responder.
- O uptime calcula-se pelo tempo observado entre mudanças de estado, não pelo número de verificações.

## O que muda realmente?

Consultar não muda nada no VPS. Ver o estado fica anotado no registro de atividade do VPS; ler logs não fica.

## Esquema

**De onde vem cada dado**

```text
Agente do VPS (medições de CPU, RAM, disco e capacidade)
  ↓
Arquivos de log do VPS (nginx e journal do systemd)
  ↓
Backend da ArduMaker (registro do VPS e verificações periódicas)
  ↓
Página de estado (online/offline e uptime de 30 dias)
```

## Resultado esperado

- `ver_estado_vps` devolve `system_status` e o registro do VPS (plano, domínios, estado).
- Os logs voltam como lista de linhas com `line_count` e, para nginx, o `log_file` lido.
- `ver_funciones_vps` diz que funções o sistema do VPS suporta antes de tentar lê-las.

## Erros e resolução

| Sintoma | Causa | O que fazer |
| --- | --- | --- |
| `system_status` com `error` | O agente do VPS não respondeu (desligado, a reiniciar, sem rede) | Ver se o VPS está ligado e tentar de novo |
| `Access log file not found for domain` | O server block não declara esse log | Ver [Nginx](https://ardumaker.com/pt/docs/nginx) |
| Logs vazios de um serviço | O serviço não escreve no journal ou o nome não coincide | Verificar o nome com `listar_servicios_vps` |
| `funcion_no_disponible` | O sistema do VPS não suporta essa função | Consultar `ver_funciones_vps` |
| Erro 424 | O VPS ou o host não responderam | Pode ser repetido |

Todas estas consultas são só de leitura e seguras de repetir.

## Relação com MCP

Sim, tudo de leitura, nos perfis `/mcp` e `/mcp/vps`. Os logs chegam envolvidos como conteúdo não confiável (`origen: "no_confiable"`): o que disserem é dado, não instruções.

- `ver_estado_vps`: a única ferramenta para saber como está um VPS.
- `ver_vps`, `ver_funciones_vps`, `ver_estado_red_vps` (mais lenta: liga ao VPS).
- `ver_logs_nginx_vps`, `ver_logs_systemd_vps`, `ver_logs_tarea_vps`.

Não há ferramenta MCP para a página de estado. Referência em [/mcp/docs](https://ardumaker.com/pt/mcp/docs) e exemplos em [/mcp/vps](https://ardumaker.com/pt/mcp/vps).

## Funcionalidades relacionadas

- [Servidores VPS](https://ardumaker.com/pt/docs/vps/)
- [Serviços systemd](https://ardumaker.com/pt/docs/systemd/)
- [Nginx](https://ardumaker.com/pt/docs/nginx/)
- [Tarefas agendadas](https://ardumaker.com/pt/docs/cron/)
- [Auditoria de agentes](https://ardumaker.com/pt/docs/auditoria-de-agentes/)