📊 Monitoramento e logs

Logs dispersos em containers individuais são inúteis em pânico. Quando o site cai às 2h da manhã, você quer abrir UMA tela e buscar por "error" nos últimos 15 minutos — não rodar docker logs em 6 containers diferentes.

Duas opções pragmáticas: Loki + Grafana (self-hosted, dá mais trabalho mas tudo seu) ou Better Stack / Logtail (SaaS, 1GB/mês grátis, configura em 5 min). Para um VPS pequeno, comece pelo SaaS.

# Loki via Docker (stack mínimo)
# docker-compose.loki.yml
services:
  loki:
    image: grafana/loki:2.9.0
    ports: ["3100:3100"]
    volumes:
      - loki-data:/loki
    command: -config.file=/etc/loki/local-config.yaml

  promtail:
    image: grafana/promtail:2.9.0
    volumes:
      - /var/log:/var/log
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
      - ./promtail-config.yml:/etc/promtail/config.yml
    command: -config.file=/etc/promtail/config.yml

volumes:
  loki-data:

Conceitos-chave

Se o seu site cai e você descobre pelo cliente, falhou. Um uptime monitor externo bate em endpoints HTTP a cada N minutos e te avisa no segundo em que parar de responder. O UptimeRobot oferece 50 monitores grátis com check de 5 em 5 minutos.

Conceitos-chave

Logs respondem "o que aconteceu". Métricas respondem "qual a tendência". CPU subiu 30% na última hora? Memória crescendo lentamente desde ontem? Sem métricas você só percebe quando trava. O combo Prometheus (coleta + storage) + Grafana (dashboard) é padrão de mercado.

# docker-compose.monitoring.yml
services:
  prometheus:
    image: prom/prometheus:latest
    ports: ["9090:9090"]
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prom-data:/prometheus
    command:
      - '--storage.tsdb.retention.time=30d'
      - '--config.file=/etc/prometheus/prometheus.yml'

  node-exporter:
    image: prom/node-exporter:latest
    ports: ["9100:9100"]
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro

  grafana:
    image: grafana/grafana:latest
    ports: ["3001:3000"]
    environment:
      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_PASSWORD}
    volumes:
      - grafana-data:/var/lib/grafana

volumes:
  prom-data:
  grafana-data:

# prometheus.yml — scrape config mínimo
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'node'
    static_configs:
      - targets: ['node-exporter:9100']

  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

Conceitos-chave

Métricas que ninguém olha não previnem incidente. Configure Alertmanager (companheiro do Prometheus) para disparar quando CPU passa de 90% por 5 min, disco passa de 85% ou um serviço some. Telegram é o canal mais rápido para alertas pessoais — webhook em 30s.

# alertmanager.yml
route:
  receiver: 'telegram'
  group_wait: 30s
  group_interval: 5m
  repeat_interval: 4h

receivers:
  - name: 'telegram'
    telegram_configs:
      - bot_token: ${TG_BOT_TOKEN}
        chat_id: ${TG_CHAT_ID}
        parse_mode: 'HTML'

# rules.yml — regras de alerta
groups:
  - name: host
    rules:
      - alert: HighCPU
        expr: 100 - (avg(rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100) > 90
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "CPU acima de 90% por 5min"

      - alert: DiskFull
        expr: node_filesystem_avail_bytes / node_filesystem_size_bytes < 0.15
        for: 10m
        labels:
          severity: critical
        annotations:
          summary: "Disco com menos de 15% livre"

Conceitos-chave

Logs e métricas mostram sintomas de infra. Sentry mostra exceções da aplicação com stack trace completo, contexto do request, breadcrumbs e quantos usuários foram afetados. Plano grátis: 5k erros/mês — sobra para projeto pequeno.

# Setup em app Node/Next (3 linhas no entry point)
import * as Sentry from "@sentry/node";

Sentry.init({
  dsn: process.env.SENTRY_DSN,
  environment: process.env.NODE_ENV,
  release: process.env.GIT_SHA,
  tracesSampleRate: 0.1,  // 10% das requests viram traces
});

# .env
SENTRY_DSN=https://abc123@o12345.ingest.sentry.io/678
GIT_SHA=$(git rev-parse --short HEAD)

Conceitos-chave

Quando algo cai, clientes ligando perguntando "tá fora?" custa mais tempo que o próprio incidente. Uma status page pública resolve: a pessoa abre, vê "Incidente em andamento desde 14:32", e te deixa trabalhar. Uptime Kuma é self-hosted, grátis e bonito.

# Uptime Kuma em 1 comando
docker run -d \
  --name uptime-kuma \
  --restart unless-stopped \
  -p 3002:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:1

# Acessar em http://servidor:3002
# 1. Criar conta admin
# 2. Adicionar monitores (HTTP, ping, port, DNS, Docker, push)
# 3. Settings > Status Pages > criar pública
# 4. Apontar status.seu-dominio.com via Nginx ou Caddy

Conceitos-chave