view mod_munin/README.markdown @ 4709:679f1834dbdb default tip

mod_delegation: update to XEP-0355 v0.5 - namespace bump to "urn:xmpp:delegation:2" - disco remaining infos now uses the XEP defined "urn:xmpp:delegation:2:bare:disco#info:*" namespace - complemeted disco remaining infos implementation for requests made on nodes not already managed by the server - bare JID disco items now uses the XEP defined "urn:xmpp:delegation:2:bare:disco#items:*'" namespace
author Goffi <>
date Fri, 15 Oct 2021 15:10:36 +0200
parents f1a63271dcfc
line wrap: on
line source

- 'Stage-Beta'
- 'Statistics'
summary: Implementation of the Munin node protocol


This module implements the Munin reporting protocol, allowing you to
collect statistics directly from Prosody into Munin.


There is only one recommended option, `munin_node_name`, which specifies
the name that Prosody will identify itself by to the Munin server. You
may want to set this to the same hostname as in the [SRV record][doc:dns]
for the machine.

modules_enabled = {
    -- your other modules

munin_node_name = ""

You will also want to enable statistics collection by setting:

statistics_interval = 300 -- every 5 minutes, same as munin

## Summary

All these must be in [the global section][doc:configure#overview].

  Option                  Type     Default
  ----------------------- -------- ---------------------------
  munin\_node\_name       string   `"localhost"`
  munin\_ignored\_stats   set      `{ }`
  munin\_ports            set      `{ 4949 }`
  munin\_interfaces       set      `{ "", "::" }`[^1]

[^1]: Varies depending on availability of IPv4 and IPv6

## Ports and interfaces

`mod_munin` listens on port `4949` on all local interfaces by default.
This can be changed with the standard [port and network configuration][doc:ports]:

``` lua
-- defaults:
munin_ports = { 4949 }
munin_interfaces = { "::", "" }

If you already have a `munin-node` instance running, you can set a
different port to avoid the conflict.

## Configuring Munin

Simply add `munin_node_name` surrounded by brackets to `/etc/munin/munin.conf`:

``` ini
port 4949

You can leave out `address` if it equal to the name in brackets, and
leave out the `port` if it is the default (`4949`).

Setting `address` to an IP address may sometimes be useful as the Munin
collection server is not delayed by DNS lookups in case of network

If you set a different port, or if the hostname to connect to is
different from this hostname, make sure to add `port` and/or `address`

See [Munin documentation][muninconf] for more information.


**Requires** Prosody 0.10 or above