Pular para o conteúdo

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

New monitor preview

Como o Holter vigia

Enviar um evento ao Holter O Holter verifica o endpoint

Nome

Backup noturno do BD

Alertar se não houver ping em

1 dia

Sua URL de ping

https://holter.sh/e/abc…/nightly-db-backup-x7k2qa

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

New monitor preview

Como o Holter vigia

Enviar um evento ao Holter O Holter verifica o endpoint

O que verificar

Endpoint HTTP (status / corpo / latência)

Endpoint

https://api.yourapp.com/health

Status saudável

200

Alertar se mais lento que

2000 ms

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

New monitor preview

Fornecedor

Stripe

URL da página de status

https://status.stripe.com

Ou escolha entre 24 fornecedores populares que já sabemos ler.

O que depende disso?

Checkout

Me alerte

Em qualquer degradação Só quando estiver totalmente fora do ar

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

New monitor preview

URL do selo

https://app.holter.sh/status/your-page/badge

Markdown

[![Status](…/status/your-page/badge)](https://status.your-domain.com)

Variante de uptime

https://app.holter.sh/status/your-page/badge?metric=uptime

Exemplo ao vivo

Selo de status ao vivo do Holter Selo de uptime ao vivo do Holter
  • ✓ 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.

Acessibilidade
  • 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

Certificados e domínios
  • 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

Trabalho em segundo plano
  • 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

Infraestrutura básica
  • 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

Dependências upstream · Business
  • 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