OpenClaw 게이트웨이 합성 헬스 체크: curl 루프, JSONL 로그, 임대 클라우드 Mac에서 launchd 친화 모니터링
운영 사고는 극적인 스택 트레이스로 시작하는 경우가 적고, 게이트웨이가 응답을 멈춘 뒤에야 웹훅 큐가 Slack을 채울 때까지 조용한 경우가 많습니다. 합성 프로브—루프백으로 좁힌 curl, 덧붙이기 전용 구조화 로그, ThrottleInterval을 존중하는 LaunchAgent—는 홍콩·도쿄·서울·싱가포르·미국 운영자에게 외부 SaaS에 자격 증명을 넘기지 않고 솔직한 심박을 제공합니다. 2026년 5월 글은 localhost 바인딩 상류 지침과 맞춘 프로브 주기, 실패 예산, 도입 9단계, 연속 실패 시 에스컬레이션을 묶습니다.
먼저 읽기: localhost 바인딩 하드닝, 데몬 트러블슈팅, 컷오버 헬스 체크, 허브 OpenClaw 모음. 앵커:도움말, 요금, VNC.
프로브는 “모니터링 도구를 하나 더”가 아니라 “게이트웨이가 소켓을 받아들인다”는 최소 선언을 인프라 코드에 고정하는 장치입니다. 변경 리뷰에서는 간격·타임아웃·로그 경로를 반드시 diff에 넣으세요.
합성 프로브가 “누군가 알아챌 것”보다 나은 이유
openclaw doctor는 설정 드리프트를 잡지만 수 초 CPU를 씁니다. 가벼운 curl은 HTTP 리스너가 여전히 소켓을 받는지 저렴하게 증명하며, TLS가 SSH 터널 쪽에서 종료되는 배치에서도 의미가 있습니다.
일회성 수동 curl과 주기 프로브는 다릅니다. 후자는 온보딩된 macOS 사용자 맥락과 로그 로테이션까지 함께 설계하세요.
헬스 엔드포인트 계약 매트릭스
| 스타일 | 기대 신호 | 위양성 | 완화 |
|---|---|---|---|
| HTTP 200 빈 몸체 | 리스너 생존 | accept() 뒤 프로세스 교착 | 프로세스 RSS 등과 병행 |
| JSON 상태 | 버전+빌드 스탬프 | 파싱 실패 증가 | jq 종료 코드로 판단 |
| WebSocket 업그레이드 탐침 | 풀스택 건강 | 구현 비용 큼 | 티어 1 게이트웨이만 |
계약을 바꿀 때는 프로브와 롤아웃을 한 변경에 묶고, 대시보드 색이 바뀌기 전에 문서를 갱신하세요.
모든 프로브 스크립트에 필요한 curl 가드레일
--fail --silent --show-error와 명시적 연결·전체 타임아웃 예산.- 루프백만(
127.0.0.1)— TLS 메시가 있으면 설계서에 기록. - 구조화 stderr— ISO 타임스탬프 접두어+리스 ID로 grep 용이.
중복 프로브가 같은 호스트에서 포트를 다투지 않도록 운영 사용자별로 plist를 나누는 팀도 있습니다.
프로브 헬퍼용 LaunchAgent 스로틀 패턴
launchd는 종료 코드가 뒤틀리면 프로브를 연속 재기동합니다. ThrottleInterval과 건전한 종료 코드를 맞추고 과거 게이트웨이 복구 글과 같은 크래시 루프 교훈을 적용하세요.
프로브 도입 9단계 롤아웃
- 베이스라인: 변경 전 doctor JSON 저장.
- 고정: 리스너 포트(종종 18789)를 SSH와 함께 방화벽 문서에.
- 작성: curl 래퍼를 IaC 옆에 커밋.
- 드라이런: SSH 세션에서 수동 실행.
- 설치: 올바른 macOS 사용자에 LaunchAgent.
- 검증: JSONL 증가와 로테 정책.
- 배선: 드라이런 성공 후 PagerDuty/웹훅.
- 게임데이: 의도적으로 게이트웨이를 실패시켜 알림 확인.
- 회고: 분기마다 임계 재검토.
실패 테스트는 업무 시간 외에 예약하고 웹훅 스팸 억제 설정도 함께 확인하면 안심입니다.
JSONL 덧붙임 로그와 SIEM 용량 계산
분당 1줄이면 연간 약 52.5만 줄—웹훅 트레이스보다 작지만 gzip 로테는 JSONL 로테이션 가이드에 맞추세요.
SIEM으로 보낼 때 호스트명·테넌트 ID·프로브 이름을 필드화하고 전문 검색만에 의존하지 마세요.
모니터링·신뢰성 글과의 연결
프로브는 그레이스풀 셧다운 드릴과 짝을 이뤄 유지 창이 이중 알림을 키우지 않게 하고, 상류 LLM API가 흔들릴 때 프로바이더 백오프 가이드와 재시도 설계를 대조하세요.
FAQ
프로브에 인증을 붙일 수 있나요? 루프백 무인증을 선호. 필요하면 bearer를 launchd 환경에—저장소에 인라인 금지.
도쿄 관측자가 미 로그를 볼 때 RTT 예산은? 실측이 우선이며 태평양 횡단은 종종 120 ms를 넘습니다. 알림 파이프라인은 지터를 허용하게.
플릿을 늘리기 전에 무엇을 보나요? 모니터링 호스트가 포화되기 전 요금에서 용량 계획을.
프로브 앵커로 임대 Mac mini가 실용적인 이유
Apple Silicon 유휴 효율이 좋아 백그라운드 curl 비용이 낮습니다. 게이트웨이를 HK/JP/KR/SG/US에 나누면 지역 장애를 분리하고 단일 미니에 프로브 카디널리티를 두 배로 안 해도 됩니다.
