Prometheus exporter that exposes metrics from apcupsd's NIS. MIT Licensed.

hacktoberfest

Go 95.8%
Shell 2.6%
Dockerfile 1.6%

Find a file

twodarek e74dd086c9 All checks were successful Linux Test / build (1.25, ubuntu-latest) (push) Successful in 1m9s Details Create and publish a Docker image / build-and-push-image (push) Successful in 6m36s Details Merge pull request 'multi-platform builds' (#53 ) from twodarek-multi-platform-build into master Reviewed-on: #53		2026-05-14 03:37:13 +00:00
.forgejo	typo	2026-05-13 23:24:04 -04:00
cmd/apcupsd_exporter	A little cleanup	2022-12-15 13:04:12 -05:00
vendor	Upgrade dependencies	2025-10-06 18:22:45 -04:00
.gitignore	Add Docker Hub release and weekly trigger	2024-03-30 09:25:34 -04:00
apcupsdexporter.go	apcupsd_exporter: report error when apcupsd cannot be reached	2020-06-08 09:55:28 -04:00
apcupsdexporter_test.go	Fix static analysis	2023-10-04 00:56:29 -04:00
CODEOWNERS	Create CODEOWNERS	2022-12-15 12:25:12 -05:00
Dockerfile	Bump go version to 1.25	2026-03-09 22:45:33 -04:00
entrypoint.sh	Add docker ability	2020-02-22 23:37:31 -05:00
go.mod	Bump go version to 1.25	2026-03-09 22:45:33 -04:00
go.sum	Upgrade dependencies	2025-10-06 18:22:45 -04:00
LICENSE.md	apcupsd_exporter: updates for 2022	2022-03-14 11:48:41 -04:00
README.md	Update README.md	2022-12-15 12:51:02 -05:00
upscollector.go	Sync from upstream: Add output amps	2025-09-08 22:41:16 -04:00
upscollector_test.go	Sync from upstream: Add output amps	2025-09-08 22:41:16 -04:00

README.md

apcupsd_exporter

Command apcupsd_exporter provides a Prometheus exporter for the apcupsd Network Information Server (NIS). MIT Licensed.

Usage

Available flags for apcupsd_exporter include:

$ ./apcupsd_exporter -h
Usage of ./apcupsd_exporter:
  -apcupsd.addr string
        address of apcupsd Network Information Server (NIS) (default ":3551")
  -apcupsd.network string
        network of apcupsd Network Information Server (NIS): typically "tcp", "tcp4", or "tcp6" (default "tcp")
  -telemetry.addr string
        address for apcupsd exporter (default ":9162")
  -telemetry.path string
        URL path for surfacing collected metrics (default "/metrics")

For running apcupsd_exporter in docker:

Prerequisites:

apcupsd and apcaccess installed on the docker host

$ docker run ghcr.io/twodarek/apcupsd_exporter:latest --expose 9162:9162 --env APCUPS_ADDR=<docker_host_ip>:3551

Note: You can trade out latest for a specific commit sha to pin to that commit instead of using the automatically built latest, which will be current with the master branch.

Example Prometheus config

scrape_configs:
  - job_name: 'ups'
    static_configs:
    - targets: ['<docker_host_ip>:9162']
    scrape_interval: 1s
    scrape_timeout: 1s