스택 트레이스에서 잠금 화면까지
오류 추적 도구는 이미 웹훅을 보내고 있어요. Pocket Alert는 이를 놓칠 수 없는 푸시 알림으로 바꿔 드려요.
모든 오류 추적 도구와 호환
Sentry, Rollbar, Bugsnag, Honeybadger, Airbrake 모두 새 이슈가 생기면 나가는 웹훅을 보내요. Pocket Alert 주소만 지정하면 설정이 끝나요.
GJSON으로 필드 매핑
GJSON 경로를 사용하면 페이로드에서 data.event.title, data.event.culprit, data.event.level 값을 바로 꺼내 알림에 넣을 수 있어요.
수준과 규칙을 알림에 표시
푸시 알림 안에 오류 수준과 실행된 규칙을 바로 표시해서, fatal 예외와 warning 예외를 한눈에 구분할 수 있어요.
환경별 채널 분리
애플리케이션마다 고유한 웹훅 URL이 있어서, 운영, 스테이징, 특정 서비스 알림을 각각 다른 채널로 나눠 받을 수 있어요.
1초 이내 전달
예외 알림이 1초 이내에 휴대폰에 도착해요. 이메일 요약 발송보다 훨씬 빨라요.
비밀 웹훅 URL
웹훅 URL은 HTTPS로 보호되는 애플리케이션 비밀 값이에요. 새 엔드포인트가 필요하면 언제든 URL을 재발급하세요.
휴대폰으로 오류 알림을 받는 세 단계
웹훅 만들기
GJSON 메시지 템플릿이 포함된 Pocket Alert 웹훅을 만들고 수신 URL을 복사하세요.
오류 추적 도구 연결
Sentry 내부 통합(또는 Rollbar/Bugsnag 웹훅)에 URL을 붙여넣고 알림 규칙에 연결하세요.
매핑하고 전송
GJSON이 data.event.title, culprit, level, web_url을 푸시 알림에 매핑해요. 다음 예외가 발생하면 휴대폰이 진동해요.
오류 알림을 휴대폰으로 받기
1. Pocket Alert 웹훅 만들기
웹훅 페이지에서 Sentry 이슈 알림 페이로드를 읽는 GJSON message 템플릿을 가진 웹훅을 만드세요. 모든 데이터는 data.event 아래에 중첩되어 있어요:
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
-H "Token: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Sentry","default_level":"critical","message":"[%data.event.level%] %data.event.title%\n%data.event.culprit%\n%data.event.web_url%","application_id":"qm47b9pzxzxg"}'
다음과 같은 수신 URL이 발급돼요. 예: https://p4a.me/wh/1234abcd.
2. Sentry에서 해당 URL 지정하기
설정 → 개발자 설정 → 내부 통합(Internal Integration)에서 Webhook URL을 수신 URL로 설정하고 Alert Rule Action을 활성화하세요. 그다음 이슈 알림 규칙을 만들고 이 통합을 액션으로 추가하세요:
Webhook URL: https://p4a.me/wh/1234abcd
Permissions: Issue & Event (Read)
Action: Alert Rule Action — enabled
Alerts → Create Alert → When a new issue is created
→ Then send a notification via [your integration]
Sentry는 {"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}} 형태로 POST 요청을 보내고, 위의 GJSON 경로가 이 필드를 푸시 알림에 넣어 줘요.
3. 다른 오류 추적 도구(Rollbar, Bugsnag)
Rollbar(설정 → Notifications → Webhook)와 Bugsnag(Integrations → Generic webhook)은 더 단순한 페이로드를 보내요. 템플릿을 해당 필드에 맞게 수정하세요. 예를 들어 Rollbar는 %data.item.title%, Bugsnag는 %error.exceptionClass%를 사용하고, 수신 URL은 동일하게 붙여넣으면 돼요.
모든 GJSON 경로와 웹훅 옵션은 웹훅 설정 문서에서 확인할 수 있어요.
궁금한 점을 답해드려요
Sentry에서 웹훅 URL을 Pocket Alert 수신 URL로 설정하고 Alert Rule Action을 활성화한 내부 통합(Internal Integration)을 만든 다음, 이슈 알림 규칙에 추가하세요. 규칙이 실행되면 Sentry가 이슈 데이터를 POST로 보내고, 푸시 알림은 1초 이내에 휴대폰에 도착해요.
Sentry 이슈 알림 웹훅은 데이터를 data.event 아래에 중첩해서 보내요. Pocket Alert는 GJSON 경로로 이 데이터를 읽어요. data.event.title을 알림 제목에, data.event.culprit 또는 web_url을 본문에 매핑하면 푸시 알림에 어떤 이슈가 발생했는지 정확히 표시돼요.
페이로드에는 data.event.level(warning, error, fatal)과 data.triggered_rule에 있는 규칙 이름이 들어 있어요. GJSON 메시지 템플릿에서 두 값을 함께 사용하면 fatal 예외와 warning 예외의 알림 내용을 다르게 표시할 수 있어요.
환경마다 애플리케이션을 따로 만드세요. 운영(prod) 웹훅과 스테이징(staging) 웹훅은 각각 다른 채널로 전달되고, 운영 환경에 영향을 주지 않고 스테이징 알림만 끌 수 있어요.
필요하지 않아요. Pocket Alert는 오류 추적 도구가 이미 보내고 있는 웹훅을 수신하기만 하므로, 설치할 에이전트나 SDK가 없어요. Sentry, Rollbar, Bugsnag, Honeybadger, Airbrake 모두 나가는 웹훅을 지원해요.
네. 메시지에 "level":"critical"을 추가하면 Android에서는 방해 금지 모드를 우회하는 전용 알림 채널로 전송돼요. 방해 금지 접근 권한은 한 번만 허용하면 돼요. iPhone에서는 high와 critical 알림이 시간 민감 알림으로 전송되어 집중 모드를 뚫고 도착해요. 모든 메시지는 silent부터 critical까지 수준을 지정할 수 있으므로, 스테이징 warning은 조용히 두고 운영 fatal 예외에만 바로 알림을 받을 수 있어요. 무료 플랜에서는 critical이 high로 전송돼요. 즉시 도착하지만 방해 금지 모드 우회는 적용되지 않아요.