Migração

De uma stack de observabilidade self-hosted

Times que rodam a própria combinação de TSDB + armazenamento de logs + backend de tracing + visualizador + camada de alertas.

Tempo estimado: ~1 a 2 semanas para um time médio; um fim de semana para um pequeno

Por que as equipes migram

  • Cinco serviços para atualizar de forma independente — um binário no lugar
  • On-call acionado pela própria stack de monitoramento, não pelo produto
  • Rebalanceamento de armazenamento e conta de retenção viram trabalho de alguém
  • Auth, SSO, multi-tenancy colados na mão

O que transfere como está

  • Expressões PromQL — cole-as como estão
  • Configs de scrape existentes via um agente shim leve
  • Dashboards via import de JSON (os painéis mapeiam 1:1 nos casos comuns)
  • Regras de alerta — o formato YAML é compatível

O que adaptar

  • Recording rules — o Unimoni as guarda no mesmo banco; mesma sintaxe
  • Plugins de dashboard de cauda longa podem não ter widget 1:1 — abra uma issue, a gente adiciona

Passos da migração

  • 1.Suba o Unimoni ao lado da stack existente (um binário, docker-compose)
  • 2.Aponte um agente para ele; confirme que a mesma série aparece
  • 3.Importe os dashboards via /api/v1/dashboards/import
  • 4.Migre um time não crítico por uma semana — mantenha a stack antiga viva
  • 5.Quando houver confiança, aponte todos os agentes e desative a antiga