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.

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

Markdown

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.

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

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

De onde vem cada dado

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
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 e exemplos em /mcp/vps.