etcd 플러그인
etcd 플러그인은 etcd cluster를 하나의 Konduo 리소스로 등록하고 member, endpoint, alarm, proposal, MVCC DB size, peer/network 신호를 운영 화면에 제공합니다.
특징
- HTTP gateway와 etcd v3 gRPC client 경로를 모두 사용해 member, status, alarm evidence를 수집합니다.
- cluster member discovery, leader, learner, endpoint health, HashKV, NOSPACE alarm 정보를 진단에 연결합니다.
- Prometheus mapping pack과 Konduo-managed metric collection을 지원합니다.
- compact, defrag, alarm disarm, snapshot, leader transfer 같은 복구 보조 작업은 확인과 cooldown으로 보호됩니다.
등록 전 확인
- etcd client endpoint 목록, TLS/mTLS, basic auth, timeout 설정을 준비합니다.
/metrics가 별도 listener에 노출된다면metric_collection_endpoints를 설정합니다.- gRPC-only 환경에서는 status-derived subset만 수집될 수 있으므로 p99 latency와 histogram 기반 panel coverage를 확인합니다.
운영 팁
- client URL과 peer URL은 의미가 다르므로 member evidence를 볼 때 구분합니다.
- gateway discovery가 실패하면 fallback evidence는 partial로 해석합니다.
- defrag와 compact는 member별 영향이 있으므로 revision, target endpoint, confirmation을 확인한 뒤 실행합니다.
etcd Enterprise 확장
etcd Enterprise 확장은 Community etcd 플러그인 위에 MCP descriptor, 이상 징후 규칙, plugin 실행형 detector를 추가합니다. quorum, leader, proposal, WAL/fsync 신호를 분석하여 클러스터 위험을 더 빠르게 드러내는 것이 목적입니다.
특징
- MCP catalog에서 etcd 리소스, monitoring overview, diagnostics, metrics mapping, anomaly rule을 조회합니다.
- plugin 실행형 anomaly detector는 etcd API evidence와 metric evidence를 함께 해석합니다.
- declarative metric 규칙은 Prometheus metric source를 통해 logical metric key를 해석합니다.
- simulator fixture는 leader instability, quorum risk, disk latency, proposal backlog 같은 시나리오를 검증합니다.
등록 전 확인
- Community etcd 연결과 TLS 설정이 정상이어야 합니다.
- anomaly 분석에는 Prometheus metric source와 mapping pack 연결이 필요합니다.
- MCP 사용자는 읽기 scope와 리소스 접근 권한을 가져야 합니다.
운영 팁
- leader 변경 빈도, proposal backlog, fsync latency를 한 신호만 보지 말고 quorum 상태와 함께 해석합니다.
- plugin detector 결과와 declarative metric rule 결과가 다를 경우 metric source coverage와 etcd API 접근 권한을 먼저 확인합니다.