# Saiba no segundo quando um servidor cai.

> Receba alertas push na hora quando seus servidores caírem. Conecte Grafana, Prometheus ou UptimeRobot via webhook e receba o alerta no celular em menos de um segundo.

<!-- source: https://pocketalert.app/pt/use-cases/server-monitoring -->

Última atualização: 2026-08-11

O Pocket Alert transforma alertas de monitoramento de servidores em notificações push no seu iPhone ou Android. Conecte Grafana, Prometheus, UptimeRobot ou uma simples verificação de saúde via cron a uma única URL de webhook — os alertas chegam ao seu celular em menos de um segundo, sem agente na máquina e sem resumo por e-mail para vasculhar.

## Três passos para o seu primeiro alerta de servidor

1. **Configure o Pocket Alert** — Instale a CLI pocketalert e rode pocketalert auth YOUR_API_KEY, ou crie um webhook para encaminhamento.
2. **Conecte o monitoramento** — Adicione uma verificação de saúde via cron, um custom_sender do Netdata ou um webhook_config do Alertmanager apontando para a URL de recebimento.
3. **Receba o aviso** — Dispare um alerta de teste e seu celular vibra logo em seguida. Mapeie os campos para ajustar o conteúdo.

## Do pico de métrica ao seu celular

Aponte seu monitoramento para uma única URL de webhook e cada alerta chega ao seu celular em menos de um segundo.

- **Funciona com a sua stack** — Grafana, Prometheus, UptimeRobot, Datadog e Zabbix chegam ao seu celular assim que disparam um webhook.
- **Entrega em menos de um segundo** — O push chega em menos de um segundo, antes da primeira reclamação de usuário.
- **Mapeamento de campos (GJSON)** — Mapeie os campos do payload JSON para o título e a mensagem. O nome e a severidade do alerta seguem para a notificação.
- **Script ou webhook** — Uma verificação de saúde via cron ou um alerta do Alertmanager encaminhado chegam ao seu celular do mesmo jeito.
- **Canais por aplicativo** — Dê a produção, staging e homelab os seus próprios canais.
- **Sem agente necessário** — O Pocket Alert consome os webhooks que o seu monitoramento já produz, então o servidor monitorado não roda nada extra.

## Conecte seu monitoramento

### 1. Uma verificação de saúde em bash no cron

Instale a CLI, autentique-se uma vez e depois teste o serviço e envie um push se ele não responder.

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

```
#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
  pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi
```

Execute a cada minuto pelo cron.

```
* * * * * /usr/local/bin/check-health.sh
```

### 2. Ou um hook de alarme do Netdata

Adicione um `custom_sender()` em `health_alarm_notify.conf` (edite via `sudo ./edit-config health_alarm_notify.conf`) para que cada alarme do Netdata seja enviado à API de mensagens.

```
custom_sender() {
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}
```

### 3. Ou encaminhe o Alertmanager por webhook

Crie um webhook na página [Webhooks](https://pocketalert.app/pt/webhooks) com um template GJSON e depois adicione a URL de recebimento a um `webhook_config` do Prometheus Alertmanager.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Alertmanager","application_id":"qm47b9pzxzxg","message":"%status%: %alerts.0.labels.alertname% — %alerts.0.annotations.summary%"}'
```

```
receivers:
  - name: pocketalert
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'
        send_resolved: true
```

A [documentação](https://info.pocketalert.app/api/webhooks/settings.html) lista os caminhos GJSON.

## Perguntas frequentes

### Como funcionam os alertas de monitoramento de servidores?

O Pocket Alert dá a cada aplicativo uma URL de webhook de entrada. Aponte uma ferramenta de monitoramento como Grafana, Prometheus Alertmanager, UptimeRobot, Datadog ou Zabbix para essa URL, e os alertas que ela disparar viram notificações push no seu celular em menos de um segundo.

### Posso personalizar o conteúdo do alerta?

Sim. Mapeie os campos do JSON recebido com caminhos GJSON para definir o título e a mensagem da notificação. Um alerta do Alertmanager mantém o nome, o status e a severidade do começo ao fim.

### Quais ferramentas de monitoramento são suportadas?

Qualquer ferramenta que dispare uma requisição HTTP ao alertar funciona: Grafana, Prometheus Alertmanager, UptimeRobot, Datadog, Zabbix, Netdata, Uptime Kuma e scripts personalizados de health check.

### Como evito a fadiga de alertas?

Envie um push quando um servidor cair e outro quando ele voltar. Canais por aplicativo separam a infraestrutura de produção, staging e pessoal, para que os alertas urgentes não se percam em um feed barulhento.

### Preciso instalar um agente nos meus servidores?

Não há agente para instalar. O Pocket Alert recebe os webhooks que o seu monitoramento já envia, então nada extra roda no servidor monitorado.

### Um alerta de servidor fora do ar pode furar o Não perturbe à noite?

Sim. Envie o alerta com level: critical e ele ignora o Não perturbe no Android e fura o Foco no iPhone como uma notificação de tempo sensível. Mantenha as mensagens de recuperação em default — ou silenciosas — para que só a queda em si faça barulho. Os níveis vão de silent (-2) a critical (2) e funcionam na API, nos payloads de webhook e como padrão por webhook.
