Repolode
thecfu

thecfu/scraparr

SonarrやRadarrなどの*arr系アプリの状態やパフォーマンスを監視・グラフ化するPrometheus exporter。

スター
426
フォーク
18
未解決の Issue
0
最終コミット
2 か月前

これは何?

Scraparrは、Sonarr、Radarr、Lidarrなどのメディア管理アプリを対象としたPrometheus exporterです。各サービスのAPIを定期的にポーリングし、結果をHTTPエンドポイント(デフォルトのポートは7100)でメトリクスとして公開します。Prometheusでスクレイプし、Grafanaでグラフ化できます。

設定はconfig.yamlファイルまたは環境変数で行い、各サービスのURLとAPIキーを指定します。同じサービスの複数インスタンスにも対応しており、それぞれにエイリアスを付けることでメトリクスが上書きされるのを防げます。APIキーはDockerのsecretファイルから読み込むこともできます。

GitHub Container RegistryとDocker HubでDockerイメージが配布されているほか、Pythonで直接実行することもできます。コミュニティがメンテナンスするHelm chartとUnraidテンプレートも利用でき、メトリクス用のGrafanaダッシュボードも公開されています。

主な機能

  • 01*arrサービスのメトリクスをPrometheus形式で公開(デフォルトのポートは7100)
  • 02エイリアスを使って同じサービスの複数インスタンスに対応
  • 03config.yamlまたは環境変数で設定可能
  • 04APIキーをDockerのsecretファイルから読み込み可能
  • 05Dockerイメージとして利用でき、Pythonでも実行可能

ユースケース

  • PrometheusとGrafanaを使ってSonarr、Radarr、Lidarrの状態や稼働状況を監視する
  • エイリアスを使い、1つの監視環境で複数の*arrインスタンスを追跡する
  • Docker ComposeまたはKubernetesで、メディアサーバー構成と一緒にexporterをデプロイする

クイックスタート

  1. 1

    *arr サービスの URL と API キーを記載した config.yaml を作成します

  2. 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 に移行しているため、Issue の報告や貢献はそちらで行ってください。
  • Docker で実行する場合、ホスト上のサービスに接続するにはホストの IP アドレスを使用するか、extra host に host.docker.internal:host-gateway を設定する必要があります。

収録されている特集

トピック

よくある質問

scraparr とは?
SonarrやRadarrなどの*arr系アプリの状態やパフォーマンスを監視・グラフ化するPrometheus exporter。 Scraparrは、Sonarr、Radarr、Lidarrなどのメディア管理アプリを対象としたPrometheus exporterです。各サービスのAPIを定期的にポーリングし、結果をHTTPエンドポイント(デフォルトのポートは7100)でメトリクスとして公開します。Prometheusでスクレイプし、Grafanaでグラフ化できます。
scraparr は無料で使えますか?ライセンスは?
scraparr は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
scraparr は今もメンテナンスされていますか?
半年以内に更新あり。scraparr の最終コミットは 2026年8月26日 です。
scraparr は何に使えますか?
PrometheusとGrafanaを使ってSonarr、Radarr、Lidarrの状態や稼働状況を監視する エイリアスを使い、1つの監視環境で複数の*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 の数値は毎日更新されます。

関連プロジェクト