apcget — APC PowerChute UPS ステータス取得ツール

✦ 機能

CLI 出力

UPS 負荷・バッテリー・残時間・電圧・ステータスを標準出力に表示。スクリプトや cron ジョブに最適。

JSON 出力

全メトリクスを JSON オブジェクトで出力。Home Assistant などの自動化プラットフォームと容易に連携可能。

MQTT 送信

任意の MQTT ブローカーへメトリクスを送信。mosquitto_pub または paho-mqtt に対応。

Zabbix 連携

zabbix_sender を使って 6 項目を一括送信。Zabbix トラッパーアイテムと連携。

外部依存なし

コア機能は Python 標準ライブラリのみで動作。MQTT・Zabbix 連携はオプション。

認証情報管理

コマンドライン引数・環境変数・設定ファイルの 3 段階で認証情報を管理。シェル履歴へのパスワード漏洩を防止。

▶ クイックスタート

インストール不要。ダウンロードしてすぐ使えます：

# ダウンロード
curl -O https://raw.githubusercontent.com/yo1t/apcget/main/apcget.py

# 基本的な使い方（UPS 負荷 % を取得）
python3 apcget.py 192.168.1.100 username password

# 全メトリクスを JSON で取得
python3 apcget.py 192.168.1.100 username password --json

# MQTT へ送信
python3 apcget.py 192.168.1.100 username password \
  --mqtt-send 192.168.1.200 --mqtt-topic apcget/ups