Konduo Manual

한국어

English

한국어

English

Appearance

etcd 플러그인 ​

기본 접근성 관측 ​

리소스 개요는 메트릭 소스와 별개로 접근 가능·접근 불가·접근 미확인을 표시합니다. 성공한 접속 확인은 전체 멤버, 복제, 파티션이나 작업의 정상 상태를 보장하지 않습니다. 구체적인 도메인 상태는 진단과 도메인 경보에서 확인합니다. 기존 liveness/readiness 정보는 도메인 상세 증거이며 기본 접근성 경보의 조건이 아닙니다. 미확인은 발생 중인 경보를 복구시키지 않습니다.

리소스 요약에서 등록한 접속 주소와 발견된 주소를 구분합니다. 전체 주소 보기에서 전체 URL을 확인하고 복사할 수 있습니다. Service/LB 주소는 접속 경로이며 추가 노드가 아닙니다. 엔드포인트 진단은 주소 출처를 표시하며, 멤버 화면에서 멤버 ID와 역할을 확인합니다.

리더 현재 값은 4열 두 행의 클러스터 추세 8개와 분리합니다. 멤버 비교는 2열, 요청 처리량은 3열, 피어 비교는 전체 폭으로 표시합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

리더 카드는 관측된 1과 0만 각각 리더 선출됨과 리더 없음으로 표시합니다. 값이 없거나 예상하지 못한 값은 알 수 없음으로 유지합니다. 개수는 정수로 표시하고 단위 변환된 바이트, 속도, 지연 시간은 필요한 소수 자릿수를 유지하며 노드 합계와 최악 노드 요약은 패널에 선언된 집계를 사용합니다.

etcd 플러그인은 etcd 클러스터를 하나의 Konduo 리소스로 등록하고 멤버, 엔드포인트, 알람, 제안 처리, MVCC DB 크기, 피어/네트워크 신호를 운영 화면에 제공합니다.

특징 ​

  • HTTP 게이트웨이와 etcd v3 gRPC 클라이언트 경로를 모두 사용해 멤버, 상태, 알람 근거를 수집합니다.
  • 클러스터 멤버 발견, 리더, 학습자, 엔드포인트 상태, HashKV, NOSPACE 알람 정보를 진단에 연결합니다.
  • Prometheus 매핑팩과 Konduo 관리형 메트릭 수집을 지원합니다.
  • 압축, 조각 모음, 알람 해제, 스냅샷, 리더 이전 같은 복구 보조 작업은 확인과 대기 시간으로 보호됩니다.

등록 전 확인 ​

  • etcd 클라이언트 엔드포인트 목록, TLS/mTLS, 기본 인증, 제한 시간 설정을 준비합니다.
  • /metrics가 별도 리스너에 노출된다면 metric_collection_endpoints를 설정합니다.
  • 관리형 수집의 쓰기 대상으로 Prometheus를 사용할 경우 Prometheus를 --web.enable-remote-write-receiver 옵션으로 실행해야 합니다.
  • gRPC-only 환경에서는 상태 기반 일부 항목만 수집될 수 있으므로 p99 지연과 히스토그램 기반 패널 수집 범위를 확인합니다.

운영 팁 ​

  • 클라이언트 URL과 피어 URL은 의미가 다르므로 멤버 근거를 볼 때 구분합니다.
  • 게이트웨이 발견이 실패하면 대체 근거는 부분 상태로 해석합니다.
  • defrag와 compact는 멤버별 영향이 있으므로 revision, 대상 엔드포인트, 확인 문구를 확인한 뒤 실행합니다.

