Collectd plugin for apk-tools

A collectd plugin that collects information about packages managed by apk-tools, a package manager developed for Alpine Linux.

Usage

<LoadPlugin apk>
  Interval 86400  # 1 day
</LoadPlugin>

Metrics

This section describes exposed metrics (values).

apk-upgradable.count

A number of upgradable (outdated) packages as reported by apk list --upgradable --no-cache.

• type: GAUGE (min: 0, max: inf.)

• metadata:

  • os-id (string): the value of ID in /etc/os-release (e.g. alpine)

  • os-version (string): the value of VERSION_ID in /etc/os-release (e.g. 3.16.0)

  • packages (string): a JSON array of objects with the following keys:

    • p: package name

    • o: package origin (name of the aport)

    • v: old version (currently installed)

    • w: new version (available)

Requirements

Runtime:

• collectd 5.12+

• libapk 2.x

• libjson-c

Build:

• C compiler and linker supporting at least C11 (tested with gcc)

• pkg-config

• GNU Make

• apk-tools development files

• json-c development files

• collectd development files

The header files needed to build collectd plugins are usually not included in the distribution packages. Exceptions are collectd-dev packages in Alpine Linux (since v3.16) and Debian – the core headers are installed in /usr/include/collectd/core. If you don’t have /usr/include/collectd/core/daemon/plugin.h, download the collectd source package from collectd.org. Then build this plugin with variable COLLECTD_INCLUDE_DIR pointing to the unpacked src/ directory: make build COLLECTD_INCLUDE_DIR=/path/to/src.

Installation

On Alpine Linux

Install package collectd-apk from the Alpine’s Edge testing repository:

apk add collectd-apk

From Source Tarball

wget https://github.com/jirutka/collectd-apk/archive/v0.2.0/collectd-apk-0.2.0.tar.gz
tar -xzf collectd-apk-0.2.0.tar.gz
cd collectd-apk-0.2.0

make build
make install DESTDIR=/ prefix=/usr

License

This project is licensed under GPL-2.0-or-later. For the full text of the license, see the LICENSE file.