dot-mike/nmswidgetalertrules

LibreNMS plugin that adds dashboard widget to display alert rules with status

Maintainers

Details

github.com/dot-mike/nmswidgetalertrules

Source

Issues

Installs: 89

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 0

1.0.0 2024-10-29 13:58 UTC

Requires

MIT 6aad0e760041f72b7d4943d906887b9436f24f34

  • dot-mike <d0tmike.woop@pm.me>

This package is auto-updated.

Last update: 2025-03-01 00:42:37 UTC

README

nmswidgetalertrules - A LibreNMS plugin that adds a new widget to the Overview page that displays alert rules with number of alerts.

Installation

Without Docker

Go to the LibreNMS base directory and run the following commands as librenms user:

./lnms plugin:add dot-mike/nmswidgetalertrules
php artisan route:clear

With Docker

If you are using LibreNMS with Docker, you can install the plugin by customizing the Dockerfile.

Example Dockerfile:

ARG VERSION=librenms:24.9.1
FROM librenms/$VERSION

RUN apk --update --no-cache add -t build-dependencies php-xmlwriter
RUN mkdir -p "${LIBRENMS_PATH}/vendor"

RUN echo $'#!/usr/bin/with-contenv sh\n\
set -e\n\
if [ "$SIDECAR_DISPATCHER" = "1" ] || [ "$SIDECAR_SYSLOGNG" = "1" ] || [ "$SIDECAR_SNMPTRAPD" = "1" ]; then\n\
  exit 0\n\
fi\n\
chown -R librenms:librenms "${LIBRENMS_PATH}/composer.json" "${LIBRENMS_PATH}/composer.lock" "${LIBRENMS_PATH}/vendor"\n\
lnms plugin:add dot-mike/nmswidgetalertrules\n\
php artisan route:clear\n\
php lnms --force -n migrate\n\
' > /etc/cont-init.d/99-nmswidgetalertrules.sh

Usage

To get started, open LibreNMS and enable the plugin by navigating to Overview->Plugins->Plugins Admin and enable the nmswidgetalertrules plugin.

Screenshots

widget