서버 모니터링

서버가 다운되는 순간을 아세요.

Pocket Alert는 서버 모니터링 알림을 iPhone이나 Android의 푸시 알림으로 바꿔 줘요. Grafana, Prometheus, UptimeRobot 또는 일반 크론 상태 확인을 웹훅 URL 하나에 연결하면, 알림이 1초 안에 휴대폰에 도착해요. 서버에 에이전트를 설치할 필요도 없고, 이메일 요약을 뒤질 필요도 없어요.

<1s 안에 푸시 도착크론 또는 웹훅curl · Netdata · Alertmanager 업데이트
기능

지표 급증부터 휴대폰까지

모니터링 도구를 웹훅 URL 하나에 연결하면 모든 알림이 1초 안에 휴대폰에 도착해요.

사용 중인 스택과 함께 동작해요

Grafana, Prometheus, UptimeRobot, Datadog, Zabbix는 웹훅을 보내는 순간 휴대폰으로 알림이 도착해요.

1초 미만 전달

푸시는 1초가 안 되어 도착해요. 사용자가 문제를 신고하기 전에 알 수 있어요.

필드 매핑(GJSON)

JSON 페이로드 필드를 제목과 메시지에 매핑하세요. 알림 이름과 심각도가 그대로 알림에 전달돼요.

스크립트 또는 웹훅

크론 상태 확인이든 전달된 Alertmanager 알림이든 같은 방식으로 휴대폰에 도착해요.

애플리케이션별 채널

prod, staging, homelab마다 별도 채널을 만들 수 있어요.

에이전트 불필요

Pocket Alert는 모니터링 도구가 이미 만드는 웹훅을 받기만 해서, 모니터링 대상 장비에서는 추가로 실행되는 것이 없어요.

시작하기

첫 서버 알림까지 3단계

1

Pocket Alert 설정하기

pocketalert CLI를 설치하고 pocketalert auth YOUR_API_KEY를 실행하거나, 전달용 웹훅을 만드세요.

2

모니터링 연결하기

크론 상태 확인, Netdata custom_sender, 또는 수신 URL을 가리키는 Alertmanager webhook_config를 추가하세요.

3

알림 받기

테스트 알림을 보내면 잠시 후 휴대폰이 울려요. 필드를 매핑해서 알림 내용을 세부 조정할 수 있어요.

모니터링 연결하기

1. 크론으로 실행하는 bash 상태 확인

CLI를 설치하고 한 번 인증한 뒤, 서비스에 요청을 보내 응답이 없으면 푸시를 보내세요.

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

크론으로 1분마다 실행하세요.

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

2. 또는 Netdata 알람 훅

custom_sender()에 health_alarm_notify.conf를 추가하세요(sudo ./edit-config health_alarm_notify.conf로 편집할 수 있어요). 그러면 Netdata 알람이 발생할 때마다 메시지 API로 전송돼요.

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. 또는 웹훅으로 Alertmanager 전달하기

웹훅 페이지에서 GJSON 템플릿으로 웹훅을 만든 뒤, 수신 URL을 Prometheus Alertmanager의 webhook_config에 추가하세요.

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

GJSON 경로 목록은 문서에서 확인할 수 있어요.

FAQ

궁금한 점을 답해드려요

Pocket Alert는 애플리케이션마다 수신용 웹훅 URL을 제공해요. Grafana, Prometheus Alertmanager, UptimeRobot, Datadog, Zabbix 같은 모니터링 도구를 이 URL로 향하게 설정하면, 도구에서 발생한 알림이 1초 안에 휴대폰의 푸시 알림으로 바뀌어요.

네, 가능해요. GJSON 경로로 수신한 JSON의 필드를 매핑해서 알림 제목과 메시지를 설정할 수 있어요. Alertmanager 알림은 이름, 상태, 심각도가 그대로 유지돼요.

알림이 발생할 때 HTTP 요청을 보내는 도구라면 모두 사용할 수 있어요. Grafana, Prometheus Alertmanager, UptimeRobot, Datadog, Zabbix, Netdata, Uptime Kuma, 직접 만든 상태 확인 스크립트 등이 포함돼요.

서버가 다운되면 푸시를, 복구되면 다른 푸시를 보내세요. 애플리케이션별 채널로 운영, 스테이징, 개인 인프라를 나누면 긴급 알림이 많은 알림 속에 묻히지 않아요.

설치할 에이전트가 없어요. Pocket Alert는 모니터링 도구가 이미 보내는 웹훅을 받기만 하므로, 모니터링 대상 서버에서 추가로 실행되는 프로그램이 없어요.

네. level: critical로 알림을 보내면 Android에서는 방해 금지 모드를 무시하고, iPhone에서는 집중 모드를 뚫고 시간 민감 알림으로 전달돼요. 복구 메시지는 기본값이나 무음으로 두면 장애 자체만 알림으로 울려요. 심각도는 무음(-2)부터 긴급(2)까지 있으며, API, 웹훅 페이로드, 웹훅별 기본값으로 설정할 수 있어요.

장애가 시작되는 순간 알림을 받으세요.

모니터링 스택을 휴대폰에 연결하세요. 무료로 시작할 수 있고, 1초가 안 되어 알림이 도착해요.