운영 화면 ​

  • 대시보드는 안정된 카탈로그 패널 키 26개를 유지하고 최초 배치에는 17개를 선택합니다. 개요는 리더 상태, 제안 처리 지연·실패, DB 용량, 디스크 지연을 강조하고, 멤버 비교와 제안·gRPC·피어 트래픽은 목적별 상세 하위 페이지로 분리합니다.
  • 이진 리더 신호는 1이면 OK, 0이면 FAIL입니다. 현재 상태 카드는 작은 폭으로, 집계 추세는 4열로, 라벨이 많은 멤버 비교는 절반 폭으로 표시합니다.
  • 자주 사용하지 않는 집계·멤버·피어 패널도 개인화 카탈로그에 남습니다. 기존 저장 레이아웃의 표시, 행 위치, 순서, 크기가 우선하며 쿼리 범위, 단위, 필터, 샘플링, 집계 의미는 바뀌지 않습니다.
  • 피어 상세 행은 처음에 접혀 있지만 쿼리와 실패 확인은 계속되므로 수집 또는 쿼리 오류가 초기 접힘 상태에 가려지지 않습니다.
  • 멤버 화면은 멤버 ID, 이름, 클라이언트/피어 URL, 리더/학습자 상태, 엔드포인트 상태를 함께 보여줍니다.
  • alarm 화면은 NOSPACE 같은 cluster alarm을 확인하고 disarm이 필요한지 판단하는 근거를 제공합니다.
  • 진단은 HashKV, 제안 처리, DB 크기, 쿼터, 피어/클라이언트 지연 근거를 묶어 클러스터 일관성과 용량 위험을 확인합니다.
  • 스냅샷, 압축, 조각 모음, 리더 이전 작업은 복구 보조 작업으로 제공되며 자동 운영 대신 확인 기반으로 실행됩니다.

진단과 알림 관점 ​

  • etcd 가용성은 엔드포인트 상태, 멤버 quorum, 리더 상태, 알람 상태를 함께 봐야 합니다.
  • 알림 규칙은 리더 손실, 제안 처리 실패, DB 쿼터 압박, 피어/클라이언트 지연, NOSPACE 알람 같은 etcd 도메인 위험을 다룹니다.
  • 관리형 수집과 Prometheus 매핑팩 모두 멤버별 라벨이 중요하므로 엔드포인트/멤버 라벨 불일치를 부분 근거로 다룹니다.
  • HashKV 차이는 즉시 데이터 손상으로 단정하지 않고 revision, 엔드포인트, 멤버 상태와 함께 확인합니다.

관리 경계 ​

  • compact와 defrag는 성능과 저장소 상태에 영향을 줄 수 있으므로 멤버별 대상과 revision을 명확히 해야 합니다.
  • alarm disarm은 원인 제거 후 수행해야 하며, NOSPACE 상태에서 단순 disarm만 반복하지 않습니다.
  • 스냅샷은 복구 증거 확보용이며 백업 정책 전체를 대체하지 않습니다.
  • 멤버 추가/삭제나 클러스터 재구성 자동화는 CE 플러그인의 기본 관리 범위가 아닙니다.

대표 시나리오 ​

  • 리더 전환이나 장애가 의심되면 리더, 학습자, 엔드포인트 상태, 쿼럼 가능성을 먼저 확인합니다.
  • DB 크기가 할당량에 접근하면 압축 리비전, 조각 모음 후보 멤버, NOSPACE 알람 여부를 함께 봅니다.
  • 지연 경고가 발생하면 클라이언트 요청 지연과 피어 왕복 시간, 제안 대기/실패를 같이 확인합니다.
  • 멤버별 HashKV가 다르면 revision과 엔드포인트 상태를 맞춘 뒤 재확인하고, 필요한 경우 upstream etcd 운영 절차로 확장합니다.

Prometheus 매핑 주의: HashKV 일관성, learner 승격 가능 여부, 스냅샷 경과 시간, 유지보수 이력은 exporter가 제공하지 않는 운영 증적이 필요합니다. Prometheus 논리 메트릭 목록에서는 제공하지 않으며, 이전에 저장한 키를 조회하면 상수 성공이나 경과 시간 0 대신 사용 불가로 응답합니다. 해당 운영·진단 기능의 실제 증적을 확인하세요.

