2026년 OpenClaw 게이트웨이 Prometheus 메트릭, Grafana 대시보드, launchd 연동 알림: MacLogin 클라우드 Mac 실무 가이드
홍콩·도쿄·서울·싱가포르·미국 리전에서 Apple Silicon 게이트웨이를 임대하는 팀은 이미 /health/ready에 대한 curl에 익숙하지만, 청구서가 튀기 전까지는 “모두 정상”처럼 느껴지다가 한꺼번에 무너지는 경우가 많습니다. 이 글(2026년 5월)은 OpenClaw 진단 Prometheus 텍스트를 표준 호환 스크레이퍼로 가져오고, Grafana에 SLO 패널을 연결하며, 5분 FOR 창으로 지터를 흡수하면서 launchd ThrottleInterval과 디스크 경쟁을 피하는 방법을 정리합니다. 서로 다른 구조의 비교표 2개, 구체 파라미터가 있는 9단계, Prometheus/Grafana Alerting에 붙여 넣을 수 있는 임계값 예시를 제공합니다.
먼저 읽기: curl 루프 모니터링, JSONL 로테이션, doctor 진단, 허브 OpenClaw 모음. 공개 링크: 도움말, 가격, VNC.
Prometheus 스타일 카운터가 curl로 보이지 않는 사각을 드러내는 이유
합성 검사는 “소켓을 받아들였는가”를 답하고, 카운터는 “지난 30분간 도구 실패율이 올랐는가”를 답합니다. 상위 LLM이 속도 제한에 들어가도 HTTP 200이 이어질 때 큐 깊이는 이미 증가합니다—이때 추세 메트릭만이 조기 경보가 됩니다. 상류 문서의 diagnostics-prometheus 계열 플러그인은 게이트웨이와 동일 머신에서 텍스트 시계열을 노출해 Webhook 본문을 제3자 SaaS로 보내지 않고도 관측성을 높입니다.
- 지연 왜곡: 히스토그램/분위수 근사로 p95 악화를 선제 포착.
- 토큰·비용: USD 비용 카운터로 테넌트별 소각을 재무와 맞추고, 흔한 512 GB SSD 클래스 Mac mini M4 임대와도 정합.
- 채널 상태: 상류에서 자주 언급하는 5분 단위 스테일 탐지와 스크레이프 주기를 맞추고, Grafana 보존이 15일뿐인데 12초 스크레이프로 해상도만 과도하게 올리지 않기.
신호원 매트릭스
| 소스 | 최적 용도 | 카디널리티 | 피해야 할 때 |
|---|---|---|---|
/api/diagnostics/prometheus | SLO·에러 예산 | 테넌트 라벨 폭증 시 높음 | 무인증 평문 노출 |
/health/ready / live | 오케스트레이션 게이트 | 낮음 | 깊은 의존성 진단 |
openclaw health --json | 인시던트 브리징 | 없음 | 아분 단위 연속 폴링 |
openclaw doctor | 설정 드리프트 | 없음 | 실시간 포화 탐지 |
안전한 스크레이프 경로
localhost 하드닝과 같이 Prometheus/vmagent는 게이트웨이와 동일 사용자 맥락에서 127.0.0.1을 호출하거나 관측 VPC로 SSH 터널을 뚫습니다. 싱가포르 운영자가 도쿄 mini를 볼 때는 알림 FOR에 180 ms RTT 여유를 넣으세요.
9단계 롤아웃
- 5/7 런북의 기존 프로브 주기(예 90 s)를 정리.
- 진단 Prometheus 활성화 후
# HELP줄 확인. - Grafana와 동일 인증 헤더로
curl --fail스모크. region="kr"같은 지역 라벨만—Webhook 비밀은 라벨에 넣지 않기.- Prometheus 잡은 기본 30 s, CPU 여유가 25%를 지속적으로 넘을 때만 15 s 검토.
- Grafana JSON을 HK/JP/KR/SG/US 폴더에 가져와 datasource UID 고정.
- 알림은 5 m FOR 표준화.
- 게임데이로 자격 증명을 깨뜨려 프로브·메트릭 알림 순서 검증.
- 월간으로 미사용 시계열 삭제, 작은 디스크에선 WAL을 4 GB 아래로.
Grafana 패널과 재사용 가능한 임계값
| 의도 | PromQL 스케치 | 임계값 | 근거 | 오너 |
|---|---|---|---|---|
| 실패율 | rate(openclaw_run_completed_total{status="error"}[5m]) | > 0.05/s, 10 m | 도구 연쇄 실패 | 플랫폼 |
| 모델 지연 | histogram_quantile(0.95, sum(rate(openclaw_model_call_duration_seconds_bucket[5m])) by (le)) | > 6 s, 5 m | SLA 전 스로틀 | AI 스쿼드 |
| 도구 오류 건수 | increase(openclaw_tool_execution_total{status="error"}[15m]) | > 12 | 수동 트리아지 용량 | DevOps |
| 비용 가드 | increase(openclaw_model_cost_usd_total[1h]) | > 48 USD/h | 재무 페이징 | FinOps |
launchd와 디스크 예산
Prometheus나 Grafana Agent를 LaunchAgent로 나란히 둘 때 WAL 재생 실패 시 매분 12회 재시작하지 않도록 크래시 복구 글의 ThrottleInterval을 재사용하세요. JSONL SIEM 용량 계산과 함께, 스크레이프당 780 KB × 40 타깃이면 일 약 2.7 GB—SSD 압박으로 unified logging이 막히기 전에 보존 또는 60 s remote_write 샤딩을 조정합니다.
교차 링크
블루그린 주석과 Grafana 어노테이션을 맞추고, Webhook 멱등 키로 외부 재시도와 내부 결함을 분리합니다.
FAQ
Grafana 없이도? VictoriaMetrics만으로도 가능합니다. Grafana는 다기능 합의를 빠르게 만드는 UI 층입니다.
remote_write를 Mac 밖으로? 이그레스 과금을 확인하고 60 s 샤딩으로 대역을 자주 절반으로 줄입니다.
doctor를 대체? LaunchAgent 라벨 오타는 여전히 doctor가 잡습니다.
Mac mini M4가 메트릭 에지에 적합한 이유
Apple Silicon 전력 곡선은 상시 스크레이프 sidecar에 유리하고 x86 버스터블 VM보다 운영 잡음이 적습니다. 네이티브 macOS에서 openclaw CLI, 키체인 연동, Grafana 키오스크를 중첩 가상화 없이 공존시킬 수 있습니다. MacLogin의 HK/JP/KR/SG/US 배치로 게이트웨이는 지역별로 쪼개고 대시보드는 중앙집중—시계열 라벨을 정직하게 달아 싱가포르 네트워크 지터와 서울 CPU 포화를 알림 본문에서 구분하세요.
