Redis 플러그인

TLS 설정 위치

TLS 모드·CA·클라이언트 인증서와 키·서버 이름·인증서 검증 설정은 보안 > TLS에 표시합니다. 주소·포트 등 실제 연결 설정은 기존 구역에 남습니다. 이 분류 변경은 필드 이름, 저장 값, 기본값, 비밀값 처리와 조건부 표시·검증을 바꾸지 않습니다.

기본 접근성 관측

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

TLS

TLS 연결에는 tls_enabled=true를 설정합니다. 사설 CA로 Redis 서버를 검증하려면 tls_ca_cert에 PEM 인증서를 입력하고, 연결 주소와 인증서의 DNS 이름이 다르면 tls_server_name을 지정할 수 있습니다. Redis가 상호 TLS를 요구하면 tls_client_cert와 tls_client_key(PEM)를 함께 입력합니다. tls_insecure_skip_verify는 암호화를 유지하면서 서버 인증서 검증을 생략하며 기본값은 꺼짐입니다. 이 옵션을 켠 경우 CA 입력은 필요하지 않습니다.

차트 값 의미

이진 가용성은 공통 표시 계약의 상태 문자열로 제공하며 의미를 유지합니다. 건수는 정수, 퍼센트 게이지는 0–100으로 표시합니다. 복수 쿼리의 서로 다른 계열을 임의로 합치지 않습니다. CPU 시간은 초당 소비 CPU 시간이며 시스템 용량 대비 퍼센트가 아닙니다.

트래픽·성능 추세 4개는 한 행을 채웁니다. 노드·키 공간 비교는 2열, 안정성 추세 3개는 한 행으로 표시하며 현재 서비스 값은 작은 요약 행을 유지합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

개요는 클러스터 상태와 메모리·캐시 요약을 작은 카드 행으로 모으고 트래픽 추세를 구분합니다. 메모리·키스페이스와 안정성 추세는 상세 페이지에서 확인합니다. 전체 15개 패널과 저장된 배치의 메트릭 의미 및 클러스터·단독 모드 지원 조건을 유지합니다.

maxmemory가 0이거나 조회되지 않으면 메모리 패널은 사용량을 MiB/GiB 등 바이트 단위로 표시하고 사용률을 계산할 수 없음을 안내합니다. 이 경우 사용률 게이지와 사용률 기준 정상·경고 판정을 제공하지 않습니다. 집계 전에 노드별 사용량과 한도를 대조합니다. 한도가 있는 노드와 없는 노드가 혼합되거나 한도 조회가 누락·불일치하면 전체 사용률 대신 관측된 사용량을 표시합니다.

숫자 패널 중 단일 수치의 추세가 유효한 항목은 하단 스파크라인을 표시합니다. 현재 값은 기존 즉시 조회를 유지하고, 별도 이력 조회는 시리즈당 구간별 최대 160개 샘플을 요청합니다. 상태 코드와 복합 계산은 제외하며, 이력 조회 실패는 현재 값을 지우지 않고 ‘추세 조회 불가’로 표시합니다.

Redis 플러그인은 단일 노드, 주/복제 구성, Redis Cluster 배포를 하나의 Konduo 리소스로 등록하고 상태, 메트릭, 진단, 제한된 관리 기능을 제공합니다.

특징

• 시드 엔드포인트에서 클러스터 노드 ID와 멤버 주소를 발견해 리소스 인스턴스 안의 대상 근거로 표현합니다.
• 메모리, 키스페이스, 명령 처리량, 클라이언트, 키 축출, 단편화, 복제, 차단된 클라이언트를 논리 메트릭으로 제공합니다.
• Prometheus 매핑팩과 Konduo 관리형 Redis 메트릭 수집을 모두 지원합니다.
• 키 스캔, 스트림, CLI, 메모리 점검, 서버 작업은 제한된 작업과 확인 문구 경계 안에서 실행됩니다.

등록 전 확인

