Milvus 플러그인
Milvus 플러그인은 벡터 데이터베이스 운영 상태를 Konduo 리소스로 등록합니다. 검색 지연, 쿼리 대기열, 삽입/쓰기 경로, 컬렉션 적재, 병합/인덱스/가져오기 적체, 노드 메모리 같은 Milvus 특화 신호를 제공합니다.
특징
- 엔드포인트 연결성과 TLS/인증 설정을 제한된 상태 점검으로 검증합니다.
- Prometheus 메트릭 소스를 통해 Milvus 논리 메트릭을 조회합니다.
- 대시보드는 검색 제공, 컬렉션 적재, 쓰기 지연, 백그라운드 적체, 용량 위험 중심입니다.
- 진단은 검색 제공 저하, 쓰기 경로 지연, 백그라운드 적체, 용량 위험을 운영 관점으로 묶습니다.
등록 전 확인
- Milvus 엔드포인트, 데이터베이스, 사용자 이름/비밀번호 또는 토큰, TLS 설정을 준비합니다.
- 메트릭 라벨 필터가 대상 Milvus 배포만 선택하는지 확인합니다.
- Milvus 메트릭 이름과 라벨은 배포 방식에 따라 다를 수 있으므로 매핑팩 적용 후 패널 수집 범위를 확인합니다.
운영 팁
- 검색 지연과 쿼리 대기열은 컬렉션 로드, 세그먼트 상태, 쿼리 노드 메모리와 함께 봅니다.
- 쓰기 경로 지연은 삽입 비율, 플러시 지연, 시간 틱 지연, 병합 적체를 같이 확인합니다.
- 임의 컬렉션 변경이나 데이터 작업은 현재 CE 운영 경계가 아닙니다.
운영 화면
- 개요 화면은 엔드포인트 연결성, 메트릭 수집 범위, 컬렉션 적재 상태, 주요 검색 제공/쓰기 위험을 요약합니다.
- 대시보드는 검색 지연, 쿼리 노드 압박, 삽입 처리량, flush 지연, time tick 지연, 압축/인덱스/가져오기 적체를 시각화합니다.
- 컬렉션 근거는 운영자가 적재 상태와 검색 제공 영향을 판단하는 보조 정보로 사용합니다.
- 진단은 검색 제공, 쓰기 경로, 백그라운드 작업, 용량 위험을 나눠 원인 후보를 좁힙니다.
진단과 알림 관점
- Milvus 장애는 쿼리 노드, 데이터 노드, 프록시, 코디네이터, 저장소 의존성 신호가 함께 나타날 수 있으므로 단일 지표로 판단하지 않습니다.
- 알림 규칙은 검색 지연, 쿼리 대기열, 쓰기 거부, 데이터 유입 지연, 플러시 지연, 병합 적체, 인덱스/가져오기 적체, 노드 메모리 압박을 중심으로 합니다.
- 메트릭 라벨은 Milvus 배포 방식과 익스포터 버전에 따라 달라질 수 있으므로 매핑팩과 라벨 필터 확인이 중요합니다.
- 메트릭 소스가 없으면 Milvus 특화 성능 판단은 제한되고 엔드포인트 접근 가능성 중심 근거만 남습니다.
관리 경계
- 컬렉션 생성/삭제/적재/해제, 인덱스 빌드, 데이터 가져오기/내보내기 같은 데이터 조작은 CE 플러그인 관리 범위가 아닙니다.
- 플러그인은 운영 상태와 위험 신호를 관찰하고, 변경 작업은 Milvus 운영 절차와 권한 체계에서 수행하도록 경계를 둡니다.
- 토큰과 TLS 설정은 민감 정보 경계 안에서만 사용합니다.
- 백그라운드 적체가 높다고 해서 자동 병합이나 인덱스 재구성을 실행하지 않습니다.
대표 시나리오
- 검색 지연이 증가하면 쿼리 대기열, 컬렉션 로드, 세그먼트 수, 쿼리 노드 메모리, CPU 압박을 함께 봅니다.
- 삽입/쓰기 지연은 삽입 처리량, 쓰기 거부, time tick 지연, flush 저장 지연, object storage 상태를 묶어 확인합니다.
- 병합 적체가 쌓이면 세그먼트 증가, 쓰기 트래픽, 병합 작업 상태, 노드 자원 압박을 비교합니다.
- 컬렉션 로드 문제가 의심되면 로드 상태, 쿼리 노드 분포, 메모리 압박, 최근 배포 변경을 확인합니다.
Milvus Enterprise 확장
Milvus Enterprise 확장은 Milvus 리소스에 MCP 설명자, 고급 진단, 메트릭 매핑, 이상 징후 규칙을 추가합니다. 컬렉션, 인덱스, 쿼리 노드, 데이터 노드 상태를 읽기 중심 근거로 모아 벡터 데이터베이스 운영 상태를 설명합니다.
특징
- MCP에서 리소스 메타데이터, 모니터링 개요, 토폴로지, 진단, 메트릭 매핑, 알림/이상 징후 규칙을 제공합니다.
- 진단은 컬렉션/인덱스/쿼리 노드 상태와 메트릭 수집 범위를 운영자 근거로 정리합니다.
- 이상 징후 규칙은 선언형 메트릭 방식으로 Milvus 논리 메트릭을 메트릭 소스에 연결합니다.
- 기본 동작은 읽기 전용 진단이며, 상태 변경 작업은 별도 작업 경로와 권한 경계가 필요합니다.
등록 전 확인
- Community Milvus 연결과 인증 설정이 정상이어야 합니다.
- Prometheus 메트릭 소스와 Milvus 매핑팩을 연결합니다.
- MCP 사용자는 리소스 읽기 권한과 필요한 범위를 가져야 합니다.
운영 팁
- 검색 지연, 인덱스 상태, 쿼리 노드 압박은 컬렉션 규모와 워크로드 변화와 함께 봅니다.
- 진단 결과가 부족하면 메트릭 엔드포인트 노출과 매핑팩 적용 상태를 먼저 확인합니다.
운영 시나리오
- 벡터 검색 지연이 증가하면 쿼리 노드 압박, 컬렉션 크기, 인덱스 빌드 상태, 세그먼트/로드 상태를 함께 확인합니다.
- 컬렉션이나 인덱스 작업 후 성능이 달라졌다면 토폴로지 근거와 메트릭 수집 범위를 비교해 워크로드 변화인지 인프라 병목인지 구분합니다.
- MCP 진단은 RAG/AI 서비스 장애 분석에서 Milvus 상태를 다른 리소스 근거와 연결하는 읽기 전용 맥락으로 사용합니다.
경계
- EE 확장 계층은 고급 진단, 토폴로지 근거, 이상 징후 메타데이터를 추가하며 컬렉션/인덱스 변경 같은 상태 변경은 별도 작업 경로가 있을 때만 수행합니다.
- 메트릭 소스가 없으면 이상 징후 규칙은 의미 있게 평가되지 않으며, 부족한 근거를 정상 상태로 추정하지 않습니다.