플러그형 collector를 사용해 *NIX 커널의 하드웨어 및 OS 메트릭을 제공하는 Prometheus exporter입니다.
thecfu/scraparr
Sonarr, Radarr 등 *arr 제품군의 상태와 성능을 모니터링하고 그래프로 확인할 수 있도록 데이터를 수집하는 Prometheus exporter입니다.
- 스타
- 426
- 포크
- 18
- 열린 이슈
- 0
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
Scraparr는 Sonarr, Radarr, Lidarr와 같은 미디어 관리 애플리케이션으로 구성된 *arr 제품군용 Prometheus exporter입니다. 각 서비스의 API를 주기적으로 호출해 결과를 HTTP 엔드포인트(기본 포트 7100)의 메트릭으로 제공하며, Prometheus가 이를 수집하고 Grafana가 그래프로 표시할 수 있습니다.
config.yaml 파일이나 환경 변수로 설정하며, 각 서비스의 URL과 API 키를 지정합니다. 서비스마다 별칭을 지정하면 같은 서비스의 인스턴스를 여러 개 지원하고, 메트릭이 서로 덮어쓰이지 않습니다. Docker secret 파일에서 API 키를 불러올 수도 있습니다.
GitHub Container Registry와 Docker Hub에서 Docker 이미지로 배포되며, Python으로 직접 실행할 수도 있습니다. 커뮤니티에서 관리하는 Helm chart와 Unraid 템플릿을 사용할 수 있고, 메트릭용 Grafana 대시보드도 공개되어 있습니다.
핵심 기능
- 01기본 포트 7100에서 *arr 서비스 메트릭을 Prometheus 형식으로 제공합니다
- 02별칭을 사용해 같은 서비스의 인스턴스를 여러 개 지원합니다
- 03config.yaml 또는 환경 변수로 설정할 수 있습니다
- 04Docker secret 파일에서 API 키를 읽어옵니다
- 05Docker 이미지로 제공되며 Python으로 실행할 수 있습니다
활용 사례
- Prometheus와 Grafana로 Sonarr, Radarr, Lidarr의 상태와 활동을 모니터링
- 별칭을 사용해 하나의 모니터링 스택에서 여러 *arr 인스턴스를 추적
- Docker Compose 또는 Kubernetes로 미디어 서버 스택과 함께 exporter를 배포
빠른 시작
- 1
*arr 서비스 URL과 API 키가 포함된 config.yaml을 만드세요
- 2
GitHub Registry에서 Docker 이미지를 실행하고 포트 7100을 노출하세요
docker run -v ./config.yaml:/scraparr/config/config.yaml -p 7100:7100 ghcr.io/thecfu/scraparr
사용 전 알아둘 점
- GPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생 저작물도 오픈 소스로 공개해야 합니다.
- 주요 개발이 Codeberg로 이전되었으므로 이슈와 기여는 해당 저장소에서 진행해야 합니다.
- Docker에서 실행할 때 호스트의 서비스에 연결하려면 호스트 IP를 사용하거나 extra host에 host.docker.internal:host-gateway를 설정해야 합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- scraparr은(는) 무엇인가요?
- Sonarr, Radarr 등 *arr 제품군의 상태와 성능을 모니터링하고 그래프로 확인할 수 있도록 데이터를 수집하는 Prometheus exporter입니다. Scraparr는 Sonarr, Radarr, Lidarr와 같은 미디어 관리 애플리케이션으로 구성된 *arr 제품군용 Prometheus exporter입니다. 각 서비스의 API를 주기적으로 호출해 결과를 HTTP 엔드포인트(기본 포트 7100)의 메트릭으로 제공하며, Prometheus가 이를 수집하고 Grafana가 그래프로 표시할 수 있습니다.
- scraparr은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- scraparr은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- scraparr은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. scraparr의 마지막 커밋은 2026년 8월 26일입니다.
- scraparr은(는) 어디에 사용할 수 있나요?
- Prometheus와 Grafana로 Sonarr, Radarr, Lidarr의 상태와 활동을 모니터링 별칭을 사용해 하나의 모니터링 스택에서 여러 *arr 인스턴스를 추적 Docker Compose 또는 Kubernetes로 미디어 서버 스택과 함께 exporter를 배포
- scraparr는 어떻게 설치하나요?
- *arr 서비스 URL과 API 키가 포함된 config.yaml을 만드세요 GitHub Registry에서 Docker 이미지를 실행하고 포트 7100을 노출하세요: docker run -v ./config.yaml:/scraparr/config/config.yaml -p 7100:7100 ghcr.io/thecfu/scraparr
- scraparr은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/thecfu/scraparr
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
API 서버를 감시하고 파드, 디플로이먼트, 노드 같은 객체의 상태를 설명하는 Prometheus 메트릭을 제공하는 Kubernetes 애드온 서비스입니다.
Prometheus 통합을 염두에 두고 메트릭, 로그, 트레이스, 프로파일용 프로그래밍 가능한 표현식 기반 파이프라인을 제공하는 OpenTelemetry Collector 배포판입니다.
장기 저장소이자 Prometheus를 그대로 대체할 수 있는 빠르고 비용 효율적인 시계열 데이터베이스 및 모니터링 솔루션입니다.
Sonarr와 Radarr 인스턴스에 TRaSH Guides와 사용자 지정 설정을 동기화해 사용자 지정 포맷과 품질 프로필을 자동으로 관리하는 오픈소스 도구입니다.
Radarr, Sonarr, Lidarr, Readarr, Whisparr 인스턴스의 자동 검색을 분산·교차 실행해 인덱서와 API 한도를 보호하는 오케스트레이션 서비스입니다.