Synology 플러그인

기본 접근성 관측

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

이 플러그인의 설정 승인만으로 실제 접근을 확인할 수 없어 접근 상태는 미확인으로 표시됩니다.

차트 값 의미

상태 이름은 숫자 크기 순서가 아니라 Synology MIB와 IF-MIB 정의를 따릅니다. 데이터 검사·복구·업데이트 작업을 하드웨어 장애와 구분합니다. 매핑팩 v3는 대상·디스크·배열·인터페이스 라벨을 보존합니다. UPS 상태는 장치가 제공하는 문자열로, 숫자 enum을 추정하지 않습니다. 미등록 코드는 알 수 없음으로 남깁니다.

온도·용량과 네트워크 비교는 각각 3개 차트로 한 행을 채웁니다. 디스크 비교는 2열과 마지막 전체 폭 재시도 차트로 표시하며 스토리지 I/O는 다중 장치 비교용 전체 폭 차트 2개를 유지합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

상태·용량 요약 6개를 작은 한 행에 모으고 온도·용량 추세를 다음 행에 배치해 상태 카드가 추세 높이만큼 늘어나지 않게 합니다.

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

이 플러그인은 완전한 DSM 관리 통합이 아니라 SNMP 수집·원시 MIB 매핑과 플러그인 계약을 검증하기 위한 샘플/참조 구현입니다. 따라서 일반 리소스 플러그인의 기능 완성도 확대 대상에서는 제외합니다. 유지보수 범위는 계약 호환성, 보안·정확성 수정, 실제 장비 샘플로 검증된 SNMP 동작이며 DSM API를 이용한 설정·패키지·스토리지·백업·수명주기 관리 기능을 로드맵으로 간주하지 않습니다.

특징

• 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 상태, 디스크 온도/상태는 함께 봐야 용량 위험을 놓치지 않습니다.
• 터미널 접근이 필요한 경우 별도 접근 정책과 감사 요구사항을 고려합니다.
• terminal_timeout_seconds(기본 5)는 SSH 연결부터 셸 준비 완료까지의 전체 제한 시간입니다. 생성 요청 취소 시 미완성 연결을 정리하고, 생성 완료된 터미널의 수명은 유지합니다.
• 터미널 한도는 생성 중인 요청과 활성 세션을 함께 계산합니다. 한도가 가득 차면 SSH에 접속하기 전에 생성을 거부합니다.

운영 화면

• NAS 상태 화면은 DSM 시스템 상태, 온도, 팬, 전원, 업그레이드 상태를 한눈에 확인하게 합니다.
• 개요는 NAS 상태·RAID/볼륨 용량·네트워크 추세를 함께 보여줍니다(기본 12개). 디스크 상세는 디스크 상태와 스토리지 I/O를 통합합니다(7개). 상태와 개수는 작은 숫자 카드로 표시하며 전체 29개 카탈로그 키·19개 기본 패널과 저장된 배치를 유지합니다.
• 디스크 상세에는 상태, 온도, SSD 수명, bad sector, 재시도 근거를 유지합니다. 스토리지 IO는 물리 디스크별 읽기/쓰기 바이트 전송률과 읽기/쓰기 IOPS를 두 개의 전체 폭 비교 차트로 보여줍니다.
• 새 대시보드는 카탈로그 프리셋 29개 중 19개를 기본 사용합니다. 이전의 단일 방향 스토리지 패널 4개와 기존 선택 패널 6개는 저장된 배치와 수동 개인화를 위해 계속 사용할 수 있습니다.
• 네트워크 화면은 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 구성, 관련 서비스 지연과 함께 봅니다.

RAID 사용률은 관측된 전체 용량이 양수일 때 계산합니다. 전체 용량 부재나 0을 가상의 사용률 100%로 바꾸지 않고 사용 불가로 표시합니다. 유효한 용량을 가진 빈 볼륨은 실제 사용률 0%를 표시합니다.

---

Synology Enterprise 확장

기본 접근성 관측

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

이 플러그인의 설정 승인만으로 실제 접근을 확인할 수 없어 접근 상태는 미확인으로 표시됩니다.

차트 값 의미

상태 이름은 숫자 크기 순서가 아니라 Synology MIB와 IF-MIB 정의를 따릅니다. 데이터 검사·복구·업데이트 작업을 하드웨어 장애와 구분합니다. 매핑팩 v3는 대상·디스크·배열·인터페이스 라벨을 보존합니다. UPS 상태는 장치가 제공하는 문자열로, 숫자 enum을 추정하지 않습니다. 미등록 코드는 알 수 없음으로 남깁니다.

온도·용량과 네트워크 비교는 각각 3개 차트로 한 행을 채웁니다. 디스크 비교는 2열과 마지막 전체 폭 재시도 차트로 표시하며 스토리지 I/O는 다중 장치 비교용 전체 폭 차트 2개를 유지합니다. 기존 개인화 배치와 쿼리 정의는 변경하지 않습니다.

상태·용량 요약 6개를 작은 한 행에 모으고 온도·용량 추세를 다음 행에 배치해 상태 카드가 추세 높이만큼 늘어나지 않게 합니다.

신규 대시보드는 29개 카탈로그 패널 중 19개를 선택합니다. 개요는 NAS 상태·RAID·볼륨 용량·네트워크 추세를 함께 보여주며(12개) 디스크 상세는 디스크 상태와 스토리지 I/O를 통합합니다(7개). 상태와 개수는 작은 숫자 카드로 표시합니다. 저장 장치의 바이트 처리량과 IOPS는 각각 전체 폭 차트에서 읽기·쓰기를 비교합니다. 기존 단방향 및 선택적 패널은 저장된 배치에서 계속 사용할 수 있습니다.

이 overlay는 Community SNMP 샘플/참조 플러그인의 Enterprise contribution 계약을 검증하는 용도로만 확장합니다. Synology는 일반 리소스 플러그인 기능 완성도 로드맵에서 제외합니다. 유지보수는 계약, 보안, 정확성과 검증된 SNMP 호환성으로 한정하며 완전한 DSM 관리 제품 로드맵을 의미하지 않습니다.

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 전용 규칙 메타데이터만 확장 계층에 둡니다.
• terminal_timeout_seconds(기본 5)는 SSH 연결부터 셸 준비 완료까지의 전체 제한 시간입니다. 생성 요청 취소 시 미완성 연결을 정리하고, 생성 완료된 터미널의 수명은 유지합니다.
• 터미널 한도는 생성 중인 요청과 활성 세션을 함께 계산합니다. 한도가 가득 차면 SSH에 접속하기 전에 생성을 거부합니다.

운영 시나리오

• 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 플러그인에는 공통 훅만 둡니다.

RAID 사용률은 관측된 전체 용량이 양수일 때 계산합니다. 전체 용량 부재나 0을 가상의 사용률 100%로 바꾸지 않고 사용 불가로 표시합니다. 유효한 용량을 가진 빈 볼륨은 실제 사용률 0%를 표시합니다.

MCP client coverage and result contracts

Storage inventory, disk health, DSM/UPS hints, capacity top lists, data-protection evidence and anomaly rules require resources/read. The risk-correlation tool covers correlation only; a tools-only client cannot read those evidence payloads.

describe_resource_instance lists resource metadata and available MCP entries; it does not return plugin resource results. Reads retain API key scopes, resource restrictions and current RBAC. No product client version is certified by this documentation. Tool inputs use the advertised types and bounds; defaults remain plugin-owned. Plugin evidence results are dynamic and intentionally omit optional outputSchema.