2026 OpenClaw MeshMac 실전: 게이트웨이 스트리밍 이후 다중 노드 동시 세션 상한·백프레셔 임계·백오프 재시도 병합 알림

스트리밍·다채널이 겹칠 때의 통증

1. 좌석 점유가 길어짐 — 청크 스트림은 도구 호출이 끝날 때까지 한 연결을 묶으므로, 비스트리밍 시절과 같은 RPS만 보면 곧바로 fd·스레드 한도에 닿습니다.
2. 채널별 팬인이 조용히 합산 — v2026.3.x는 채팅·웹훅·내부 워커가 병렬 논리 경로로 붙을 수 있어, 채널별 서브캡이 없으면 한 커넥터가 공유 실행기를 고갈시킵니다.
3. 재시도가 파도를 만듦 — Retry-After를 지켜도 클라이언트 군집은 같은 타이밍에 다시 밀어 옵니다. 병합 없이는 동일 원인의 알림만 수십 건으로 터집니다.

v2026.3.x 스트리밍과 다중 메시지 채널 배경

게이트웨이는 어시스턴트 출력을 스트리밍하면서도 인바운드 메시지를 계속 받습니다. 각 경로를 route_class로 태깅하고, 토큰 버킷·세션 상한은 게이트웨이 rate limit·세션 동시성 HowTo와 같은 표에 적습니다. 스트리밍 카드 UX는 Teams 스트리밍형 요약, VIP·복제 배치는 로드밸런싱·페일오버 단계를 함께 보세요.

태스크 큐·재시도를 게이트 셰딩 순서와 맞추면 부분 작업 누적을 줄입니다.

결정 표: 세션 상한·백프레셔·병합 알림

Lab에서 재측정·날짜 기입. fd 여유 ≥20%.

재현 배포·튜닝 단계

1. 토폴로지 고정 — LB 뒤 논리 게이트 한 벌, 복제마다 gateway_instance_id를 노출하고 v2026.3.x 스트리밍 플래그를 동일하게 싱크합니다.
2. 관측 먼저 — 청크 지연 히스토그램·아웃바운드 버퍼 사용률·활성 스트림 수를 route_class·mesh_node_id로 쪼개 한도 변경 전 베이스라인을 남깁니다.
3. 노드별 세션 천장 — 자동화 호스트가 동시에 열 수 있는 스트림 수를 표보다 낮게 두고, 메시 합이 글로벌 세마포 아래인지 검증합니다.
4. 점진 셰딩 — 백프레셔 시 신규 대화형 스트림만 멈추고 진행 중 도구는 마무리, 이후 토큰 리필 축소, 마지막에 503·Retry-After로 신규 입장을 거절합니다.
5. 병합 알림 배선 — 구조화 로그에 tenant_id·limit_name·http_status를 넣고 파이프라인에서 슬라이딩 윈도로 접어 지수 백오프 폭주를 한 문구로 표시합니다.
6. 카오스 드릴 — 두 노드에서 스트림을 겹치게 열고 웹훅 버스트를 재생해 셰딩 순서·병합 인시던트·해소 후 회복을 녹화합니다.

런북에 붙일 기준값

• 게이트 스트리밍 천장: TLS·업스트림·옵저버빌리티 소켓을 합산한 뒤 커널 fd 한도의 최소 20% 헤드룸.
• 웹훅 클래스 토큰 버킷: 스트리밍 켠 뒤 지속 5~15 rps부터 시작해 rate limit HowTo의 다크런 카운터로 조정.
• 온콜 신호: 단일 노드 스파이크가 아니라 병합 창에서 SLO를 연속으로 깰 때만 페이지.

FAQ