2026 OpenClaw 관측 실전
대여 Mac Mini: 로그 로테이션·디스크 워터마크·이상 Webhook 알림 설정

통증 포인트

1. 무음 풀 디스크: stdout·작업 로그 무제한이면 Mac Mini가 며칠 내 가득 참.
2. 늦은 임계치: 거의 찰 때만 알면 배치 체크포인트가 이미 손상.
3. Webhook 공백: 세션·방화벽으로 Webhook 미전송.

① 리스크 목록

• 삭제 후에도 열린 inode로 공간 미회수.
• 로테이션 주기가 길어 피크에 공간 소진.
• TLS·레이트리밋으로 Webhook 실패.

로테이션 방식 의사결정 매트릭스

② 로테이션 전략 파라미터

newsyslog: 단일 파일 오십~이백 메가바이트, 보존 칠~삼십개, 일 또는 크기 중 먼저 도래 시 회전. OpenClaw 로그 경로와 권한을 엔트리에 정확히 적습니다.

pm2-logrotate: max_size 오십 메가, retain 십사, compress 활성로 디스크를 아낍니다.

launchd: 예를 들어 매일 또는 매시간 셸로 크기 검사 후 복사·truncate, 앱이 지원하면 USR로 재오픈을 유도합니다.

③ 디스크 워터마크 임계치와 정리 단계

여유 공간 사다리 권장: 십오 퍼센트 미만 경고 알림, 십 퍼센트 이하에서 오래된 .gz·임시 캐시 삭제, 오 퍼센트 부근에서 무거운 쓰기 일시 중지 후 사람이 확인합니다.

1. df -h·스냅샷 확인.
2. 로테이션 폴더 최근 N개만 유지.
3. 미회복 시 Webhook 심각도 상향.

④ 이상 Webhook 알림 템플릿

필드 고정 JSON POST.

{
  "source": "openclaw-macmini",
  "severity": "warn",
  "metric": "disk_free_percent",
  "value": 12,
  "threshold": 15,
  "host": "rental-node-1",
  "message": "디스크 여유가 경고선 아래"
}

동일 유저 curl로 HTTP·TLS 확인.

실행 절차(다섯 단계 이상)

1. OpenClaw·배치 로그 경로와 상위 디렉터리 권한을 표로 고정합니다.
2. 비교표에서 방식을 고른 뒤 설정 reload 또는 모듈 설치를 적용합니다.
3. 디스크 프로브를 약 오 분 간격으로 돌리고 launchd 또는 cron에 등록합니다.
4. Webhook는 임계 단계별로 dry-run 후 실제 전송합니다.
5. 부하 테스트로 롤링 곡선을 확인하고 운영 핸드북에 수치를 남깁니다.

⑤ FAQ·트러블슈팅