etcd Enterprise 확장 ​

기본 접근성 관측 ​

리소스 개요는 메트릭 소스와 별개로 접근 가능·접근 불가·접근 미확인을 표시합니다. 성공한 접속 확인은 전체 멤버, 복제, 파티션이나 작업의 정상 상태를 보장하지 않습니다. 구체적인 도메인 상태는 진단과 도메인 경보에서 확인합니다. 기존 liveness/readiness 정보는 도메인 상세 증거이며 기본 접근성 경보의 조건이 아닙니다. 미확인은 발생 중인 경보를 복구시키지 않습니다.

리소스 요약에서 등록한 접속 주소와 발견된 주소를 구분합니다. 전체 주소 보기에서 전체 URL을 확인하고 복사할 수 있습니다. Service/LB 주소는 접속 경로이며 추가 노드가 아닙니다. 엔드포인트 진단은 주소 출처를 표시하며, 멤버 화면에서 멤버 ID와 역할을 확인합니다. 이 Community 공통 동작은 Enterprise 요약에도 적용됩니다.

리더 현재 값은 4열 두 행의 클러스터 추세 8개와 분리합니다. 멤버 비교는 2열, 요청 처리량은 3열, 피어 비교는 전체 폭으로 표시합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

리더 카드는 관측된 1과 0만 각각 리더 선출됨과 리더 없음으로 표시합니다. 값이 없거나 예상하지 못한 값은 알 수 없음으로 유지합니다. 개수는 정수로 표시하고 단위 변환된 바이트, 속도, 지연 시간은 필요한 소수 자릿수를 유지하며 노드 합계와 최악 노드 요약은 패널에 선언된 집계를 사용합니다.

대시보드는 전체 26개 카탈로그 패널 중 17개를 기본 선택합니다. 개요에는 리더·제안·디스크 지연·DB 용량을 유지하고 멤버 비교와 트래픽 상세를 별도 페이지로 나눕니다. 멤버별 추세는 절반 폭을 사용하며 저장된 개인화가 우선합니다.

etcd Enterprise 확장은 Community etcd 플러그인 위에 MCP 설명자, 이상 징후 규칙, 플러그인 실행형 탐지기를 추가합니다. 쿼럼, 리더, 제안 처리, WAL/fsync 신호를 분석하여 클러스터 위험을 더 빠르게 드러내는 것이 목적입니다.

메트릭 해석 ​

  • 대시보드는 이진 리더 신호를 1이면 OK, 0이면 FAIL 상태값으로 표시하고, 불안정 원인을 확인할 시계열 패널을 함께 제공합니다.

특징 ​

  • MCP 카탈로그에서 etcd 리소스, 모니터링 개요, 진단, 메트릭 매핑, 이상 징후 규칙을 조회합니다.
  • 플러그인 실행형 이상 징후 탐지기는 etcd API 근거와 메트릭 근거를 함께 해석합니다.
  • 선언형 메트릭 규칙은 Prometheus 메트릭 소스를 통해 논리 메트릭 키를 해석합니다.
  • 시뮬레이터 고정 데이터는 리더 불안정, 쿼럼 위험, 디스크 지연, 제안 처리 적체 같은 시나리오를 검증합니다.

등록 전 확인 ​

  • Community etcd 연결과 TLS 설정이 정상이어야 합니다.
  • 이상 징후 분석에는 Prometheus 메트릭 소스와 매핑팩 연결이 필요합니다.
  • MCP 사용자는 읽기 범위와 리소스 접근 권한을 가져야 합니다.

운영 팁 ​

  • 리더 변경 빈도, 제안 처리 적체, fsync 지연을 한 신호만 보지 말고 쿼럼 상태와 함께 해석합니다.
  • 플러그인 탐지기 결과와 선언형 메트릭 규칙 결과가 다를 경우 메트릭 소스 수집 범위와 etcd API 접근 권한을 먼저 확인합니다.

