Generates Prometheus metrics to a textfile (compatible with node-exporter textfile collector) about APT packages
It generate a metric called apt_package_info per APT packages that are configured to be monitored (via --packages param).
Metric contains name and version of the package as labels.
Metrics are reported to stdout or textfile specified by --output param.
$ python apt-node-exporter.py --output - --packages zstd libqmi-glib5
# HELP apt_package_info Metric labeled with name/version of APT package. Value is always '1'
# TYPE apt_package_info gauge
apt_package_info{name="zstd",version="1.4.8+dfsg-3build1"} 1.0
apt_package_info{name="libqmi-glib5",version="1.32.0-1ubuntu0.22.04.1"} 1.0This Python script requires python3-apt Debian package to be installed.
Once installed you can create a virtualenv that will have access to this system package via
virtualenv --system-site-packages venvThen you can activate your virtualenv and install missing packages with pip
. ./venv/bin/activate
pip install -r requirements.txtapt-node-exporter.sh is based on dpkg-query binary present on all Debian system to create the textfile.
You can pass the list of packages to be monitored as positional arguments:
./apt-node-exporter.sh zstd libqmi-glib5
# HELP apt_package_info Metric labeled with name/version of APT package. Value is always '1'
# TYPE apt_package_info gauge
apt_package_info{name="libqmi-glib5",version="1.32.0-1ubuntu0.22.04.1",state="ii "} 1.0
apt_package_info{name="zstd",version="1.4.8+dfsg-3build1",state="ii "} 1.0The state is the 3 letters dpkg abbreviation where first letter encode Desired state, second one the Status and the third one the Error (if any)
dpkg -l | head -3
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)For example ii means that the package is configured to be installed and is installed successfully.