More tags for influxdb datastore

shrank · 29 April 2026 02:58

Hi

I’m working on a patch to add more tags to the influxdb export:

device_ip - The IP address of the device
device_serial - The serial number of the device
device_model - The hardware/model of the device
module - The name of the module that collected the metric
maintenance - Whether the device is under maintenance (1 or 0)

further, it adds the device group as tags like this:
a device in groups “Datacenter” and “Core-Switches” will receive tags group_Datacenter and group_Core_Switches.

I’m not quite sure yet if I like this solution and I’m open for ideas and comments.

Here is the updated documentation:

github.com/shrank/librenms_patches

doc/Extensions/metrics/InfluxDB.md

influxdb_patch

# Enabling support for InfluxDB

Before we get started it is important that you know and understand
that InfluxDB support is currently alpha at best. All it provides is
the sending of data to a InfluxDB install. Due to the current changes
that are constantly being made to InfluxDB itself then we cannot
guarantee that your data will be ok so enabling this support is at
your own risk!

## Requirements

- InfluxDB >= 0.94 < 2.0
- Grafana

The setup of the above is completely out of scope here and we aren't
really able to provide any help with this side of things.

## What you don't get

- Pretty graphs, this is why at present you need Grafana. You need to

This file has been truncated. show original

Here is the patch against version 26.1.1:

github.com/shrank/librenms_patches

Influxdb patch

b26.1.1 ← influxdb_patch

opened 04:56PM - 16 Apr 26 UTC

shrank

+422 -3

## Summary This PR adds enhanced tagging capabilities to the InfluxDB datasto…re, allowing users to include additional device metadata and custom tags in their InfluxDB metrics. It also adds a configurable flag to disable the `maintenance` tag for users who do not need it, reducing database load. ## Changes ### Features 1. **Dynamic Device Tags** - Added `device_ip` - IP address of the device - Added `device_serial` - Serial number of the device - Added `device_model` - Hardware/model of the device - Added `maintenance` - Device maintenance status (1 or 0) 2. **Module Tag** - Added `module` tag indicating which module collected the metric 3. **Custom Extra Tags** (via `influxdb.extra_tags` config) - Users can configure additional tags added to every metric - Supports multiple comma-separated key=value pairs per array element - Example: `["site=branch A", "environment=production"]` 4. **Device Group Tags** (via `influxdb.add_group_tags` config) - When enabled, adds device group names as tags - Group names are sanitized to be valid InfluxDB tag keys 5. **Optional Maintenance Tag** (via `influxdb.add_maintenance_tag` config) - When enabled (default), adds a `maintenance` tag to each metric - Disabling avoids one database query per device per polling cycle - Maintenance status is cached for 60 seconds when enabled

FROM librenms/librenms:26.1.1
RUN apk update && apk add patch

# influxdb add fields
RUN wget https://github.com/shrank/librenms_patches/pull/18.patch && patch -p 1 -f < 18.patch ; exit 0 #ignore errors
RUN lnms translation:generate