Documentação e exemplos
O que vigiar, e como.
O Holter vigia de duas formas. Heartbeats de entrada — suas tarefas fazem ping em nós quando terminam, e alertamos se um ping não chega. Verificações de saída — solicitamos sua URL, certificado, porta ou DNS de fora, seguindo um horário. Sem agente de servidor, sem acesso aos seus servidores. E no Business, dependências — vigiamos as páginas de status dos fornecedores dos quais você depende, para você saber das quedas deles primeiro.
Heartbeats de entrada
Um dead-man switch: faça ping em nós quando tiver sucesso, e alertamos se ele ficar em silêncio. Ótimo para backups, workers de fila, crons, pipelines e webhooks.
1 · Crie seu heartbeat de entrada
Como o Holter vigia
Nome
Alertar se não houver ping em
Sua URL de ping
O Holter gera isso — copie do painel.
2 · Depois faça curl a partir da sua tarefa
# success — at the end of the job
pg_dump … | gzip | aws s3 cp - s3://… \
&& curl -fsS "$HOLTER_URL"
# failure — alert right away
curl -fsS "$HOLTER_URL/fail"
Perdeu a janela e o Holter abre um incidente e alerta seus canais. Mesmo padrão para workers de fila (ping a cada poucos minutos) e crons (anexe o curl no final da linha).
Prefere e-mail? Mude o heartbeat para um endereço único (…@in.holter.sh) e faça seu app enviar para ele seguindo um horário. Se seu envio de e-mail parar, o Holter te avisa — ele vigia todo o pipeline de envio, não só seu código.
Verificações de saída
Alcançamos seu serviço pela internet pública seguindo um horário — nada para instalar. Ótimo para uptime, saúde da API, SSL, domínio, DNS e TCP.
Crie uma verificação de saída
Como o Holter vigia
O que verificar
Endpoint
Status saudável
Alertar se mais lento que
O que ele detecta
- ● Fora do ar, ou código de status errado
- ● No ar mas lento, além do seu orçamento de latência (degradado)
- ● Recuperado — com a duração da queda
Mude O que verificar para SSL, Domínio, DNS ou Redirecionamento — mesma tela, só uma URL, sem campos extras. Verificações de certificado e domínio te avisam dias antes do vencimento.
Dica: dentro do Holter, "O que vigiar" configura qualquer um destes para você com um clique.
Vigie do que você depende Business
Algumas quedas não são suas. Quando a Stripe, a AWS, seu provedor de autenticação ou de banco de dados tem um incidente, seu app sente — e seus clientes te culpam. Adicione esses fornecedores como dependências e o Holter vigia as páginas de status públicas deles, para você saber primeiro por um alerta.
Adicione uma dependência
Fornecedor
URL da página de status
Ou escolha entre 24 fornecedores populares que já sabemos ler.
O que depende disso?
Me alerte
O que ele detecta
- ● Um fornecedor — ou um dos seus componentes — reporta serviço degradado
- ● Um fornecedor reporta uma queda total — alertado aos seus canais
- ● Recuperado — o incidente upstream foi resolvido
O Holter lê a própria página de status publicada de cada fornecedor a cada poucos minutos — ele não sonda os sistemas deles. Funciona com qualquer página que tenha um feed de status público (a maioria dos SaaS), com suporte nativo para AWS, Google Cloud e Azure.
Opcionalmente, liste as dependências escolhidas na sua própria página de status como "Serviços upstream".
Selos de status
Toda página de status pública oferece um selo SVG incorporável — um retrato ao vivo do seu status ou uptime que você pode colocar em um README, wiki ou no seu próprio site. Sem chave de API, e ele se atualiza sozinho.
Pegue o trecho
URL do selo
Markdown
Variante de uptime
Exemplo ao vivo
- ✓ Atualiza sozinho — reflete seu status real em menos de um minuto
- ✓ Público e autossuficiente — aparece onde uma imagem aparece
Configure com seu agente de código (MCP)
Em vez de preencher os formulários acima manualmente, deixe seu agente fazer a primeira passada. O Holter roda um servidor MCP — conecte o Claude Code, o Cursor, ou qualquer agente compatível com MCP com um token com escopo de equipe, e ele lê seu repositório localmente, propõe os monitores que encontra (crons, filas, verificações de saúde, domínios), e escreve o código de heartbeat para você revisar.
1 · Adicione o servidor MCP
{
"mcpServers": {
"holter": {
"type": "http",
"url": "https://app.holter.sh/api/mcp",
"headers": { "Authorization": "Bearer ${HOLTER_TOKEN}" }
}
}
}
Pegue um token com escopo de equipe em Configurações → MCP e defina-o como HOLTER_TOKEN. O token é a única coisa que o agente precisa — ele é limitado à sua equipe Holter e não leva acesso ao seu código, servidores ou nuvem.
2 · Depois é só perguntar
"Set up Holter monitoring for this repo —
read holter.sh/use and follow it."
- ✓ Ele lê seu código-base localmente — o Holter nunca recebe seu código-fonte
- ✓ Ele propõe os monitores e o código de heartbeat; você revisa e aplica cada mudança
- ✓ Ele funciona através do token, nunca com suas chaves — ele não pode tocar seus sistemas
Checklist de monitoramento em produção
Cada linha leva 3 minutos para configurar — ou um toque em "O que vigiar" dentro do app.
-
Página inicial / app principal responde
Verificação HTTP de saída, esperando 200
-
Endpoint de API ou de saúde responde
Verificação HTTP de saída em /health, opcionalmente conferindo uma string no corpo
-
Tempo de resposta dentro do orçamento
Adicione um orçamento de latência "alertar se mais lento que"
-
HTTP redireciona para HTTPS
Verificação de redirecionamento de saída
-
Certificado TLS não está perto de vencer
Verificação SSL de saída
-
Domínio não está prestes a expirar
Verificação de domínio de saída (RDAP)
-
DNS ainda resolve
Verificação DNS de saída
-
Backup noturno concluído
Heartbeat de entrada do script de backup
-
Workers de fila ativos e esvaziando
Heartbeat de entrada de um ping agendado do worker
-
Jobs agendados / crons rodaram
Heartbeat de entrada ao final de cada cron
-
Pipelines críticos (ETL, ciclos de cobrança)
Heartbeat de entrada em caso de sucesso, /fail em caso de erro
-
E-mail transacional ainda está sendo enviado
Monitor de e-mail de entrada — seu app envia e-mail para um endereço único seguindo um horário
-
Porta de banco de dados / cache acessível
Verificação TCP de saída (host:porta público)
-
Webhooks de terceiros ainda disparam
Heartbeat de entrada do seu manipulador de webhook
-
Página de status publicada
Ative uma para que os clientes se autoatendam durante incidentes
-
Status do provedor de pagamento
Adicione a Stripe (ou seu processador) como dependência
-
Status do provedor de nuvem / hospedagem
Adicione AWS, GCP, Azure, Vercel… como dependência
-
APIs críticas de terceiros
Adicione OpenAI, Twilio, SendGrid… tudo que seus fluxos essenciais precisam
Comece com uma verificação.
Grátis para 5 monitores, sem cartão. Vá marcando o resto da lista aos poucos.
Comece a monitorar grátis