• 시드 호스트/포트, 비밀번호 또는 ACL 사용자 정보를 준비합니다.
• 클러스터 환경에서는 cluster_instances를 대체 멤버 목록으로 설정할 수 있습니다.
• 메트릭을 쓰려면 Prometheus redis_exporter 매핑 또는 관리형 수집 쓰기 대상을 준비합니다.
• 관리형 수집의 쓰기 대상으로 Prometheus를 사용할 경우 Prometheus를 --web.enable-remote-write-receiver 옵션으로 실행해야 합니다.

운영 팁

• 시드 엔드포인트 장애만으로 전체 클러스터 중단으로 판단하지 말고 다른 발견 멤버의 접근 가능성을 함께 봅니다.
• 메모리 단편화, 키 축출, 차단된 클라이언트는 워크로드 변화와 함께 해석합니다.
• 키/스트림 스캔은 운영 부하를 만들 수 있으므로 제한값, 커서, 작업 상태를 확인하며 실행합니다.
• 일괄 키, 가져오기, 대형 키 작업 결과는 감사 이력이 아닌 임시 메모리 증거입니다. 완료 결과는 제한된 확인 시간이 지나면 자동으로 사라지고, 플러그인을 재시작하면 모두 소실됩니다.
• 상세 진단 결과, CLI 실행 스트림/이력, 서버 작업 상태도 제한된 프로세스 로컬 증거입니다. CLI 스니펫과 즐겨찾기는 사용자 설정이므로 실행 결과 정리 대상에 포함되지 않습니다.

운영 화면

• 서버 화면은 단일 노드, 주/복제 구성, 클러스터 멤버를 하나의 리소스 인스턴스 안에서 보여주고 시드 엔드포인트와 발견 멤버를 구분합니다.
• 키 화면은 커서 기반 스캔 작업으로 키 목록과 TTL, 유형, 메모리 추정치를 제한적으로 확인하게 합니다.
• 스트림 화면은 스트림, 그룹, 컨슈머, 대기 적체, 유휴 시간을 읽기 전용 근거로 보여줍니다.
• CLI와 서버 작업 화면은 운영자 진단에 필요한 제한된 명령만 확인 문구와 안전 모드 안에서 실행합니다.

진단과 알림 관점

• 진단은 토폴로지, 메모리/키스페이스, 워크로드 귀속, 내구성/복제, 메트릭 기반 위험을 나눠 표시합니다.
• 알림 규칙은 클러스터 상태, 복제 링크, 복제 지연, 단편화, 차단된 클라이언트, 키 축출, 캐시 적중률 위험을 다룹니다.
• 관리형 수집에서는 Redis 명령 근거를 redis_exporter 호환 샘플로 변환하고 리소스 식별 라벨로 격리합니다.
• 메트릭 근거가 없으면 Redis가 정상이라고 가정하지 않고 매핑팩, 수집, 관리형 쓰기 상태를 확인해야 합니다.

관리 경계

• 임의 Redis API 탐색이나 무제한 KEYS 조회는 CE 운영 경계가 아닙니다.
• 키 삭제, 서버 작업, CLI 실행은 의도 확인, 권한, 감사 로그가 필요한 변경 작업입니다.
• 스트림 정리, 소유권 회수, 확인 응답 같은 변경성 스트림 업무 흐름은 별도 보호 장치 없이 제공하지 않습니다.
• 시드 엔드포인트와 클러스터 멤버 식별자가 바뀌면 발견 정보가 오래될 수 있으므로 리소스 설정과 클러스터 근거를 함께 갱신합니다.

대표 시나리오

• 메모리 경고가 발생하면 사용량/최댓값, 단편화, 키 축출 비율, 키스페이스 증가, 큰 키 스캔 결과를 함께 확인합니다.
• 복제 지연이 증가하면 주/복제 역할, 링크 상태, 복제 오프셋, 네트워크 상태를 같이 봅니다.
• 클러스터 슬롯 문제가 있으면 멤버 접근 가능성, 클러스터 노드 근거, 슬롯 완전성, 장애 조치 진행 여부를 확인합니다.
• 스트림 지연이 의심되면 대기 건수, 컨슈머 유휴 시간, 마지막 전달 ID, 보존 정책을 순서대로 검토합니다.

