17.2 Zenoh 내장 도구를 활용한 기본 상태 점검

복잡한 범용 모니터링 시스템(예: Prometheus, Elasticsearch)을 인프라에 전면 도입하기 전, 아키텍트가 확보할 수 있는 가장 신속하고 직관적인 진단 수단은 Zenoh 데몬이 자체적으로 내장하고 있는 관리 공간(Admin Space)과 CLI 도구의 활용이다.

이러한 내장 도구(Native Tools)들은 소프트웨어 풋프린트(Footprint)의 추가적인 확장 없이, 단일 터미널 명령어와 REST API 스펙만으로 분산 시스템의 논리적 토폴로지(Topology)와 연결 세션(Session)의 상태를 실시간으로 가시화한다. 외부의 무거운 감시 에이전트를 적재하기에 앞서, 내장된 텔레메트리(Telemetry)를 이용해 Zenoh 코어 라우터의 건전성(Health)을 진단하는 런북(Runbook)을 전개한다.

1. Admin Space(`@/router/`)의 이해와 활용

Zenoh 라우터는 일반적인 애플리케이션 데이터 토픽(예: robot/sensor) 외에도, 라우터 프로세스 내부의 환경 설정 내역과 실시간 런타임 상태 데이터를 예약된 별도의 키 공간(Key Space)에 지속적으로 발행(Publish)한다. 이 숨겨진 논리적 영역이 바로 관리 공간(Admin Space, @/*) 이다.

1. @/router 공간의 상태 정보 구독 (State Subscription)
해당 예약 토픽을 명시적으로 구독(Subscribe)함으로써 운영자는 텔레메트리 수집 에이전트 없이도 라우터의 세션 정보와 빌드 버전을 즉각 산출할 수 있다.

# 로컬 라우터를 대상으로 관리 공간의 전체 서브트리 형상을 질의한다.
z_get "@/**"

2. 런타임 설정의 동적 갱신 (Hot-Reloading)
Admin Space의 아키텍처적 특이점은 상태 정보의 판독(Read, Get)에 국한되지 않고, 상태의 변이(Write, Put)를 허용한다는 데 있다. 이를 통해 데몬 프로세스의 중지 없이 런타임 중에 핵심 환경 변수를 동적으로 교체(Hot-Reload)할 수 있다.

# 라우터 데몬 재시작(Zero-Downtime) 없이 즉각적으로 내부 로깅 레벨을 debug 모드로 승급시킨다.
z_put "@/router/local/config/logging/level" "debug"

가용성(Availability)이 극도로 중시되는 에지(Edge) 인프라 환경에서 프로세스 재시작(Restart)은 곧 치명적인 서비스 단절(Outage)로 직결된다. Admin Space 인터페이스의 제어권 확보는 무중단(Zero-Downtime) 관제를 달성하기 위한 필수 역량이다.

2. Admin Space REST API를 통한 실시간 상태 조회

네이티브 Zenoh CLI(z_get) 바이너리가 부재하거나 설치가 곤란한 원격지의 씬 클라이언트(Thin Client), 웹 브라우저, 나아가 중앙 집중형 관제 웹 백엔드 시스템(Node.js, Spring)에서 데몬 상태를 수집하기 위해서는, 무거운 네이티브 라이브러리의 바인딩보다 표준 HTTP 프로토콜을 경유하는 것이 아키텍처 결합도(Coupling)를 낮추는 효과적인 대안이다.

1. 라우터 설정(Configuration) 덤프 추출
Zenoh 라우터 기동 시 기본 바인딩되는 REST 관리 API 포트(초기값 TCP 8000)를 활용하여 HTTP GET 요청을 오프로딩(Offloading)한다.

# 라우터의 코어 설정 파라미터 계층을 JSON 직렬화 구조로 반환받는다.
curl http://localhost:8000/@/router/local/config

2. 라우팅 테이블(Routing Table) 및 세션 맵 조회
외부 알람 서비스(예: Slack Bot)나 관제 대시보드에서 동적 라우팅 스냅샷을 수집하는 데 최적화된 엔드포인트다.

# 라우터 데몬이 현재 유지하고 있는 활성 통신 세션의 리스트를 추출한다.
curl http://localhost:8000/@/router/local/sessions

이러한 REST API 노출면을 사내 인트라넷 기반의 모니터링 프론트엔드(React, Vue.js)와 직접 연동하면, 복잡한 미들웨어 없이 즉각적인 1차 경고(Alert) 대시보드를 구축하는 것이 가능해진다.

3. zenoh-cli를 이용한 네트워크 토폴로지 점검

에지 로봇 단말(A)이 발송한 페이로드가 중계 라우터(B)를 경유하여 중앙 서버(C)로 인입되는 다단 중계 경로(Multi-Hop Path)에서 병목 현상 발생 시, 네트워크의 물리적 결선 상태를 추상화한 논리적 계층 모델, 즉 ’토폴로지 별자리(Topology Map)’를 단면적으로 검증해야 한다.

1. 이웃 노드(Neighbor Nodes) 탐색기 가동
가장 직관적인 네트워크 진단 방식은 말단 에지 환경의 셸(Shell)에서 대상 노드가 브릿지하고 있는 다음 홉(Next-Hop)의 주소를 직접 해부하는 것이다.

# 현재 노드가 피어링(Peering) 중인 모든 인접 라우터의 IP 체계와 고유 세션 ID를 나열한다.
z_get "@/router/local/sessions/link/**"

2. 스플릿 브레인(Split-Brain) 및 통신 단절 증명 (Isolation Detection)
물리적으로 분리된 구역(예: 공장의 Zone 1 구간과 Zone 2 구간) 간의 라우팅 브릿지가 단절된 경우, 각 브릿지는 자기 자신을 정상 클러스터로 오판하는 스플릿 브레인 현상이 유발된다.
이러한 상황에서는 코어 라우터 측 관리 콘솔에서 sessions 목록의 부분 문자열을 스캔하여(예: grep), Zone 1을 단지하는 특정 Peer_ID의 실존 여부만을 판별함으로써 백본(Backbone) 네트워크의 횡단 단절 사태를 즉각 증명할 수 있다.

4. 라우터 및 피어 연결 상태와 세션 텔레메트리 파악

라우터에 바인딩된 각 객체가 동등 계층의 피어(Peer) 노드인지, 혹은 단순 클라이언트(Client) 노드인지 식별하고 해당 세션들이 유발하는 트래픽 점유율을 도출하는 텔레메트리(Telemetry) 런북이다.

1. 세션의 정체 식별 (Identity Resolution)
Admin Space는 연결된 개별 세션의 역할 모델과 물리적 주소를 실시간 속성으로 유지한다.

# 라우터에 접속된 활성 세션의 메타데이터 블록을 해체한다.
z_get "@/router/local/sessions/*"
# 반환 데이터 구조 예시: [Session: xxx, WhatAmI: Client, Locators: tcp/10.0.0.5:45677]

2. 트래픽 오남용 노드(Traffic Hog) 색출 로직
단일 로보틱스 단말이 발행 주기를 상실하고 임계 대역폭을 초과하는 대규모 메시지를 무분별하게 퍼블리싱(Traffic Flooding)하여 전체 릴레이 자원을 선점하는 장애 상황을 시뮬레이션한다.

# 개별 활성 세션 객체들의 수신(RX) 및 송신(TX) 바이트 누적 카운터를 포착한다.
curl http://localhost:8000/@/router/local/sessions/*/metrics

수집된 JSON 배열 내에서 정상적인 범주(rx_bytes: 1540)를 기형적으로 이탈한 절대값(rx_bytes: 9999999999)을 기록 중인 특정 Session_ID를 색인한다. 해당 세션 키에 연계된 클라이언트 IP 노드가 결과적으로 대역폭 고갈(Bandwidth Starvation)을 유발하는 시스템 내 좀비(Zombie) 프로세스임을 확정 지을 수 있다.

graph TD
    classDef router fill:#e1f5fe,stroke:#0277bd,stroke-width:2px;
    classDef client fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px;
    classDef admin fill:#f3e5f5,stroke:#6a1b9a,stroke-width:2px;
    classDef anomaly fill:#ffebee,stroke:#c62828,stroke-width:2px;

    Router[Zenoh Router Daemon]:::router
    
    subgraph Admin_Space [Admin Space `@/router/local/**`]
        Config[`config`: Logging Level, Ports]:::admin
        Sessions[`sessions`: Hop Info, Peer IDs]:::admin
        Metrics[`metrics`: RX/TX Bytes]:::admin
    end
    
    Router --> Admin_Space
    
    ClientA[Sensor Client A<br>rx: 1,500]:::client
    ClientB[Sensor Client B<br>rx: 1,400]:::client
    ClientZombie[Traffic Hog Client<br>rx: 9,999,999]:::anomaly
    
    ClientA -- z_put --> Router
    ClientB -- z_put --> Router
    ClientZombie -- Flood z_put --> Router
    
    Monitoring[curl / REST API]:::admin -.-> |Detect Outlier| Metrics
    Monitoring -.-> |Find IP| Sessions

17.2 Zenoh 내장 도구를 활용한 기본 상태 점검

1. Admin Space(@/router/)의 이해와 활용

2. Admin Space REST API를 통한 실시간 상태 조회

3. zenoh-cli를 이용한 네트워크 토폴로지 점검

4. 라우터 및 피어 연결 상태와 세션 텔레메트리 파악

1. Admin Space(`@/router/`)의 이해와 활용