kronos443/nutcase

By kronos443

Updated almost 2 years ago

Network UPS Tools (NUT) and APC UPS graphic display and exporter to Prometheus and JSON

Image
Networking
Internet of things
Monitoring & observability
2

100K+

kronos443/nutcase repository overview

NUTCase

Release Docker Image Size Docker Pulls Docker Stars Docker Build Docker build and push release tag & latest

A Network UPS Tools (NUT) and APC daemon exporter working with Prometheus and any JSON compatible application and GUI

Key features
  • Acts as a drop in replacement for other NUT scrapers such as HON95 prometheus nut exporter
  • A graphic interface showing key data over time with diagnostic information.
  • Supports pulling data from NUT and APC servers, formatting the UPS metrics for the Prometheus logging system
  • Supports formatting the UPS data as JSON for use with the beautiful HomePage app.
  • The JSON output can be used with Uptime Kuma and other reporting, alerting and monitoring apps.
  • Provides diagnostic and usage information.
  • Supports APC apcupsd servers for graphic display and metric scraping - Use one Prometheus and Grafana dashboard for all servers.
  • Supports filtering of JSON elements to support simple monitoring apps. See Filtering the JSON
What It Does For You

Click for image:

NUTCase sits between any nuber of UPS servers, either NUT or APC, and converts the UPS parameters in to either text metrics suitable for use with data caputre systems like Prometheus or JSON. The JSON is ideal for monitoring or display on dashboard systems such as HomePage.

Please see:

The docker container:

For source code and detailed usage with Prometheus and HomePage:

Supported Architectures

Currently supports AMD64,ARM64 (ARM64V8) (suitable for running on docker under Raspberry PI with a 64-bit OS such as Raspberry PI OS 64-bit and Ubuntu 64-bit)

ArchitectureTag
AMD64latest-amd64 For PC and Synology DSM
ARM64V8 (ARM64)arm64v8-latest. For Raspberry PI with a 64-bit OS (RaspberryPI OS 64-bit or Ubuntu 64-bit

History

DateVersionNotes
12/10/20240.4.0.2Bug fix: Crash resulting for a device not sending a battery.runtime value
11/8/20240.4.0.1Small bug fixes
7/3/20240.3.3Small bug fixes, prep-work for next major release, add update notifications
19/2/20240.3.1Corrected crash on start if the `nutcase.yaml` file is missing
3/2/20240.3.0New GUI and many other features
12/1/20240.2.2Corrected potential crash re rework->ratio.
22/12/20230.2.1Corrected error relating to the query port command.
16/12/20230.2.0Adding APC support and other features, see GitHub notes.
01/12/20230.1.0Initial release.

If you find this container useful then please consider buying me a coffee by following this link or scanning the QR below. :)

Please consider donating

Tag summary

Content type

Image

Digest

sha256:7418202a7

Size

396.2 MB

Last updated

almost 2 years ago

docker pull kronos443/nutcase