캐시 적중률은 hits와 misses의 합이 양수일 때만 계산합니다. 무트래픽이나 피연산자 부재는 사용 불가이며 실제 요청이 모두 miss이면 0%입니다. 클러스터와 노드별 패널에 같은 규칙을 적용합니다. 유휴 구간을 캐시 장애로 해석하지 마세요.

---

Redis Enterprise 확장

TLS 설정 위치

TLS 모드·CA·클라이언트 인증서와 키·서버 이름·인증서 검증 설정은 보안 > TLS에 표시합니다. 주소·포트 등 실제 연결 설정은 기존 구역에 남습니다. 이 분류 변경은 필드 이름, 저장 값, 기본값, 비밀값 처리와 조건부 표시·검증을 바꾸지 않습니다.

기본 접근성 관측

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

TLS

TLS 연결에는 tls_enabled=true를 설정합니다. 사설 CA로 Redis 서버를 검증하려면 tls_ca_cert에 PEM 인증서를 입력하고, 연결 주소와 인증서의 DNS 이름이 다르면 tls_server_name을 지정할 수 있습니다. Redis가 상호 TLS를 요구하면 tls_client_cert와 tls_client_key(PEM)를 함께 입력합니다. tls_insecure_skip_verify는 암호화를 유지하면서 서버 인증서 검증을 생략하며 기본값은 꺼짐입니다. 이 옵션을 켠 경우 CA 입력은 필요하지 않습니다.

차트 값 의미

이진 가용성은 공통 표시 계약의 상태 문자열로 제공하며 의미를 유지합니다. 건수는 정수, 퍼센트 게이지는 0–100으로 표시합니다. 복수 쿼리의 서로 다른 계열을 임의로 합치지 않습니다. CPU 시간은 초당 소비 CPU 시간이며 시스템 용량 대비 퍼센트가 아닙니다.

트래픽·성능 추세 4개는 한 행을 채웁니다. 노드·키 공간 비교는 2열, 안정성 추세 3개는 한 행으로 표시하며 현재 서비스 값은 작은 요약 행을 유지합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

개요는 클러스터 상태와 메모리·캐시 요약을 작은 카드 행으로 모으고 트래픽 추세를 구분합니다. 메모리·키스페이스와 안정성 추세는 상세 페이지에서 확인합니다. 전체 15개 패널과 저장된 배치의 메트릭 의미 및 클러스터·단독 모드 지원 조건을 유지합니다.

숫자 패널 중 단일 수치의 추세가 유효한 항목은 하단 스파크라인을 표시합니다. 현재 값은 기존 즉시 조회를 유지하고, 별도 이력 조회는 시리즈당 구간별 최대 160개 샘플을 요청합니다. 상태 코드와 복합 계산은 제외하며, 이력 조회 실패는 현재 값을 지우지 않고 ‘추세 조회 불가’로 표시합니다.

Redis Enterprise 확장은 Community Redis 플러그인에 MCP 설명자, Enterprise 대시보드, 진단 분석 작업, 키 스캔, 일괄 작업, 가져오기/내보내기, 스트림, CLI 콘솔, 이상 징후 탐지기를 추가합니다.

메트릭 해석

maxmemory가 0이거나 조회되지 않으면 메모리 패널은 사용량을 MiB/GiB 등 바이트 단위로 표시하고 사용률을 계산할 수 없음을 안내합니다. 이 경우 사용률 게이지와 사용률 기준 정상·경고 판정을 제공하지 않습니다. 집계 전에 노드별 사용량과 한도를 대조합니다. 한도가 있는 노드와 없는 노드가 혼합되거나 한도 조회가 누락·불일치하면 전체 사용률 대신 관측된 사용량을 표시합니다.

특징

• MCP에서 모니터링 개요, 토폴로지 요약, 진단, 메트릭 카탈로그, 알림/이상 징후 규칙을 조회합니다.
• 플러그인 실행형 이상 징후 탐지기가 INFO 근거를 해석해 메모리 압박, 차단된 클라이언트, 복제 링크 중단을 감지합니다.
• 큰 키/키 스캔, 스트림 점검, 일괄 TTL/삭제, 가져오기/내보내기, CLI 실행은 제한된 작업으로 관리됩니다.
• 로그 근거 청사진으로 OOM, 장애 조치, 접속 거부, 느린 로그 패턴을 Enterprise 로그 소스와 연결합니다.

