Konduo Manual

한국어

English

한국어

English

Appearance

Milvus 플러그인 ​

기본 접근성 관측 ​

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

현재 확인 범위는 TCP 연결이며 API 인증이나 검색·쓰기 가능 여부는 보장하지 않습니다. 배포 전체 관측 범위는 대상 요약에서 별도로 확인합니다.

TLS ​

사설 CA를 신뢰하려면 tls_ca_pem을 입력하세요. 상호 TLS에는 PEM 형식의 tls_client_cert와 tls_client_key를 함께 입력합니다. 연결 주소와 인증서 DNS 이름이 다르면 tls_server_name을 지정하세요. tls_insecure_skip_verify를 켜면 암호화는 유지하면서 서버 인증서 검증을 생략하며, 기본값은 꺼짐입니다.

개요는 작은 디스크 사용률 값 하나와 검색 QPS·지연·대기열 추세 3개를 함께 보여줍니다. 컬렉션 및 백그라운드 작업은 컬렉션·노드 비교를 2열로, 쓰기·적체 추세를 3열로 표시합니다. 전체 11개 패널 키와 저장 배치를 유지하며 컬렉션 필터·미지원·부분 실패 의미는 변경하지 않습니다.

개수는 정수로 표시하고 단위 변환된 바이트 용량, 속도, 지연 시간은 필요한 소수 자릿수를 유지합니다. 디스크 사용률은 명시적인 0–100 백분율 게이지를 사용합니다. 비율 입력 누락, 미지원 익스포터 메트릭, 부분 조회는 알 수 없음으로 유지합니다.

Milvus 플러그인은 벡터 데이터베이스 운영 상태를 Konduo 리소스로 등록합니다. 검색 지연, 쿼리 대기열, 삽입/쓰기 경로, 컬렉션 적재, 병합/인덱스/가져오기 적체, 노드 메모리 같은 Milvus 특화 신호를 제공합니다.

특징 ​

  • 엔드포인트 연결성과 TLS/인증 설정을 제한된 상태 점검으로 검증합니다.
  • Prometheus 메트릭 소스를 통해 Milvus 논리 메트릭을 조회합니다.
  • 대시보드는 검색 제공, 컬렉션 적재, 쓰기 지연, 백그라운드 적체, 용량 위험 중심입니다.
  • 진단은 검색 제공 저하, 쓰기 경로 지연, 백그라운드 적체, 용량 위험을 운영 관점으로 묶습니다.

등록 전 확인 ​

  • Milvus 엔드포인트, 데이터베이스, 사용자 이름/비밀번호 또는 토큰, TLS 설정을 준비합니다.
  • 메트릭 라벨 필터가 대상 Milvus 배포만 선택하는지 확인합니다.
  • Milvus 메트릭 이름과 라벨은 배포 방식에 따라 다를 수 있으므로 매핑팩 적용 후 패널 수집 범위를 확인합니다.

운영 팁 ​

  • 검색 지연과 쿼리 대기열은 컬렉션 로드, 세그먼트 상태, 쿼리 노드 메모리와 함께 봅니다.
  • 쓰기 경로 지연은 삽입 비율, 플러시 지연, 시간 틱 지연, 병합 적체를 같이 확인합니다.
  • 임의 컬렉션 변경이나 데이터 작업은 현재 CE 운영 경계가 아닙니다.

운영 화면 ​

  • 개요 화면은 엔드포인트 연결성, 메트릭 수집 범위, 컬렉션 적재 상태, 주요 검색 제공/쓰기 위험을 요약합니다.
  • 대시보드는 검색 지연, 쿼리 노드 압박, 삽입 처리량, flush 지연, time tick 지연, 압축/인덱스/가져오기 적체를 시각화합니다.
  • 컬렉션 근거는 운영자가 적재 상태와 검색 제공 영향을 판단하는 보조 정보로 사용합니다.
  • 진단은 검색 제공, 쓰기 경로, 백그라운드 작업, 용량 위험을 나눠 원인 후보를 좁힙니다.

