Repolode
AnalogJ

AnalogJ/scrutiny

smartd/smartctl 데이터를 활용해 하드 드라이브의 S.M.A.R.T 상태와 이력을 보여주고, 고장 알림을 보내는 웹 대시보드입니다.

스타
8,403
포크
311
열린 이슈
42
마지막 커밋
어제

어떤 프로젝트인가요?

Scrutiny는 smartctl 기반의 하드 드라이브 상태 대시보드입니다. 감지된 모든 드라이브에서 S.M.A.R.T 속성을 수집하고 시간에 따라 저장해 점진적인 성능 저하를 확인할 수 있으며, 주요 지표를 웹 UI로 보여줍니다. 따라서 명령줄 출력만 제공되는 헤드리스 서버를 모니터링하기에 적합합니다.

제조업체가 제공하는 값만 보여주는 데 그치지 않고, Scrutiny는 실제 고장률을 바탕으로 자체 임계값을 적용해 제조업체 기준에 도달하기 전에 드라이브에 이상이 있음을 표시할 수 있습니다. 온도도 추적하며, SMART 고장, collector 오류 또는 업로드 누락이 발생하면 이메일, Slack, Telegram, Discord, ntfy, 웹훅 등 다양한 서비스로 알림을 보낼 수 있습니다.

Scrutiny는 올인원 Docker 이미지로 제공되거나, hub/spoke 구성에서 collector, 웹, InfluxDB 컨테이너를 별도로 실행할 수 있습니다. 수동 설치도 가능합니다. 지원 플랫폼은 amd64 및 arm64 아키텍처의 Linux, macOS, FreeBSD 바이너리입니다.

핵심 기능

  • 01주요 S.M.A.R.T 지표에 초점을 맞춘 웹 대시보드
  • 02smartctl --scan을 통한 연결된 드라이브 자동 감지
  • 03S.M.A.R.T 속성과 온도 이력 추적
  • 04제조업체 값뿐 아니라 실제 고장률을 반영한 임계값
  • 05고장, collector 오류, 업로드 누락 알림

활용 사례

  • 가정이나 소규모 기업의 NAS 또는 서버 드라이브 모니터링
  • 데이터 손실이 발생하기 전에 점진적으로 성능이 저하되는 드라이브 식별
  • hub/spoke 모드에서 하나의 대시보드로 여러 서버 모니터링

빠른 시작

  1. 1

    디바이스 및 capability 플래그를 지정해 omnibus Docker 이미지를 실행합니다

    docker run -p 8080:8080 -p 8086:8086 --restart unless-stopped -v `pwd`/scrutiny:/opt/scrutiny/config -v `pwd`/influxdb2:/opt/scrutiny/influxdb -v /run/udev:/run/udev:ro --cap-add SYS_RAWIO --device=/dev/sda --device=/dev/sdb --name scrutiny ghcr.io/analogj/scrutiny:latest-omnibus
  2. 2

    브라우저에서 localhost:8080 대시보드를 엽니다

  3. 3

    대시보드가 비어 있으면 collector 실행을 수동으로 시작합니다

    docker exec scrutiny /opt/scrutiny/bin/scrutiny-collector-metrics run

사용 전 알아둘 점

  • 드라이브에 smartctl로 접근해야 하므로 Docker에서 상향된 capability를 부여하거나 디바이스를 패스스루해야 합니다.
  • 프로젝트는 아직 개발 중이며 미흡한 부분이 있다고 설명하고 있습니다.
  • Windows용 Docker 지원은 아직 개발 중입니다.

포함된 컬렉션

토픽

자주 묻는 질문

scrutiny은(는) 무엇인가요?
smartd/smartctl 데이터를 활용해 하드 드라이브의 S.M.A.R.T 상태와 이력을 보여주고, 고장 알림을 보내는 웹 대시보드입니다. Scrutiny는 smartctl 기반의 하드 드라이브 상태 대시보드입니다. 감지된 모든 드라이브에서 S.M.A.R.T 속성을 수집하고 시간에 따라 저장해 점진적인 성능 저하를 확인할 수 있으며, 주요 지표를 웹 UI로 보여줍니다. 따라서 명령줄 출력만 제공되는 헤드리스 서버를 모니터링하기에 적합합니다.
scrutiny은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
scrutiny은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
scrutiny은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. scrutiny의 마지막 커밋은 2026년 11월 4일입니다.
scrutiny은(는) 어디에 사용할 수 있나요?
가정이나 소규모 기업의 NAS 또는 서버 드라이브 모니터링 데이터 손실이 발생하기 전에 점진적으로 성능이 저하되는 드라이브 식별 hub/spoke 모드에서 하나의 대시보드로 여러 서버 모니터링
scrutiny는 어떻게 설치하나요?
디바이스 및 capability 플래그를 지정해 omnibus Docker 이미지를 실행합니다: docker run -p 8080:8080 -p 8086:8086 --restart unless-stopped -v `pwd`/scrutiny:/opt/scrutiny/config -v `pwd`/influxdb2:/opt/scrutiny/influxdb -v /run/udev:/run/udev:ro --cap-add SYS_RAWIO --device=/dev/sda --device=/dev/sdb --name scrutiny ghcr.io/analogj/scrutiny:latest-omnibus 브라우저에서 localhost:8080 대시보드를 엽니다 대시보드가 비어 있으면 collector 실행을 수동으로 시작합니다: docker exec scrutiny /opt/scrutiny/bin/scrutiny-collector-metrics run
scrutiny은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AnalogJ/scrutiny

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트