등록 전 확인

• Community Redis 연결, ACL, 클러스터 발견, 메트릭 소스 매핑이 정상이어야 합니다.
• 키 스캔이나 CLI 기능을 사용할 운영자 권한과 감사 요구사항을 확인합니다.
• OpenSearch 로그 소스를 연결하면 진단 근거가 더 풍부해집니다.

운영 팁

• 시드 엔드포인트 장애만으로 전체 클러스터 중단으로 판단하지 말고 다른 발견 멤버의 접근 가능성을 함께 봅니다.
• 메모리 단편화, 키 축출, 차단된 클라이언트는 워크로드 변화와 함께 해석합니다.
• 키/스트림 스캔은 운영 부하를 만들 수 있으므로 제한값, 커서, 작업 상태를 확인하며 실행합니다.
• 가져오기/내보내기와 일괄 작업은 대규모 환경에서 부하가 될 수 있으므로 제한값, 사전 점검, 작업 상태를 확인합니다.
• 일괄 키, 가져오기, 대형 키 작업 결과는 감사 이력이 아닌 임시 메모리 증거입니다. 완료 결과는 제한된 확인 시간이 지나면 자동으로 사라지고, 플러그인을 재시작하면 모두 소실됩니다.
• 상세 진단 결과, CLI 실행 스트림/이력, 서버 작업 상태도 제한된 프로세스 로컬 증거입니다. CLI 스니펫과 즐겨찾기는 사용자 설정이므로 실행 결과 정리 대상에 포함되지 않습니다.
• MCP 설명자는 읽기 중심 맥락으로 사용하고, 변경성 작업은 기존 작업 경로와 권한 경계를 따릅니다.

운영 시나리오

• 메모리 압박이 의심되면 INFO 근거, 큰 키 스캔, 키 축출, 단편화, 느린 로그/로그 근거를 함께 확인합니다.
• 스트림 적체나 컨슈머 그룹 문제가 있을 때 스트림 점검과 토폴로지 요약을 사용해 처리 지연 위치를 좁힙니다.
• 가져오기/내보내기나 일괄 TTL/삭제는 운영자 의도, 사전 점검, 작업 진행률, 감사 추적이 확인된 뒤 실행합니다.

경계

• CLI 콘솔, 일괄 작업, 가져오기/내보내기는 강력한 운영 기능이므로 MCP 읽기 전용 설명자와 분리된 작업 경로로 유지합니다.
• Redis 플러그인 모드 이상 징후 탐지기는 INFO 근거 해석에 집중하고, 로그 상관관계는 OpenSearch 로그 소스 매핑으로 연결합니다.

캐시 적중률은 hits와 misses의 합이 양수일 때만 계산합니다. 무트래픽이나 피연산자 부재는 사용 불가이며 실제 요청이 모두 miss이면 0%입니다. 클러스터와 노드별 패널에 같은 규칙을 적용합니다. 유휴 구간을 캐시 장애로 해석하지 마세요.

MCP argument and result contracts

Summary and history tools accept lookback or lookback_window and optional metric_source_id. Detail accepts check_key, check, or section; omission selects connectivity_topology. Monitoring overview describes optional db. Metric resolution describes its supported instance and label selectors.

Argument-bearing routes retain compatible dynamic filters where the plugin passes an open query filter map; the advertised properties describe useful inputs without removing existing aliases. Unknown fields are rejected for explicitly argument-free tools.

Results contain route-specific diagnostic evidence, vendor inventory, optional fields, and availability states. These dynamic result shapes intentionally omit outputSchema; clients should inspect the returned structured content and status rather than assume a fixed success-only result. Tools and resources use the same instance scope, authorization, and masking. Resource-only catalogs remain available through resources/read; tools-only clients can inspect tool-backed operational routes but need resource support for the remaining metadata catalogs.