A lightweight Prometheus exporter for APC UPS devices monitored by apcupsd. Written in Rust for minimal resource usage and maximum performance.

This was built with AI-Assistance tools. However, the code complexity and footprint is very tiny, so it should be very easy to understand what it does.

This exporter connects to the apcupsd Network Information Server (NIS) to retrieve UPS statistics and exposes them as Prometheus metrics. It automatically discovers all available metrics from your UPS and exports them with appropriate types.

• Automatic metric discovery - All numeric values from apcupsd are exported as gauges
• Info metrics - UPS metadata (model, version, hostname, etc.) exposed as labels
• Periodic updates - Configurable polling interval for real-time monitoring
• Minimal footprint - Static binary built with musl, Docker image under 10MB
• Production-ready - Built with actix-web for high performance HTTP serving

• apcupsd_info - UPS identification and configuration with labels:
  • apc, hostname, upsname, version, cable, model, upsmode, driver, apcmodel, status

All numeric values from apcupsd are exported with the prefix apcupsd_ in lowercase. Common metrics include:

• apcupsd_linev - Line voltage
• apcupsd_loadpct - Load percentage
• apcupsd_bcharge - Battery charge percentage
• apcupsd_timeleft - Estimated runtime remaining
• apcupsd_battv - Battery voltage
• apcupsd_itemp - Internal temperature
• And many more depending on your UPS model

All configuration is done via environment variables:

docker run -d \
  -e APCUPSD_HOST=192.168.1.100 \
  -e METRICS_PORT=9090 \
  -e INTERVAL=10 \
  -e TIMEOUT=15 \
  -p 9090:9090 \
  rsapcupsdexporter

services:
  apcupsd-exporter:
    image: rsapcupsdexporter
    container_name: apcupsd-exporter
    environment:
      APCUPSD_HOST: 192.168.1.100
      METRICS_PORT: 9090
      INTERVAL: 10
      TIMEOUT: 15
    ports:
      - "9090:9090"
    restart: unless-stopped

export APCUPSD_HOST=192.168.1.100
./rsapcupsdexporter

Metrics will be available at http://localhost:8080/metrics

rustup target add x86_64-unknown-linux-musl
cargo build --release --target x86_64-unknown-linux-musl

docker build -t rsapcupsdexporter .

The Dockerfile uses multi-stage builds with musl for a minimal scratch-based image.

Add this job to your prometheus.yml:

scrape_configs:
  - job_name: 'apcupsd'
    static_configs:
      - targets: ['localhost:9090']

See LICENSE file for details.