Konduo Manual

한국어

English

한국어

English

Appearance

Synology 플러그인 ​

Synology 플러그인은 Synology NAS를 Konduo 리소스로 등록하고 DSM 상태, RAID/볼륨, 디스크, 팬, 전원, 온도, 네트워크, 스토리지 IO 신호를 운영 화면에 제공합니다.

특징 ​

  • Prometheus snmp_exporter 경로와 Konduo 관리형 직접 SNMP 수집을 모두 지원합니다.
  • 원시 MIB 메트릭을 Synology 논리 메트릭으로 매핑합니다.
  • 대시보드는 NAS 상태, 용량, 디스크 상태, 스토리지 IO, 네트워크 링크/처리량에 집중합니다.
  • 진단은 SNMP 대상 설정, 메트릭 소스 연결, 필수 메트릭 수집 범위, 라벨 모델, 과거 위험을 확인합니다.
  • 스토리지 인벤토리, 디스크/RAID 상태, DSM 업데이트와 UPS 힌트, 용량 상위 목록, 데이터 보호 경계를 읽기 전용 NAS 근거 탭으로 제공합니다.

등록 전 확인 ​

  • NAS 호스트, SNMP 포트, SNMP 버전, community 또는 SNMPv3 보안 정보를 준비합니다.
  • 관리형 모드에서는 Konduo 백엔드가 NAS SNMP 엔드포인트에 직접 접근할 수 있어야 합니다.
  • 관리형 수집의 쓰기 대상으로 Prometheus를 사용할 경우 Prometheus를 --web.enable-remote-write-receiver 옵션으로 실행해야 합니다.
  • 외부 모드에서는 snmp_exporter 모듈과 Prometheus 수집 라벨을 먼저 확인합니다.

운영 팁 ​

  • diskID, raidName, ifDescr 같은 라벨은 장비 근거이며 Konduo 리소스 ID로 취급하지 않습니다.
  • 볼륨 사용률과 RAID 상태, 디스크 온도/상태는 함께 봐야 용량 위험을 놓치지 않습니다.
  • 터미널 접근이 필요한 경우 별도 접근 정책과 감사 요구사항을 고려합니다.

운영 화면 ​

  • NAS 상태 화면은 DSM 시스템 상태, 온도, 팬, 전원, 업그레이드 상태를 한눈에 확인하게 합니다.
  • 스토리지 화면은 RAID/볼륨 상태, 사용률, 여유/전체 크기, hot spare, 디스크 상태를 함께 보여줍니다.
  • 디스크와 IO 화면은 디스크별 상태, 온도, bad sector, 재시도, 물리/논리 IO 부하를 분리해 보여줍니다.
  • 네트워크 화면은 Ethernet 인터페이스 링크, 처리량, 오류/드롭 근거를 제공하며 loopback/docker/system 인터페이스는 기본 관찰 대상에서 제외합니다.
  • 인벤토리와 근거 화면은 스토리지 풀, 볼륨, 디스크, IO를 메트릭 기반 query blueprint로 제공합니다. 공유 폴더 용량, 스냅샷/복제 상태, 백업 작업 이력, 재부팅 필요 여부, RAID rebuild 진행률처럼 DSM API 근거가 필요한 항목은 경계로 표시합니다.

진단과 알림 관점 ​

  • 진단은 SNMP 대상 접근성, 모듈/라벨 수집 범위, 필수 메트릭 수집 범위, DSM 하드웨어 위험, 과거 위험을 나눠 표시합니다.
  • 알림 규칙은 시스템 fault, 고온, 팬/전원 fault, 디스크 상태, SSD 수명, bad sector, RAID/볼륨 상태, 사용률, 네트워크 링크를 다룹니다.
  • 디스크, RAID/볼륨, 인터페이스 경보는 영향받은 diskID, raidName, ifDescr를 표시하며 경보 상세와 알림 전송에는 진단 힌트와 권장 조치도 함께 포함됩니다.
  • 관리형 SNMP 수집과 snmp_exporter 외부 모드는 같은 원시 MIB 이름을 사용하므로 매핑팩이 동일하게 적용됩니다.
  • UPS 힌트는 수집 프로필이 upsInfoStatus, upsBatteryChargeValue, upsInfoLoadValue를 노출할 때 논리 메트릭으로 사용할 수 있습니다. 직접 관리형 SNMP UPS 수집은 장비별 OID 검증 후 raw sample을 내보내야 합니다.
  • SNMP 라벨은 장비 모델과 DSM/익스포터 버전에 따라 달라질 수 있으므로 실제 고객 장비에서 수집 범위 확인이 필요합니다.

관리 경계 ​

  • 이 플러그인은 NAS 상태 관찰과 제한된 접근 경로 제공이 중심이며 DSM 설정 변경 자동화는 제공하지 않습니다.
  • 볼륨 생성/삭제, RAID 변경, 디스크 초기화, 패키지 관리, 백업 작업 제어는 CE 관리 경계 밖입니다.
  • 공유 폴더별 용량 행, 스냅샷/복제 상태, 백업 성공/실패 이력, 실시간 rebuild 진행률, 재부팅 필요 여부 확인은 DSM API 기반 확장이 근거를 제공하기 전까지 읽기 전용 경계로 남습니다.
  • 터미널 접근이 활성화되어도 임의 DSM 자동화로 확장하지 않습니다.
  • SNMP community, SNMPv3 비밀번호, 터미널 자격 증명은 민감 정보 경계 안에서만 사용합니다.