진단과 알림 관점 ​

  • Milvus 장애는 쿼리 노드, 데이터 노드, 프록시, 코디네이터, 저장소 의존성 신호가 함께 나타날 수 있으므로 단일 지표로 판단하지 않습니다.
  • 알림 규칙은 검색 지연, 쿼리 대기열, 쓰기 거부, 데이터 유입 지연, 플러시 지연, 병합 적체, 인덱스/가져오기 적체, 노드 메모리 압박을 중심으로 합니다.
  • 메트릭 라벨은 Milvus 배포 방식과 익스포터 버전에 따라 달라질 수 있으므로 매핑팩과 라벨 필터 확인이 중요합니다.
  • P95와 P99 지연은 히스토그램 버킷이 있어야 계산할 수 있습니다. 버킷이 없으면 백분위 값을 표시하지 않으며, 산술 평균이 필요한 경우에만 별도 표기된 검색 평균을 사용합니다.
  • 메트릭 소스가 없으면 Milvus 특화 성능 판단은 제한되고 엔드포인트 접근 가능성 중심 근거만 남습니다.

관리 경계 ​

  • 컬렉션 생성/삭제/적재/해제, 인덱스 빌드, 데이터 가져오기/내보내기 같은 데이터 조작은 CE 플러그인 관리 범위가 아닙니다.
  • 플러그인은 운영 상태와 위험 신호를 관찰하고, 변경 작업은 Milvus 운영 절차와 권한 체계에서 수행하도록 경계를 둡니다.
  • 토큰과 TLS 설정은 민감 정보 경계 안에서만 사용합니다.
  • 백그라운드 적체가 높다고 해서 자동 병합이나 인덱스 재구성을 실행하지 않습니다.

대표 시나리오 ​

  • 검색 지연이 증가하면 쿼리 대기열, 컬렉션 로드, 세그먼트 수, 쿼리 노드 메모리, CPU 압박을 함께 봅니다.
  • 삽입/쓰기 지연은 삽입 처리량, 쓰기 거부, time tick 지연, flush 저장 지연, object storage 상태를 묶어 확인합니다.
  • 병합 적체가 쌓이면 세그먼트 증가, 쓰기 트래픽, 병합 작업 상태, 노드 자원 압박을 비교합니다.
  • 컬렉션 로드 문제가 의심되면 로드 상태, 쿼리 노드 분포, 메모리 압박, 최근 배포 변경을 확인합니다.

매핑 관측 정책: 실제 요청률 0은 이전 버전 후보보다 우선합니다. rate 계산에 표본이 부족한 새 카운터나 부재·오래된 소스는 사용 불가로 남습니다. Proxy 요청 후보는 존재 여부로 선택하며, query-node 내부 분산 요청 건수를 클라이언트 QPS로, partition 수를 segment 수로 대체하지 않습니다. 성공 카운터만 제공하는 버전의 이전 후보는 성공 요청률을 나타냅니다. 평균 지연과 용량 비율에는 양수 분모가 필요하며 무트래픽은 지연 0을 의미하지 않습니다.

Milvus Enterprise 확장 ​

기본 접근성 관측 ​

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

현재 확인 범위는 TCP 연결이며 API 인증이나 검색·쓰기 가능 여부는 보장하지 않습니다. 배포 전체 관측 범위는 대상 요약에서 별도로 확인합니다.

TLS ​

사설 CA를 신뢰하려면 tls_ca_pem을 입력하세요. 상호 TLS에는 PEM 형식의 tls_client_cert와 tls_client_key를 함께 입력합니다. 연결 주소와 인증서 DNS 이름이 다르면 tls_server_name을 지정하세요. tls_insecure_skip_verify를 켜면 암호화는 유지하면서 서버 인증서 검증을 생략하며, 기본값은 꺼짐입니다.

개요는 작은 디스크 사용률 값 하나와 검색 QPS·지연·대기열 추세 3개를 함께 보여줍니다. 컬렉션 및 백그라운드 작업은 컬렉션·노드 비교를 2열로, 쓰기·적체 추세를 3열로 표시합니다. 전체 11개 패널 키와 저장 배치를 유지하며 컬렉션 필터·미지원·부분 실패 의미는 변경하지 않습니다.

