Konduo Manual

한국어

English

한국어

English

Appearance

Redis 플러그인 ​

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, 보존 정책을 순서대로 검토합니다.

Redis Enterprise 확장 ​

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

특징 ​

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

등록 전 확인 ​

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

운영 팁 ​

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

운영 시나리오 ​

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

경계 ​

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