# 디스크가 가득 차기 전에.

> CPU, RAM, 디스크 사용량이 임계값을 넘으면 푸시 알림을 받아보세요. 간단한 셸 스크립트로 확인하거나 Grafana 알림을 연동해, 서버가 멈추기 전에 디스크 가득 참 상태를 미리 잡아낼 수 있어요.

<!-- source: https://pocketalert.app/ko/use-cases/resource-usage-alerts -->

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

df, free, top으로 간단한 임계치 체크를 실행하거나, Grafana나 Netdata의 알림을 전달받아 보세요. CPU, 메모리, 디스크가 한도를 넘으면 현재 값을 담은 푸시 알림이 휴대폰으로 도착해요.

## 리소스 알림 설정 3단계

1. **CLI 또는 URL 받기** — Pocket Alert CLI를 설치하거나, curl 기반 체크에 쓸 웹훅 URL을 받아 보세요.
2. **임계치 설정하기** — cron에 임계치 체크를 추가하거나, 모니터링 도구의 알림을 전달받도록 설정해 보세요.
3. **여유 있을 때 조치하기** — 사용량이 기준선을 넘으면 휴대폰이 값과 함께 알려 줘요. 아직 여유가 있을 때 바로 조치할 수 있어요.

## 서버가 바닥나기 전에 미리 알려 드려요

새벽 3시에 디스크가 가득 차면 모든 서비스가 함께 무너져요. 85퍼센트에서 미리 경고를 받으면 아직 조치할 시간이 있어요.

- **셸 체크 한 줄이면 충분해요** — df, free, top을 사용한 두 줄짜리 체크가 사용량이 한도를 넘으면 푸시를 보내요. 설치할 것도 없어요.
- **기존 도구도 그대로 쓸 수 있어요** — 또는 Grafana, Netdata, Zabbix, Prometheus의 임계치 알림을 전달받을 수 있어요.
- **알림에 사용량이 함께 표시돼요** — 메시지에 현재 값과 임계치가 담겨서, 얼마나 급한지와 위치를 바로 알 수 있어요.
- **여유 있는 임계치 설정** — 디스크 85%나 메모리 90%에서 경고를 받으면, 조치할 시간이 충분히 남아 있어요.
- **일찍 발견해요** — 디스크가 가득 차거나 CPU가 한계까지 치솟으면 예고 없이 서비스가 멈출 수 있어요. 여유가 있을 때 미리 잡아낼 수 있어요.
- **즉시 경고** — 임계치를 넘으면 푸시가 바로 도착해요. 대시보드를 열어 둘 필요가 없어요.

## 리소스 사용량 알림 설정

### 1. CLI 설치 및 인증

`pocketalert` 바이너리를 내려받아 PATH에 두고, 대시보드에서 발급받은 API 키로 한 번 인증해 주세요.

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

### 2. 디스크 임계치 (cron)

`df`로 디스크 사용량을 읽고, 85%를 넘을 때만 푸시를 보내요.

```
USAGE=$(df / | awk 'NR==2{print $5}' | tr -d %)
[ "$USAGE" -gt 85 ] && pocketalert send \
  -t "Disk ${USAGE}% on /" -m "Free space running low on $(hostname)"
```

### 3. 메모리 및 CPU 임계치

같은 방식으로 `free`를 이용한 RAM 확인과 `top`을 이용한 CPU 부하 확인도 할 수 있어요.

```
MEM=$(free | awk '/Mem/{printf "%d", $3/$2*100}')
[ "$MEM" -gt 90 ] && pocketalert send -t "Memory ${MEM}% on $(hostname)" -m "High memory pressure"

CPU=$(top -bn1 | awk '/Cpu\(s\)/{printf "%d", 100 - $8}')
[ "$CPU" -gt 90 ] && pocketalert send -t "CPU ${CPU}% on $(hostname)" -m "Sustained high CPU"
```

### 4. 예약 실행

스크립트를 cron에 추가해서 5분마다 실행되도록 설정해 주세요.

```
*/5 * * * * /usr/local/bin/check-resources.sh
```

CLI를 사용하지 않으신다면 `pocketalert send` 대신 메시지 API로 `curl` POST 요청을 보내면 돼요.

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Disk full","message":"Disk over 85% on db-1","level":"critical"}'
```

이미 모니터링 도구를 쓰고 계신가요? Grafana나 Netdata의 임계치 알림을 Pocket Alert 웹훅으로 연결해 보세요. 나머지 내용은 [문서](https://info.pocketalert.app/getting-started.html)에서 확인할 수 있어요.

## 자주 묻는 질문

### 리소스 사용량 알림은 어떻게 받나요?

간단한 체크를 예약하거나, Grafana, Netdata, Zabbix의 임계치 알림을 전달받아 CPU, 메모리, 디스크가 한도를 넘으면 Pocket Alert로 POST하도록 설정할 수 있어요. 경고가 휴대폰으로 도착하므로 대응할 시간이 생겨요.

### 모니터링 도구 없이도 할 수 있나요?

네, 가능해요. df, free, top으로 사용량을 임계치와 비교하는 두 줄짜리 셸 체크를 만들면, 임계치를 넘을 때만 푸시가 발송돼요. 모니터링 플랫폼이 없어도 돼요.

### 실제 사용량도 확인할 수 있나요?

"/var 디스크 92%"처럼 현재 값과 임계치를 메시지에 넣어 보세요. 얼마나 급한지, 어떤 마운트 지점이나 프로세스가 원인인지 바로 알 수 있어요.

### 모니터링 도구와 간단한 스크립트 중 무엇을 써야 하나요?

둘 다 가능해요. Grafana, Netdata, Zabbix, Prometheus의 임계치 알림을 전달하거나, 서버에서 작은 크론 작업을 실행해 보세요. 어느 쪽이든 Pocket Alert가 푸시를 보내요.

### 얼마나 일찍 알림을 받아야 하나요?

위험 구간보다 낮게 임계치를 설정하세요. 예를 들어 디스크 85%, 메모리 90% 정도면 공간을 확보하거나 증설할 시간이 충분해요.

### 디스크 가득 참 알림이 방해 금지 모드를 뚫고 올 수 있나요?

네, 가능해요. 반드시 깨어나야 하는 체크, 예를 들어 디스크 95% 임계치에는 level=critical을 추가하세요. 그러면 Android는 방해 금지 모드를 무시하는 채널로 알림을 보내고, iPhone은 집중 모드를 뚫고 나가는 시간 민감 알림으로 표시해요. 85%의 사전 경고는 기본 레벨로 두면 조용하게 전달돼요.