운영 시나리오 ​

  • 제어 평면 장애가 의심될 때 리더 안정성, 쿼럼 멤버 상태, 제안 적용 적체를 함께 보아 쓰기 경로 위험을 판단합니다.
  • 디스크 지연이 커질 때 WAL fsync와 백엔드 커밋 지연을 분리해 저장소 병목인지 클러스터 합의 병목인지 구분합니다.
  • MCP 카탈로그는 장애 분석 에이전트가 etcd 상태, 메트릭 수집 범위, 이상 징후 규칙을 빠르게 훑는 읽기 전용 진입점으로 사용합니다.

경계 ​

  • 쿼럼 해석과 이상 징후 규칙 메타데이터는 EE 확장 계층에 두고, 공통 etcd 연결과 기본 상태 동작은 CE 플러그인에 둡니다.
  • 플러그인 모드 탐지기는 etcd API 근거가 필요한 규칙만 실행하며, 메트릭 임계값 규칙은 Core 선언형 평가기가 담당합니다.

Prometheus 매핑 주의: HashKV 일관성, learner 승격 가능 여부, 스냅샷 경과 시간, 유지보수 이력은 exporter가 제공하지 않는 운영 증적이 필요합니다. Prometheus 논리 메트릭 목록에서는 제공하지 않으며, 이전에 저장한 키를 조회하면 상수 성공이나 경과 시간 0 대신 사용 불가로 응답합니다. 해당 운영·진단 기능의 실제 증적을 확인하세요.

Enterprise 이상 징후 카탈로그는 멤버 불일치·학습자 정체·백업 신선도·유지보수 후 영향 패턴을 더 이상 등록하지 않습니다. 필요한 운영 증적이 Prometheus 메트릭으로 제공되지 않으며, learner의 존재만으로 동기화 실패나 승격 가능 여부를 판단할 수 없습니다. HashKV 확인, 멤버·learner 운영, 스냅샷 확인, 유지보수 이력 및 관련 진단·MCP 경로는 유지하므로 조사할 때 해당 실제 결과를 확인하세요.

저장된 재정의 설정으로 제거된 기본 규칙을 다시 활성화할 수 없습니다. 기존 발생 상태는 새 평가 없이 과거 관측으로 유지하며, 규칙 제거만으로 해결 처리하거나 복구를 입증하지 않습니다. 이전 상태를 검토할 때 관측 시각과 현재 운영 증적을 함께 확인하세요.

MCP diagnostic execution effects ​

The run_diagnostics tool changes diagnostic execution and cooldown state. Its descriptor declares operation_class: diagnostic_lifecycle; MCP advertises readOnlyHint=false, destructiveHint=false and idempotentHint=false. Diagnostic queries retain read-only hints. Both queries and actions continue to require mcp:invoke and the existing resource permissions/audit checks. Safety hints do not change authorization or guarantee safe retries.

MCP tool input contracts ​

Alarm inventory, hash-KV inspection, failover planning, static catalogs, and the diagnostic refresh action accept {}. Summary/history and monitoring expose the metric source and lookback inputs they consume. Member and topology tools expose topology_host_map_json, a JSON object mapping members to host resource instances. Dynamic metric selector and request aliases remain supported on their owning routes.

The advertised JSON Schema is checked before plugin dispatch. Omitted optional values retain plugin defaults. Arguments do not replace resource-instance authorization; stored connection credentials are supplied by Konduo. Open schemas are retained only for existing dynamic filters or aliases, and each advertised property describes its caller-facing meaning. Plugin result shapes can vary with product/version, available evidence, and partial failures; no stable outputSchema is promised for these dynamic responses. 클라이언트와 리소스 지원 범위는 Enterprise 소스 저장소의 enterprise/backend/docs/plugin-contract.md에 정의되어 있습니다.