Logs, terminal e métricas no Coolify

Resposta rápida

No Coolify, os Deployment Logs mostram o build e a troca de contêiner, e os Runtime Logs mostram o que a aplicação escreve enquanto roda. O Terminal abre um console dentro do contêiner, pelo navegador, para quem é Owner ou Admin. O Healthcheck diz ao Coolify como saber se a aplicação está saudável, e Resource Limits limita CPU e memória. As métricas de CPU e memória do servidor vêm desligadas: ligue em Metrics com Enable Metrics.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

Diferenciar os logs do deploy dos logs da aplicação rodando
Abrir o terminal web dentro do contêiner da aplicação
Ligar o healthcheck sem derrubar a aplicação
Limitar CPU e memória de uma aplicação
Ligar as métricas do servidor

Antes de começar

Uma aplicação publicada no Coolify (publicar pelo Git)
Conta Owner ou Admin no time, para usar o terminal web

Neste guia

Onde olhar quando algo dá errado
Leia os logs da aplicação
Use o terminal web
Ligue o healthcheck
Limite CPU e memória
Ligue as métricas do servidor
Problemas comuns

Onde olhar quando algo dá errado

Cada ferramenta responde a uma pergunta
Menu	O que mostra	Quando usar
Deployment Logs	O build, o download da imagem e a troca de contêiner	O deploy falhou ou demorou
Runtime Logs	O que a aplicação escreve enquanto roda	A aplicação está no ar, mas dá erro
Terminal	Um console dentro do contêiner	Conferir arquivos, versões e conexões por dentro
Metrics	CPU e memória ao longo do tempo	A VPS fica lenta ou a memória acaba

Leia os logs da aplicação

Abra Runtime Logs
No painel: site-da-lojaRuntime Logs(a sua aplicação › Logs em execução)
A página mostra as últimas linhas que a aplicação escreveu, como a mensagem de que o servidor subiu. Use Find in logs (buscar nos logs), escolha quantas linhas ver em Lines e baixe com Export.

Use o terminal web

Abra o terminal da aplicação
No painel: site-da-lojaTerminal(a sua aplicação › Terminal)
O terminal abre dentro do contêiner, na pasta da aplicação. Digite comandos como num SSH, sem sair do navegador.

node --version && ls

O comando da foto: a versão do Node.js no contêiner e os arquivos da aplicação.

Quem pode abrir o terminal

Só Owner e Admin do time abrem o terminal. Com o painel acessado pelo IP, ele usa a porta 6002. Com o painel no domínio, passa pelo HTTPS do painel. Mudanças feitas no contêiner somem no próximo deploy: o que precisa ficar vai para o código ou para um volume.

Ligue o healthcheck

Configure o endereço e clique em Enable
No painel: site-da-lojaHealthcheck(a sua aplicação › Verificação de saúde)
Sem healthcheck, o status mostra Running (no healthcheck). Informe em Port a porta da aplicação e em Path um endereço que responda 200, clique em Enable (ligar) e faça Redeploy.
1. Botão Enable, que liga o healthcheck.
2. Path: o caminho consultado, como / ou /health.

A imagem precisa ter curl ou wget

O healthcheck roda dentro do contêiner, com curl ou wget. Se a imagem não tem nenhum dos dois, ou se o caminho e a porta estão errados, a aplicação fica como não saudável e o domínio pode responder 404 ou No available server.

Limite CPU e memória

Defina os limites e faça Redeploy
No painel: site-da-lojaResource Limits(a sua aplicação › Limites de recursos)
Os limites evitam que uma aplicação tome a VPS inteira quando várias dividem o mesmo servidor. O valor 0 é sem limite; depois de salvar, faça Redeploy.
1. CPU limit: quantos núcleos a aplicação pode usar, como 1.
2. Memory limit: o máximo de memória, como 512m. As unidades aceitas são b, k, m e g.

Ligue as métricas do servidor

Confira o Sentinel
No painel: ServerslocalhostSentinel(Servidores › a sua VPS › Sentinel)
O Sentinel é o agente que coleta a saúde do servidor e já vem ligado. In sync (sincronizado) indica que ele está conversando com o painel.
Clique em Enable Metrics
No painel: ServerslocalhostMetrics(Servidores › a sua VPS › Métricas)
As métricas vêm desligadas (Metrics are disabled). Clique em Enable Metrics (ligar métricas) para começar a guardar o histórico de CPU e memória.

O histórico fica guardado por 7 dias. Os gráficos mostram o servidor, as aplicações e os bancos; serviços do catálogo e aplicações com Docker Compose não têm gráfico próprio.

Como saber se deu certo

Você lê os logs do deploy e da aplicação, abre o terminal no contêiner, a aplicação passa a mostrar se está saudável e o servidor guarda o histórico de CPU e memória.

Problemas comuns

O terminal web não conecta

Causa provável: A conta é Member, que não abre terminal, ou o painel é acessado pelo IP com a porta 6002 fechada no firewall.
O que fazer: Use uma conta Owner ou Admin. Libere a porta 6002 enquanto usa o painel pelo IP, ou ponha o painel no domínio com HTTPS.

Depois de ligar o healthcheck, o domínio responde No available server

Causa provável: A imagem não tem curl nem wget, ou a porta e o caminho do healthcheck estão errados.
O que fazer: Confira Port e Path, teste o caminho no terminal do contêiner e, se faltar a ferramenta, inclua curl ou wget na imagem.

A aplicação reinicia sozinha depois de definir o limite de memória

Causa provável: O limite ficou abaixo do que a aplicação usa. O Docker encerra o contêiner que passa do limite.
O que fazer: Aumente o Memory limit com base nas métricas e faça Redeploy.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoVolumes e tarefas agendadas no CoolifyPersistent storage para os dados que precisam sobreviver ao deploy e Scheduled tasks para rodar comandos na hora marcada, dentro do contêiner.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para Coolify Conhecer o VPS Assistido