From c4044f749bcbdd020c30baddbe7dfa60717a0001 Mon Sep 17 00:00:00 2001 From: Lars Kruse Date: Thu, 8 Oct 2020 14:15:56 +0200 Subject: [PATCH] Document the new configuration file /etc/munin/muninlite.conf Also mention Kim B. Heino as an author due to significant contributions. --- README.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 690aff5..80df353 100644 --- a/README.md +++ b/README.md @@ -150,10 +150,22 @@ Connection closed by foreign host. ## Plugin configuration -To configure which plugins should be enabled, locate the `PLUGINS` -variable in `muninlite` and remove unwanted plugins. +MuninLite does not support explicit configurations per plugin +(as `munin-node` does). -There is no specific configuration for plugins. +But the file `/etc/munin/muninlite.conf` (if it exists) is sourced +as a shell script during the execution of MuninLite. + +This optional configuration file allows a variety of customizations: + +* override integrated plugins + (by redefining their functions, e.g. `config_if` and `fetch_if`) +* disable integrated plugins (e.g. `PLUGINS=${PLUGINS/ wireless / }`) +* overwrite configuration variables for integrated plugins + (e.g. `NTP_PEER` or `DF_IGNORE_FILESYSTEM_REGEX`) +* specify configuration settings required for external plugins + (provided in `/etc/munin/plugins/`): + `export FOO_SERVICE=http://localhost:7123` ## External plugins @@ -192,3 +204,4 @@ MuninLite is released under GPLv2 (see LICENSE file). * Copyright (C) 2007-2011 Rune Nordbøe Skillingstad * Copyright (C) 2019-2020 Lars Kruse +* Copyright (C) 2020 Kim B. Heino