개수는 정수로 표시하고 단위 변환된 바이트 용량, 속도, 지연 시간은 필요한 소수 자릿수를 유지합니다. 디스크 사용률은 명시적인 0–100 백분율 게이지를 사용합니다. 비율 입력 누락, 미지원 익스포터 메트릭, 부분 조회는 알 수 없음으로 유지합니다.

Milvus Enterprise 확장은 Milvus 리소스에 MCP 설명자, 고급 진단, 메트릭 매핑, 이상 징후 규칙을 추가합니다. 컬렉션, 인덱스, 쿼리 노드, 데이터 노드 상태를 읽기 중심 근거로 모아 벡터 데이터베이스 운영 상태를 설명합니다.

메트릭 해석 ​

  • P95와 P99 지연은 히스토그램 버킷이 있어야 계산할 수 있습니다. 버킷이 없으면 백분위 값을 표시하지 않으며, 산술 평균이 필요한 경우에만 별도 표기된 검색 평균을 사용합니다.

특징 ​

  • MCP에서 리소스 메타데이터, 모니터링 개요, 토폴로지, 진단, 메트릭 매핑, 알림/이상 징후 규칙을 제공합니다.
  • 진단은 컬렉션/인덱스/쿼리 노드 상태와 메트릭 수집 범위를 운영자 근거로 정리합니다.
  • 이상 징후 규칙은 선언형 메트릭 방식으로 Milvus 논리 메트릭을 메트릭 소스에 연결합니다.
  • 기본 동작은 읽기 전용 진단이며, 상태 변경 작업은 별도 작업 경로와 권한 경계가 필요합니다.

등록 전 확인 ​

  • Community Milvus 연결과 인증 설정이 정상이어야 합니다.
  • Prometheus 메트릭 소스와 Milvus 매핑팩을 연결합니다.
  • MCP 사용자는 리소스 읽기 권한과 필요한 범위를 가져야 합니다.

운영 팁 ​

  • 검색 지연, 인덱스 상태, 쿼리 노드 압박은 컬렉션 규모와 워크로드 변화와 함께 봅니다.
  • 진단 결과가 부족하면 메트릭 엔드포인트 노출과 매핑팩 적용 상태를 먼저 확인합니다.

운영 시나리오 ​

  • 벡터 검색 지연이 증가하면 쿼리 노드 압박, 컬렉션 크기, 인덱스 빌드 상태, 세그먼트/로드 상태를 함께 확인합니다.
  • 컬렉션이나 인덱스 작업 후 성능이 달라졌다면 토폴로지 근거와 메트릭 수집 범위를 비교해 워크로드 변화인지 인프라 병목인지 구분합니다.
  • MCP 진단은 RAG/AI 서비스 장애 분석에서 Milvus 상태를 다른 리소스 근거와 연결하는 읽기 전용 맥락으로 사용합니다.

경계 ​

  • EE 확장 계층은 고급 진단, 토폴로지 근거, 이상 징후 메타데이터를 추가하며 컬렉션/인덱스 변경 같은 상태 변경은 별도 작업 경로가 있을 때만 수행합니다.
  • 메트릭 소스가 없으면 이상 징후 규칙은 의미 있게 평가되지 않으며, 부족한 근거를 정상 상태로 추정하지 않습니다.

매핑 관측 정책: 실제 요청률 0은 이전 버전 후보보다 우선합니다. rate 계산에 표본이 부족한 새 카운터나 부재·오래된 소스는 사용 불가로 남습니다. Proxy 요청 후보는 존재 여부로 선택하며, query-node 내부 분산 요청 건수를 클라이언트 QPS로, partition 수를 segment 수로 대체하지 않습니다. 성공 카운터만 제공하는 버전의 이전 후보는 성공 요청률을 나타냅니다. 평균 지연과 용량 비율에는 양수 분모가 필요하며 무트래픽은 지연 0을 의미하지 않습니다.

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 ​

The existing closed diagnostic inputs retain check_key, suspected_collection, metric_source_id, and bounded lookback choices. Topology and static rule tools accept {}. Metric resolution requires a nonempty catalog key and preserves its supported selector and time inputs; mapping resolution defaults to Prometheus.

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에 정의되어 있습니다.