로그 한 줄에서 잠금 화면까지
로그 파이프라인이 이미 문제 줄을 찾아내요. Pocket Alert는 그 줄을 휴대폰까지 전달해요.
기존 스택과 함께 동작
Loki 룰러, Elastic Watcher, Graylog, 또는 tail | grep 스크립트 모두 하나의 웹훅으로 전송할 수 있어요.
패턴 매칭 알림
LogQL 규칙, Watcher 조건, 또는 grep 패턴이 푸시를 언제 보낼지 결정해요.
필드 매핑
GJSON 경로로 알림 JSON에서 알림 이름, 매칭된 줄, 매칭 횟수를 바로 추출해요.
CLI 또는 웹훅
tail | grep 스크립트가 모니터링 플랫폼 없이도 메시지 API에 바로 curl 요청을 보낼 수 있어요.
애플리케이션별 채널
서비스나 환경마다 Pocket Alert 애플리케이션을 하나씩 두면 운영과 스테이징 로그가 별도 채널로 나뉘어요.
1초 미만 전달
웹훅이 실행되고 푸시는 1초 안에 도착해요. 실시간으로 OOMKilled 파드를 잡아낼 만큼 빠릅니다.
로그 한 줄에서 푸시까지 세 단계
패턴 정의하기
줄이 매칭되면 실행되는 Loki 룰러 규칙, Elastic Watcher, 또는 grep 패턴을 추가하세요.
연결하기
tail | grep 스크립트에서 메시지 API를 curl로 호출하거나, GJSON 템플릿을 포함한 Pocket Alert 웹훅 수신 URL을 Alertmanager에 연결하세요.
채널 나누기
서비스나 환경마다 애플리케이션을 따로 만들어서 운영과 스테이징 로그가 별도 채널에 머물게 하세요.
로그 패턴이 매칭되면 푸시 알림 보내기
1. tail | grep 스크립트에서 바로 curl (CLI)
CLI를 설치하고 한 번 인증한 뒤, 로그를 tail로 읽으면서 매칭되는 모든 줄을 푸시로 보내세요.
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
tail -Fn0 /var/log/app.log | grep --line-buffered "OutOfMemory" | while read -r line; do
pocketalert send -t "OOM on $(hostname)" -m "$line"
done
CLI 대신 메시지 API에 직접 POST 요청을 보낼 수도 있어요.
tail -Fn0 /var/log/app.log | grep --line-buffered "ERROR" | while read -r line; do
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d "{\"title\":\"Log error\",\"level\":\"critical\",\"message\":\"${line//\"/\\\"}\"}"
done
2. 또는 웹훅으로 Loki / Alertmanager 전달
Loki 룰러에 LogQL 알림 규칙을 정의하세요. 매칭 수가 임계값을 넘으면 알림이 발생합니다.
groups:
- name: app-errors
rules:
- alert: HighErrorRate
expr: sum(count_over_time({app="api"} |= "ERROR" [5m])) > 20
for: 1m
labels:
severity: critical
annotations:
summary: "{{ $value }} ERROR lines in the last 5m"
룰러는 Alertmanager(alertmanager_url)로 알림을 보내고, Alertmanager는 이를 Pocket Alert로 전달해요. 웹훅 페이지에서 Alertmanager 페이로드를 매핑하는 GJSON 템플릿을 포함한 웹훅을 만든 뒤, webhook_config가 수신 URL을 가리키도록 설정하세요.
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name":"Loki Alerts","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
Elastic Watcher의 webhook 액션이나 Graylog HTTP 알림 이벤트 정의도 같은 수신 URL로 POST 요청을 보낼 수 있어요. 문서에서 GJSON 매핑과 애플리케이션별 라우팅을 자세히 확인하세요.
궁금한 점을 답해드려요
Loki 룰러 알림, Elastic Watcher, Graylog 이벤트 정의 중 하나를 설정해서 Pocket Alert 애플리케이션 URL로 웹훅을 보내세요. 매칭된 로그 줄과 개수가 JSON 본문에 담겨 전달돼요.
서버에 추가로 실행되는 것은 없어요. Pocket Alert는 이미 사용 중인 파이프라인의 끝에 연결되므로, Loki, Elastic, Graylog 또는 cron tail 스크립트가 매칭을 수행하고 결과만 전송하면 돼요.
GJSON 필드 매핑으로 알림 페이로드의 모든 경로를 읽을 수 있어요. 예를 들어 %alerts.0.labels.alertname%으로 알림 이름을 제목에, %alerts.0.annotations.summary%로 매칭된 줄이나 개수를 메시지에 넣을 수 있어요.
서비스나 환경마다 별도의 Pocket Alert 애플리케이션을 만드세요. 그러면 운영 환경의 500 에러 폭주는 스테이징의 단순 파서 경고와 다른 채널로 전달돼요. 조용히 볼 피드와 즉시 확인해야 할 피드를 분리할 수 있어요.
서비스나 환경마다 별도의 Pocket Alert 애플리케이션을 만드세요. 그러면 운영 인증 실패와 스테이징 작업 로그가 하나의 시끄러운 피드 대신 별도의 채널로 전달돼요.
네. POST 요청에 "level":"critical"을 추가하면 Android에서는 방해 금지 모드를 우회하는 전용 알림 채널로 전달돼요. 방해 금지 접근 권한은 한 번만 허용하면 됩니다. iPhone에서는 high와 critical 알림이 시간 민감 알림으로 전달되어 집중 모드를 뚫고 도착해요. 웹훅에 default_level을 설정하면 해당 파이프라인의 모든 알림을 같은 우선순위로 받을 수 있고, 수다스러운 피드는 level을 silent로 두어 소리나 진동 없이 기록에만 남길 수 있어요. 무료 플랜에서는 critical이 high로 전달되어 즉시 도착하지만 방해 금지 모드는 우회하지 않아요.