대표 시나리오 ​

  • 볼륨 사용률 경고가 발생하면 RAID 상태, 볼륨 여유/전체 크기, 디스크 상태, 최근 백업/스냅샷 증가를 함께 확인합니다.
  • 디스크 상태 경고는 온도, bad sector, 재시도 횟수, SSD 수명, RAID 이중화와 묶어 판단합니다.
  • 팬/전원 경고는 chassis 온도, 시스템 상태, DSM 이벤트, 물리 장비 상태를 함께 확인해야 합니다.
  • 네트워크 처리량 저하는 인터페이스 링크 상태, 오류/드롭, bond/bridge 구성, 관련 서비스 지연과 함께 봅니다.

Synology Enterprise 확장 ​

Synology Enterprise 확장은 Community Synology NAS 근거 경로 위에 읽기 전용 위험 분석 메타데이터를 추가합니다. DSM 변경을 수행하지 않고 스토리지 풀, 볼륨, 디스크, 용량, 스냅샷, 복제, 백업, UPS, DSM 업데이트, 네트워크 신호를 함께 상관분석합니다.

특징 ​

  • 이상 징후 규칙팩과 anomaly/rules 경로를 Enterprise 기여 구현으로 제공합니다.
  • correlation/storage-backup-risk 경로로 NAS 스토리지와 데이터 보호 위험을 가중치 기반으로 요약합니다.
  • CE 근거 경로와 EE 상관분석 경로에 대한 MCP 설명자를 제공합니다.
  • 선언형 메트릭 규칙이 Synology 논리 메트릭을 메트릭 소스 매핑으로 평가합니다.

등록 전 확인 ​

  • Community Synology 연결과 메트릭 소스 매핑이 정상이어야 합니다.
  • 스토리지 풀, 볼륨, 디스크, 용량, 백업, 스냅샷, 복제, UPS, DSM 업데이트, 네트워크 메트릭 수집 범위를 확인합니다.
  • 이상 징후와 상관분석 결과를 알림과 연결할지, 진단 보조 신호로만 사용할지 운영 정책을 정합니다.
  • 설정된 DSM/API 또는 메트릭 소스가 백업이나 스냅샷 세부 정보를 수집하지 못하면 상관분석 경로는 컴플라이언스 근거를 만들어내지 않고 수집 경계를 표시합니다.

운영 팁 ​

  • 스토리지 풀 저하, 볼륨 사용량, 디스크 오류, 오래된 백업, 스냅샷 또는 복제 경고, 네트워크 포화는 장비 교체나 백업 정책과 함께 봅니다.
  • 디스크, RAID/볼륨, 인터페이스 경보는 영향받은 diskID, raidName, ifDescr를 표시하며 경보 상세와 알림 전송에는 진단 힌트와 권장 조치도 함께 포함됩니다.
  • 스토리지/백업 위험 상관분석 결과는 장애 분석 맥락으로 사용합니다. 법적 백업 감사, RPO/RTO 인증, DSM 복구 작업을 대신하지 않습니다.
  • 장비별 수집과 기본 상태 동작은 CE에 두고, Enterprise 전용 규칙 메타데이터만 확장 계층에 둡니다.

운영 시나리오 ​

  • NAS 용량 위험을 볼 때 스토리지 풀, 볼륨 사용량, 디스크 상태, 네트워크 처리량을 함께 확인해 단순 용량 경고와 장애 징후를 구분합니다.
  • 백업 실패나 파일 서비스 장애가 발생하면 Synology 상태와 관련 호스트/네트워크/로그 근거를 함께 연결합니다.
  • 모델이나 어시스턴트 워크플로에서는 스토리지 인벤토리, 디스크 상태 근거, DSM/UPS 힌트, 용량 상위 목록, 데이터 보호 근거, 이상 징후 규칙, 스토리지/백업 위험 상관분석 MCP 리소스를 사용합니다.

MCP 리소스 ​

  • storage/inventory: 스토리지 풀, 볼륨, 디스크, IO 인벤토리 근거입니다.
  • diagnostics/disk-health: RAID 상태, 디스크 상태, SMART proxy 신호, rebuild 진행률 경계입니다.
  • diagnostics/system-hints: DSM 업데이트, UPS, 재부팅 필요 여부 힌트입니다.
  • capacity/top-lists: 볼륨 용량 상위 목록 blueprint와 공유 폴더 용량 경계입니다.
  • data-protection/evidence: 스냅샷, 복제, 백업 작업 경계와 용량 맥락입니다.
  • correlation/storage-backup-risk: NAS 스토리지와 데이터 보호 근거를 함께 보는 Enterprise 가중 상관분석입니다.
  • anomaly/rules: Enterprise 선언형 메트릭 이상 징후 규칙입니다.

경계 ​

  • Synology 확장 계층은 저장소 위험 분석 메타데이터를 제공하며, RAID 재구성, 볼륨 확장, 패키지 제어 같은 장비 변경을 수행하지 않습니다.
  • MCP 설명자는 EE 확장 계층 메타데이터로 유지하고 CE 플러그인에는 공통 훅만 둡니다.