# 푸시로 매칭된 로그 줄 을 휴대폰으로 받으세요.

> 로그 패턴이 일치하면 푸시 알림을 받아보세요. Loki, ELK 스택, Graylog를 Pocket Alert 웹훅에 연결하면 일치한 에러 로그 한 줄이 1초 만에 휴대폰에 도착해요.

<!-- source: https://pocketalert.app/ko/use-cases/log-monitoring-alerts -->

마지막 업데이트: 2026-08-11

Loki, ELK 스택, Graylog, 또는 tail | grep 스크립트가 이미 에러 급증과 로그인 실패 연속 발생을 감지하고 있죠. 매칭된 줄은 1초 안에 휴대폰에 도착해서, 중요한 로그 항목을 주머니 속에서 바로 확인할 수 있어요.

## 로그 한 줄에서 푸시까지 세 단계

1. **패턴 정의하기** — 줄이 매칭되면 실행되는 Loki 룰러 규칙, Elastic Watcher, 또는 grep 패턴을 추가하세요.
2. **연결하기** — tail | grep 스크립트에서 메시지 API를 curl로 호출하거나, GJSON 템플릿을 포함한 Pocket Alert 웹훅 수신 URL을 Alertmanager에 연결하세요.
3. **채널 나누기** — 서비스나 환경마다 애플리케이션을 따로 만들어서 운영과 스테이징 로그가 별도 채널에 머물게 하세요.

## 로그 한 줄에서 잠금 화면까지

로그 파이프라인이 이미 문제 줄을 찾아내요. Pocket Alert는 그 줄을 휴대폰까지 전달해요.

- **기존 스택과 함께 동작** — Loki 룰러, Elastic Watcher, Graylog, 또는 tail | grep 스크립트 모두 하나의 웹훅으로 전송할 수 있어요.
- **패턴 매칭 알림** — LogQL 규칙, Watcher 조건, 또는 grep 패턴이 푸시를 언제 보낼지 결정해요.
- **필드 매핑** — GJSON 경로로 알림 JSON에서 알림 이름, 매칭된 줄, 매칭 횟수를 바로 추출해요.
- **CLI 또는 웹훅** — tail | grep 스크립트가 모니터링 플랫폼 없이도 메시지 API에 바로 curl 요청을 보낼 수 있어요.
- **애플리케이션별 채널** — 서비스나 환경마다 Pocket Alert 애플리케이션을 하나씩 두면 운영과 스테이징 로그가 별도 채널로 나뉘어요.
- **1초 미만 전달** — 웹훅이 실행되고 푸시는 1초 안에 도착해요. 실시간으로 OOMKilled 파드를 잡아낼 만큼 빠릅니다.

## 로그 패턴이 매칭되면 푸시 알림 보내기

### 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로 전달해요. [웹훅](https://pocketalert.app/ko/webhooks) 페이지에서 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 요청을 보낼 수 있어요. [문서](https://info.pocketalert.app/api/webhooks/settings.html)에서 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%로 매칭된 줄이나 개수를 메시지에 넣을 수 있어요.

### 500 에러 급증과 단순 경고를 따로 받을 수 있나요?

서비스나 환경마다 별도의 Pocket Alert 애플리케이션을 만드세요. 그러면 운영 환경의 500 에러 폭주는 스테이징의 단순 파서 경고와 다른 채널로 전달돼요. 조용히 볼 피드와 즉시 확인해야 할 피드를 분리할 수 있어요.

### 서비스와 환경을 어떻게 분리하나요?

서비스나 환경마다 별도의 Pocket Alert 애플리케이션을 만드세요. 그러면 운영 인증 실패와 스테이징 작업 로그가 하나의 시끄러운 피드 대신 별도의 채널로 전달돼요.

### 야간에도 에러 급증 알림이 방해 금지 모드를 뚫을 수 있나요?

네. POST 요청에 "level":"critical"을 추가하면 Android에서는 방해 금지 모드를 우회하는 전용 알림 채널로 전달돼요. 방해 금지 접근 권한은 한 번만 허용하면 됩니다. iPhone에서는 high와 critical 알림이 시간 민감 알림으로 전달되어 집중 모드를 뚫고 도착해요. 웹훅에 default_level을 설정하면 해당 파이프라인의 모든 알림을 같은 우선순위로 받을 수 있고, 수다스러운 피드는 level을 silent로 두어 소리나 진동 없이 기록에만 남길 수 있어요. 무료 플랜에서는 critical이 high로 전달되어 즉시 도착하지만 방해 금지 모드는 우회하지 않아요.
