Improve documantion of many plugins

Specifically the configuration examples are now indented properly.
This commit is contained in:
Lars Kruse 2020-10-24 17:28:11 +02:00
parent 384d482fe2
commit 09b88141b3
92 changed files with 556 additions and 388 deletions

View File

@ -8,14 +8,14 @@ Munin plugin to monitor apache mod_cache_disk usage.
=head1 CONFIGURATION
[apache_cache_disk_count]
user www-data
env.cache_path /var/cache/apache2/mod_cache_disk
env.strings css js
env.label_cs CSS
env.colour_css FFFF00
env.label_js JS
env.colour_js FF0000
[apache_cache_disk_count]
user www-data
env.cache_path /var/cache/apache2/mod_cache_disk
env.strings css js
env.label_cs CSS
env.colour_css FFFF00
env.label_js JS
env.colour_js FF0000
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ apache_memory - Indicate the medium size of all the apache child process
=head1 CONFIGURATION
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ apache_servers - Indicate the number of apache servers running (child process)
=head1 CONFIGURATION
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ apache_threads -Indicate the memdium number of threads for all child process
=head1 CONFIGURATION
[apache_*]
env.apuser user_runnin_apache
env.binname apache_binary_name
[apache_*]
env.apuser user_runnin_apache
env.binname apache_binary_name
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ apache_tmemmory - Indicate the total memory used by apache
=head1 CONFIGURATION
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
[apache_*]
env.apuser user_running_apache (default: "www-data")
env.binname apache_binary_name (default: "apache2")
=head1 AUTHOR

View File

@ -27,14 +27,20 @@ Be aware that a apache log CustomLog directive in the master config will only lo
Install plugin conf (after [apache_*])
[apache_vhosts]
user root
env.subgraphs requests bytes time
env.checks requests bytes time
[apache_vhosts]
user root
env.subgraphs requests bytes time
env.checks requests bytes time
# user - probably necessary for shared memory IPC
# subgraphs - create multigraph subgraphs (watch your graphing performance...), default 0
# checks - enable stats on bytes and response times per request, you have to log these in apache
=over 4
=item user - probably necessary for shared memory IPC
=item subgraphs - create multigraph subgraphs (watch your graphing performance...), default 0
=item checks - enable stats on bytes and response times per request, you have to log these in apache
=back
A word on performance:
Requests/sec should not be much of a problem. Pipelogger and Logparser should not have man performance problems, as the apply one regex per line and add some stats.

View File

@ -8,9 +8,9 @@ ceph_capacity - Shows ceph total storage capacity, used raw space and used data
=head1 CONFIGURATION
[ceph_capacity]
env.warning_level Used raw space percentage above warning alert should be issued
env.critical_level Used raw space percentage above critical alert should be issued
[ceph_capacity]
env.warning_level Used raw space percentage above warning alert should be issued
env.critical_level Used raw space percentage above critical alert should be issued
=head1 AUTHOR

View File

@ -14,9 +14,9 @@ This plugin requires a password set in /etc/turnserver.conf for telnet
cli access. A telnet client has to be installed. Optionally you can
specify the port of the cli interface.
[coturn_sessions]
env.password VERYSECUREPASSWORD
env.port PORT
[coturn_sessions]
env.password VERYSECUREPASSWORD
env.port PORT
=head1 AUTHOR

View File

@ -51,10 +51,12 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
SPDX-License-Identifier: GPL-3.0-or-later
=head1 MAGIC MARKERS
#%# family=contrib
#%# capabilities=suggest
#%# family=contrib
#%# capabilities=suggest
=cut
"""

View File

@ -13,8 +13,8 @@ btrfs_device_stats - Script to monitor btrfs device statistics
Simply create a symlink in your plugins directory like with any other plugin.
Must be run as root.
[btrfs_device_stats]
user root
[btrfs_device_stats]
user root
=head2 DEFAULT CONFIGURATION

View File

@ -13,8 +13,8 @@ btrfs_device_usage - Script to monitor usage of btrfs devices
Simply create a symlink in your plugins directory like with any other plugin.
Must be run as root.
[btrfs_device_usage]
user root
[btrfs_device_usage]
user root
=head2 DEFAULT CONFIGURATION

View File

@ -8,9 +8,9 @@ btrfs_subvol_usage - Plugin to monitor usage of BTRFS subvolumes
Must be run as root and you have to specify the path to the filesystem
[btrfs_usage]
user root
env.fsroot /path/to/btrfs/filesystem
[btrfs_usage]
user root
env.fsroot /path/to/btrfs/filesystem
=head1 MAGIC MARKERS

View File

@ -8,8 +8,8 @@ ext2 - Wildcard plugin shows ext2/3/4 filesystem information (mount count, last
=head1 CONFIGURATION
[ext2_*]
group disk,floppy
[ext2_*]
group disk,floppy
=head1 AUTHOR

View File

@ -88,7 +88,7 @@ file_age - Monitors the age of files.
Since there is no way for the plugin to guess which files you want monitored, you're going to have to set each file up separately. Put the following in a file in your plugin-conf.d directory.
[file_age]
[file_age]
user root # May not be necessary, depending on which files you want monitored.
env.file1_path /var/log/syslog # Mandatory, complete path to file.

View File

@ -16,22 +16,21 @@ Root privilege required to execute docker command.
1. Create a new file named "docker" inside the folder /etc/munin/plugin-conf.d/
2. Docker file content:
[docker_cpu]
user root
[docker_cpu]
user root
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
#%# family=auto
#%# capabilities=autoconf
=head1 VERSION
v.0.1
v.0.1
=head1 AUTHOR
Copyright (C) 2015 Samuel Cantero.
Email: scanterog at gmail dot com
Copyright (C) 2015 Samuel Cantero <scanterog at gmail dot com>
=head1 LICENSE

View File

@ -16,22 +16,21 @@ Root privilege required to execute docker command.
1. Create a new file named "docker" inside the folder /etc/munin/plugin-conf.d/
2. Docker file content:
[docker_memory]
user root
[docker_memory]
user root
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
#%# family=auto
#%# capabilities=autoconf
=head1 VERSION
v.0.1
v.0.1
=head1 AUTHOR
Copyright (C) 2015 Samuel Cantero.
Email: scanterog at gmail dot com
Copyright (C) 2015 Samuel Cantero <scanterog at gmail dot com>
=head1 LICENSE

View File

@ -6,8 +6,7 @@ set -e
=head1 NAME
etherpadlite_ - Monitor number of pads with etherpad-lite plugin called
ep_pads_stats
etherpadlite_ - Monitor number of pads with etherpad-lite plugin called ep_pads_stats
=head1 APPLICABLE SYSTEMS
@ -22,8 +21,8 @@ jq, a command-line json processor.
This is a wildcard plugin. To monitor a etherpad-lite instance, link
etherpadlite_<instancename> to this file.
[etherpadlite_instancename]
env.url http://127.0.0.1:9001/stats.json
[etherpadlite_instancename]
env.url http://127.0.0.1:9001/stats.json
=head1 AUTHOR

View File

@ -3,8 +3,7 @@
"""=cut
=head1 NAME
git_commit_behind - Munin plugin to monitor local git repositories and report
how many commits behind their remote they are
git_commit_behind - Munin plugin to monitor local git repositories and report how many commits behind their remote they are
=head1 NOTES
@ -19,13 +18,20 @@ separate cron job.
=head1 REQUIREMENTS
- Python3
- Git
=over 4
=item Python3
=item Git
=back
=head1 INSTALLATION
Link this plugin, as usual.
For example :
ln -s /path/to/git_commit_behind /etc/munin/plugins/git_commit_behind
If you wish to update the repositories via cron and not during the plugin
@ -33,16 +39,17 @@ execution (cf CONFIGURATION section), you need a dedicated cron job.
For example, you can use the following cron :
# If the git_commit_behind plugin is enabled, fetch git repositories randomly
# according to the plugin configuration.
# By default : once an hour (12 invocations an hour, 1 in 12 chance that the
# update will happen), but ensure that there will never be more than two hours
# (7200 seconds) interval between updates.
*/5 * * * * root if [ -x /etc/munin/plugins/git_commit_behind ]; then /usr/sbin/munin-run git_commit_behind update >/dev/null; fi
# If the git_commit_behind plugin is enabled, fetch git repositories randomly
# according to the plugin configuration.
# By default : once an hour (12 invocations an hour, 1 in 12 chance that the
# update will happen), but ensure that there will never be more than two hours
# (7200 seconds) interval between updates.
*/5 * * * * root if [ -x /etc/munin/plugins/git_commit_behind ]; then /usr/sbin/munin-run git_commit_behind update >/dev/null; fi
=head1 CONFIGURATION
Use your "/etc/munin/plugin-conf.d/munin-node" to configure this plugin.
[git_commit_behind]
user [user]
env.git_path /path/to/git
@ -63,7 +70,8 @@ env.update.maxinterval : optional (default : 7200),
Then, for each repository you want to check, you need the following
configuration block under the git_commit_behind section
configuration block under the git_commit_behind section:
env.repo.[repoCode].path /path/to/local/repo
env.repo.[repoCode].name Repo Name
env.repo.[repoCode].user user

View File

@ -18,7 +18,7 @@ and the SHA authentication scheme.
Create a "Munin" user on the GSA SNMP configuration, and then use
something similar to the following:
[snmpv3_gsa.host.name_*]
[snmpv3_gsa.host.name_*]
env.v3username munin
env.v3authprotocol sha
env.v3authpassword your-auth-passwd

View File

@ -9,7 +9,7 @@ haproxy_aborts_backend -Haproxy Aborts Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_active_backend -Haproxy servers active backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_bytes_backend -Haproxy Bytes Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_bytes_compressor_backend -Haproxy Bytes Compressor
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_bytes_compressor_backend -Haproxy Bytes Compressor
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_bytes_frontend -Haproxy Bytes Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_denied_backend -Haproxy Denied Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_denied_frontend -Haproxy Denied Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_errors_backend -Haproxy Errors Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_errors_frontend -Haproxy Errors Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_queue_backend -Haproxy Queued Requests Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_rate_backend -Haproxy Sessions Per Second Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ harpoxy_rate_frontend -Haproxy Sessions Per Second Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_reqrate_frontend -Haproxy request rate frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_response_compressor_backend -Haproxy Response Compressed
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_response_compressor_backend -Haproxy Response Compressed
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_responses_backend -Haproxy responses backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_responses_frontend -Haproxy responses frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_sessions_backend -Haproxy Sessions Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_sessions_frontend -Haproxy Sessions Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_sessions_total_frontend -Haproxy Sessions Total Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haprxoy_sessions_total_frontend -Haproxy Sessions Total Frontend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,7 +9,7 @@ haproxy_warnings_backend -Haproxy Warnings Backend
=head1 CONFIGURATION
[haproxy*]
[haproxy*]
user root
env.backend backend_name_1 backend_name_2 backend_name_3
env.frontend frontend_name_1 frontend_name_2 frontend_name_3

View File

@ -9,9 +9,9 @@ ipvs_conn -Indicate the number of active servers in ipvs
=head1 CONFIGURATION
[ipvs_*]
user root
env.ips IP1 IP2
[ipvs_*]
user root
env.ips IP1 IP2
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ ipvs_conn -Indicate the number of bytes per second in ipvs
=head1 CONFIGURATION
[ipvs_*]
user root
env.ips IP1 IP2
[ipvs_*]
user root
env.ips IP1 IP2
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ ipvs_conn -Indicate the number of connections in ipvs
=head1 CONFIGURATION
[ipvs_*]
user root
env.ips IP1 IP2
[ipvs_*]
user root
env.ips IP1 IP2
=head1 AUTHOR

View File

@ -9,9 +9,9 @@ ipvs_conn -Indicate the number of connections per second
=head1 CONFIGURATION
[ipvs_*]
user root
env.ips IP1 IP2
[ipvs_*]
user root
env.ips IP1 IP2
=head1 AUTHOR

View File

@ -32,12 +32,12 @@ env.jobDepth How far into job "folders" should the plugin check for jobs
Example:
[jenkins_*]
env.url localhost
env.port 4040
env.context /jenkins
env.user user
env.apiToken aaaa0f6e48b92cbbbbddecdb72dc1dad
[jenkins_*]
env.url localhost
env.port 4040
env.context /jenkins
env.user user
env.apiToken aaaa0f6e48b92cbbbbddecdb72dc1dad
=head1 AUTHOR

View File

@ -6,8 +6,7 @@ set -e
=head1 NAME
jitsi_videobridge - Monitor sessions and conferences
on a jitsi-videobridge
jitsi_videobridge - Monitor sessions and conferences on a jitsi-videobridge
=head1 APPLICABLE SYSTEMS
@ -20,8 +19,8 @@ installed jq, a command-line json processor.
You may specify the URL where to get the statistics
[jitsi_videobridge]
env.url http://127.0.0.1:8080/colibri/stats
[jitsi_videobridge]
env.url http://127.0.0.1:8080/colibri/stats
... and you may disable the audiochannel when you don't use an
audio gateway.

View File

@ -12,7 +12,7 @@ http://siremis.asipto.com/install-charts-panel/
=head1 CONFIGURATION
[kamailio*]
[kamailio*]
user root
group root
env.mysql <optional-override-of-mysqladmin-path>
@ -49,7 +49,7 @@ Note: second parameter of sql_query(...) is a single line. Next version, based o
You have to create a new table in Kamailio (OpenSER) database:
CREATE TABLE `statistics` (
CREATE TABLE `statistics` (
`id` int(10) unsigned NOT NULL auto_increment,
`time_stamp` int(10) unsigned NOT NULL default '0',
`random` int(10) unsigned NOT NULL default '0',
@ -60,7 +60,7 @@ CREATE TABLE `statistics` (
`ul_users` int(10) unsigned NOT NULL default '0',
`ul_contacts` int(10) unsigned NOT NULL default '0',
PRIMARY KEY (`id`)
) ENGINE=MyISAM;
) ENGINE=MyISAM;
Now all is ready for Kamailio (OpenSER), you can restart it.

View File

@ -12,7 +12,7 @@ http://siremis.asipto.com/install-charts-panel/
=head1 CONFIGURATION
[kamailio*]
[kamailio*]
user root
group root
env.mysql <optional-override-of-mysqladmin-path>
@ -49,7 +49,7 @@ Note: second parameter of sql_query(...) is a single line. Next version, based o
You have to create a new table in Kamailio (OpenSER) database:
CREATE TABLE `statistics` (
CREATE TABLE `statistics` (
`id` int(10) unsigned NOT NULL auto_increment,
`time_stamp` int(10) unsigned NOT NULL default '0',
`random` int(10) unsigned NOT NULL default '0',
@ -60,7 +60,7 @@ CREATE TABLE `statistics` (
`ul_users` int(10) unsigned NOT NULL default '0',
`ul_contacts` int(10) unsigned NOT NULL default '0',
PRIMARY KEY (`id`)
) ENGINE=MyISAM;
) ENGINE=MyISAM;
Now all is ready for Kamailio (OpenSER), you can restart it.

View File

@ -22,10 +22,10 @@ Set username, password of admin user and if required an url in your
munin-node configuration. Default url is
http://127.0.0.1:9980/lool/getMetrics
[loolwsd]
env.username <lool_admin>
env.password <lool_password>
env.url <lool_getmetrics_url>
[loolwsd]
env.username <lool_admin>
env.password <lool_password>
env.url <lool_getmetrics_url>
You can set an administative user for loolwsd by invoking

View File

@ -23,11 +23,11 @@ failed_critical etc.
Example:
[nullmailer_queue]
user nullmail
env.queuedir /var/spool/nullmailer/queue
env.errordir /var/spool/nullmailer/failed
env.queue_warning 10
[nullmailer_queue]
user nullmail
env.queuedir /var/spool/nullmailer/queue
env.errordir /var/spool/nullmailer/failed
env.queue_warning 10
=head1 INTERPRETATION

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_bytes_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_bytes_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_bytes_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_bytes_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_connections_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_connections_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_connections_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_connections_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_hits_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_hits_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_hits_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_hits_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_items_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_items_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_items_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_items_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_requests_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_requests_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_requests_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_requests_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -11,13 +11,13 @@ use Cache::Memcached;
=head1 example config for /plugin-conf.d/munin-node
[memcached_traffic_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_traffic_1]
env.server 127.0.0.1:11211
env.label "first local server"
[memcached_traffic_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
[memcached_traffic_2]
env.server /var/run/memcached/memcached.sock
env.label "second local server"
=cut

View File

@ -14,7 +14,7 @@ Memcached Multi - A Plugin to monitor Memcached Servers (Multigraph)
The following configuration information can be overridden by placing environment definitions
like shown here, in a file located in /etc/munin/plugin-conf.d
[memcached_multi_*]
[memcached_multi_*]
env.host 127.0.0.1 *default*
env.port 11211 *default*
env.timescale 3 *default*
@ -32,7 +32,7 @@ The following configuration information can be overridden by placing environment
=head2 BASIC TROUBLESHOOTING
Please make sure you can telnet to your memcache servers and issue the
following commands: stats, stats settings, stats items and stats slabs.
following commands: stats, stats settings, stats items and stats slabs.
=head2 PLUGIN INFORMATION
@ -88,8 +88,8 @@ GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf suggest
#%# family=auto
#%# capabilities=autoconf suggest
=cut

View File

@ -8,7 +8,7 @@ memcached_servers_ - Munin multigraph plugin to monitor multiple memcache server
You need to configure the to-be-used servers and the corresponding labels separated
by spaace in your environment. Example:
[memcached_servers_*]
[memcached_servers_*]
env.addresses cache1.server.com:11211 cache2.server.com:11211
env.labels master slave

View File

@ -6,7 +6,7 @@ A Plugin to monitor Nagios Servers and their Performance (Multigraph)
=head1 MUNIN CONFIGURATION
[nagios_multi_*]
[nagios_multi_*]
user root
env.binary /usr/local/nagios/bin/nagiostats *default*
env.passive off *default*
@ -61,8 +61,8 @@ GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf suggest
#%# family=auto
#%# capabilities=autoconf suggest
=cut

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -40,8 +40,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -50,6 +50,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cpu OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -18,8 +18,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working:
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -39,12 +39,13 @@ Network Appliance. It reports the content of the v3Calls OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 VERSION
v1.0 - 06/19/2009 18:36:02 CEST
Initial revision
=head1 AUTHOR
@ -63,6 +64,8 @@ please report any to Guillaume Blairon E<lt>L<g@yom.be>E<gt>.
GPLv2 or (at your option) any later version.
SPDX-License-Identifier: GPL-2.0-or-later
=cut
use strict;

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -38,8 +38,8 @@ Network Appliance. It reports the content of the cifs OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -48,6 +48,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -19,8 +19,8 @@ insecure because it doesn't encrypt the community string.
The following parameters will help you get this plugin working :
[snmp_*]
env.community MyCommunity
[snmp_*]
env.community MyCommunity
If your community name is 'public', you should really worry about
security and immediately reconfigure your appliance.
@ -39,8 +39,8 @@ Network Appliance. It reports the content of the sis OID.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 BUGS
@ -49,6 +49,7 @@ This plugin wasn't tested on many hardware and only on Ontap 7.3.x.
=head1 AUTHOR
2013, Claudius Herder
NetApp is a registered trademark and Network Appliance is a trademark
of Network Appliance, Inc. in the U.S. and other countries.

View File

@ -1,19 +1,31 @@
#!/usr/bin/env python
"""
=head1 NAME
linux_if - munin plugin monitoring Linux network interfaces
=head1 DESCRIPTION
This is not a wildcard plugin. Monitored interfaces are controlled
by 'include', 'exclude' in config. By default, only statically
configured interfaces (and their sub-interfaces) are monitored.
Features:
* bonding - group bonding slave interfaces with master
* vlans - group vlan sub-interfaces with main (dot1q trunk) interface
plugin configuration:
=over
[linux_if]
=item bonding - group bonding slave interfaces with master
=item vlans - group vlan sub-interfaces with main (dot1q trunk) interface
=back
=head1 CONFIGURATION
[linux_if]
# run plugin as root (required if you have VLAN sub-interfaces)
user = root
@ -31,22 +43,44 @@ plugin configuration:
# default: true
env.include_configured_if = true
Include/exclude logic in detail. Interface name is matched..
1) if matched by any exclude pattern, then exclude. Otherwise next step.
2) if matched by any include pattern, then include, Otherwise next step.
3) if 'include_configured_if' is true and 'ifcfg-*' file exists then include
4) default is not to include interface in monitoring
5) automatically include sub-interface, if the parent interface is monitored
Include/exclude logic in detail. Interface name is matched according to the following rules:
=over 4
=item 1. if matched by any exclude pattern, then exclude. Otherwise next step.
=item 2. if matched by any include pattern, then include, Otherwise next step.
=item 3. if 'include_configured_if' is true and 'ifcfg-*' file exists then include
=item 4. default is not to include interface in monitoring
=item 5. automatically include sub-interface, if the parent interface is monitored
=back
Tested on: RHEL 6.x and clones (with Python 2.6)
TODO:
* implement 'data loaning' between graphs, removes duplicit measures
* add support for bridging
* configurable graph max based on interface speed
MUNIN MAGIC MARKER
#%# family=manual
=head1 TODO
=over 4
=item implement 'data loaning' between graphs, removes duplicit measures
=item add support for bridging
=item configurable graph max based on interface speed
=back
=head1 MAGIC MARKERS
#%# family=manual
=cut
"""
__author__ = 'Brano Zarnovican'

View File

@ -23,34 +23,39 @@ You can install bing by using (Ubuntu/Debian): apt-get install bing
The following example configuration shows all settings. Only "hosts" is required for
minimal configuration.
[multibandwidth]
user root
env.hosts example.org example2.org example3.org
env.samples 15
env.small_packet_size 44
env.big_packet_size 108
env.max_valid_bps 15728640
[multibandwidth]
user root
env.hosts example.org example2.org example3.org
env.samples 15
env.small_packet_size 44
env.big_packet_size 108
env.max_valid_bps 15728640
- env.hosts: space separated list of hostnames or IPs of the hosts to calculate the bandwidth.
=over 4
=item env.hosts: space separated list of hostnames or IPs of the hosts to calculate the bandwidth.
This setting is required.
- env.samples: Reset stats after sending this number of ECHO_REQUEST packets.
=item env.samples: Reset stats after sending this number of ECHO_REQUEST packets.
Defaults to 15 samples.
- env.small_packet_size: Specifies the number of data bytes to be sent in the small
=item env.small_packet_size: Specifies the number of data bytes to be sent in the small
packets. The default and minimum value is 44.
- env.big_packet_size: Specifies the number of data bytes to be sent in the big
=item env.big_packet_size: Specifies the number of data bytes to be sent in the big
packets. The default is 108. The size should be chosen so that big packet roundtrip times
are long enough to be accurately measured.
- env.max_valid_bps: bing have some random spikes. This variable is used to indicate
=item env.max_valid_bps: bing have some random spikes. This variable is used to indicate
the maximum value of mbps that can be recorded (in bps).
Defaults to the empty string (no validity check).
=back
=head1 MAGIC MARKERS
#%# capabilities=autoconf
#%# capabilities=autoconf
=head1 VERSION
@ -59,6 +64,7 @@ env.max_valid_bps 15728640
=head1 AUTHOR
Jose Manuel Febrer Cortés <https://www.linkedin.com/in/jfebrer/>
Marco Bertolas help <https://www.linkedin.com/in/bertolamarco/>
=head1 LICENSE

View File

@ -6,6 +6,7 @@
nn_ - Munin plugin to display misc newznab stats.
=head1 CONFIGURATION
This script is used to generate data for several graphs. To generate
@ -13,10 +14,13 @@ data for one specific graph, you need to create a symbolic link with a
name like nn_<GRAPH> to this script.
To get a graph over numbers of users use nn_users
=head1 APPLICABLE SYSTEMS
Any MySQL platform, tested by the author on MySQL 5.1.29 and 5.0.51
=head1 CONFIGURATION
This script is used to generate data for several graphs. To generate
@ -25,10 +29,10 @@ name like nn_<GRAPH> to this script.
connection parameters - use this in your plugin configuration file.
[nn_*]
env.mysqlconnection DBI:mysql:<yourdatabase>;host=127.0.0.1;port=3306
env.mysqluser <user>
env.mysqlpassword <password>
[nn_*]
env.mysqlconnection DBI:mysql:<yourdatabase>;host=127.0.0.1;port=3306
env.mysqluser <user>
env.mysqlpassword <password>
=head1 DEPENDENCIES
@ -39,10 +43,13 @@ env.mysqlpassword <password>
=back
=head1 THANKS
A special thanks to Kjell-Magne Øierud for the mysql_ plugin in munin which
gave me the inspiration and reusable code to create this plugin.
=head1 LICENSE
Copyright (C) 2012 Jan Astrup (cryzeck@synIRC)
@ -61,6 +68,8 @@ along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
USA.
SPDX-License-Identifier: GPL-2.0-only
=cut
use warnings;

View File

@ -26,13 +26,13 @@ nextcloud_<nextcloud-domain> to this file. You can even append a port
Set username and password in your munin-node configuration
[nextcloud_cloud.domain.tld]
env.username <nexcloud_user>
env.password <nextcloud_password>
env.api_path <default: /ocs/v2.php/apps/serverinfo/api/v1/info>
env.scheme <default: https>
env.timeout <default: 2s>
env.updates_warning <default: 1>
[nextcloud_cloud.domain.tld]
env.username <nexcloud_user>
env.password <nextcloud_password>
env.api_path <default: /ocs/v2.php/apps/serverinfo/api/v1/info>
env.scheme <default: https>
env.timeout <default: 2s>
env.updates_warning <default: 1>
It's advised to set an app password (for this plugin) in your nextcloud
instance and not to use the "real" password of your nextcloud user.

View File

@ -33,20 +33,19 @@ You need to have the Openfire "Load Statistic" Plugin-installed!
This plugin is configurable environment variables.
user root must be root user
env.statsfile path to stats.txt file
user root must be root user
env.statsfile path to stats.txt file
Example:
[openfire_*]
user root
env.statsfile /var/log/openfire/stats.txt
[openfire_*]
user root
env.statsfile /var/log/openfire/stats.txt
=head1 AUTHOR
Philipp Haussleiter <philipp@haussleiter.de> (email)
Philipp Haussleiter <philipp@haussleiter.de>
=head1 LICENSE

View File

@ -1,12 +1,12 @@
#!/usr/bin/perl
#
=head1 OPENTRACKER PLUGIN
=head1 NAME
A Plugin to monitor OpenTracker Servers and their Performance
=head1 MUNIN CONFIGURATION
[opentracker*]
[opentracker*]
env.host 127.0.0.1 *default*
env.port 6969 *default*
env.uri /stats *default*
@ -31,8 +31,8 @@ GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf suggest
#%# family=auto
#%# capabilities=autoconf suggest
=cut

View File

@ -25,8 +25,8 @@ Examples:
=head1 CONFIGURATION
[pf_tables_*]
user root
[pf_tables_*]
user root
=head1 INTERPRETATION

View File

@ -17,14 +17,17 @@ You will need the perl fastcgi::client on your host
You have to put this in your plugin.conf.d folder
# If your php process is listening on TCP
[php_fpm_process]
In case your php process is listening on TCP:
[php_fpm_process]
env.serveraddr 127.0.0.1
env.port 9000
env.path /status
# If your php process is listening on Unix Socket
[php_fpm_process]
In case your php process is listening on a Unix Socket:
[php_fpm_process]
env.sock /var/run/php-fpm.sock
env.path /status
@ -40,6 +43,7 @@ You have to put this in your plugin.conf.d folder
=head1 AUTHOR
Minitux
Olivier Mehani <shtrom+munin@ssji.net>
=head1 LICENSE

View File

@ -24,10 +24,18 @@ arris-sb6183 - Health monitoring plugin for Arris SB6183 Cable Modem
=head1 DESCRIPTION
This provides the following multigraphs:
* upstream and downstream power levels
* downstream signal to noise ratio
* downstream error counts
* uptime
=over 4
=item upstream and downstream power levels
=item downstream signal to noise ratio
=item downstream error counts
=item uptime
=back
The values are retrieved from the cable modem's status web pages at
192.168.100.1. So, this plugin must be installed on a munin node
@ -40,8 +48,8 @@ Make sure 192.168.100.1 is accessible through your firewall.
To have this register with munin as it's own host set the "env.hostname" in config.
Also ensure that the hostname set is listed in munin.conf.
[arris*]
env.hostname modem
[arris*]
env.hostname modem
=head1 TESTING

View File

@ -12,20 +12,28 @@ downstream channels. (Signal Power, SNR, Lock Status)
=head1 REQUIREMENTS
- BeautifulSoup
- pycryptodome
=over 4
=item BeautifulSoup
=item pycryptodome
=back
=head1 CONFIGURATION
=head2 Example
[arris]
env.url http://192.168.100.1
env.username admin
env.password yourpassword
[arris]
env.url http://192.168.100.1
env.username admin
env.password yourpassword
=head2 Parameters
url - URL to web-frontend
username - defaults to "admin"
password - valid password
@ -37,22 +45,25 @@ https://www.arris.com/products/touchstone-tg3442-cable-voice-gateway/
=head1 AUTHOR
Copyright (c) 2019 Daniel Hiepler <d-munin@coderdu.de>
Copyright (c) 2004-2009 Nicolas Stransky <Nico@stransky.cx>
Copyright (c) 2018 Lars Kruse <devel@sumpfralle.de>
Copyright (c) 2019 Daniel Hiepler <d-munin@coderdu.de>
Copyright (c) 2004-2009 Nicolas Stransky <Nico@stransky.cx>
Copyright (c) 2018 Lars Kruse <devel@sumpfralle.de>
=head1 LICENSE
Permission to use, copy, and modify this software with or without fee
is hereby granted, provided that this entire notice is included in
all source code copies of any software which is or includes a copy or
modification of this software.
THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR
IMPLIED WARRANTY. IN PARTICULAR, NONE OF THE AUTHORS MAKES ANY
REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE
MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR
PURPOSE.
Permission to use, copy, and modify this software with or without fee
is hereby granted, provided that this entire notice is included in
all source code copies of any software which is or includes a copy or
modification of this software.
THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR
IMPLIED WARRANTY. IN PARTICULAR, NONE OF THE AUTHORS MAKES ANY
REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE
MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR
PURPOSE.
=head1 MAGIC MARKERS

View File

@ -1,43 +1,70 @@
#!/usr/bin/python
"""
Munin plugin to monitor various items of data from an Apple Airport
Express/Extreme or a Time Capsule.
v1.0 by Chris Jones <cmsj@tenshu.net>
Copyright (C) 2011 Chris Jones
This script is released under the GNU GPL v2 license.
=head1 NAME
Munin plugin to monitor various items of data from an Apple Airport Express/Extreme or a Time Capsule.
=head1 INSTALLATION
To use this plugin, use specially named symlinks:
cd /etc/munin/plugins
ln -s /path/to/snmp__airport snmp_myairport_airport_clients
ln -s /path/to/snmp__airport snmp_myairport_airport_dhcpclients
ln -s /path/to/snmp__airport snmp_myairport_airport_rate
ln -s /path/to/snmp__airport snmp_myairport_airport_signal
ln -s /path/to/snmp__airport snmp_myairport_airport_noise
cd /etc/munin/plugins
ln -s /path/to/snmp__airport snmp_myairport_airport_clients
ln -s /path/to/snmp__airport snmp_myairport_airport_dhcpclients
ln -s /path/to/snmp__airport snmp_myairport_airport_rate
ln -s /path/to/snmp__airport snmp_myairport_airport_signal
ln -s /path/to/snmp__airport snmp_myairport_airport_noise
NOTE: the name 'myairport' should be a valid hostname or IP address for your
Airport. It can be any value, but it must not include the character '_'.
Now add a virtual host entry to your munin server's munin.conf:
[myairport]
address 123.123.123.123
user_node_name no
[myairport]
address 123.123.123.123
user_node_name no
(with the correct IP address, obviously)
this will create a virtual host in munin for the airport named 'myairport' and
produce graphs for:
* number of connected wireless clients
* number of active DHCP leases
* rate at which clients are connected (in Mb/s)
* signal quality of connected clients (in dB)
* noise level of connected clients (in dB)
# Magic markers
#%# capabilities=
#%# family=contrib manual
=over 4
=item number of connected wireless clients
=item number of active DHCP leases
=item rate at which clients are connected (in Mb/s)
=item signal quality of connected clients (in dB)
=item noise level of connected clients (in dB)
=back
=head1 AUTHORS
Copyright (C) 2011 Chris Jones <cmsj@tenshu.net>
=head1 LICENSE
This script is released under the GNU GPL v2 license.
SPDX-License-Identifier: GPL-2.0-only
=head1 MAGIC MARKERS
#%# capabilities=
#%# family=contrib manual
=cut
"""
import sys
import os

View File

@ -9,22 +9,25 @@ certificate_file_expiry - check the certificate validity of your certificates
Installing: Add list of your certificates prefixed by the type in munin plugin-conf.d
For openvpn ca.crt and crl.pem
[certificate_file_expiry]
user root
env.CERTS crl:/etc/openvpn/easy-rsa/keys/crl.pem x509:/etc/openvpn/easy-rsa/keys/ca.crt
[certificate_file_expiry]
user root
env.CERTS crl:/etc/openvpn/easy-rsa/keys/crl.pem x509:/etc/openvpn/easy-rsa/keys/ca.crt
For letsencrypt certificates
[certificate_file_expiry]
user root
env.CERTS x509:/etc/letsencrypt/live/domain1.example.com/cert.pem x509:/etc/letsencrypt/live/domain2.example.com/cert.pem
Warning and Critical levels can also be configured with env variables like this
[certificate_file_expiry]
...
# warn when certificate will be invalid within 5 days
env.warning 5:
# critical when certificate will be invalid within 1 day
env.critical 1:
[certificate_file_expiry]
user root
env.CERTS x509:/etc/letsencrypt/live/domain1.example.com/cert.pem x509:/etc/letsencrypt/live/domain2.example.com/cert.pem
Warning and Critical levels can also be configured with env variables like this:
[certificate_file_expiry]
...
# warn when certificate will be invalid within 5 days
env.warning 5:
# critical when certificate will be invalid within 1 day
env.critical 1:
=head1 Dependencies
@ -32,8 +35,7 @@ Dependencies: openssl
=head1 AUTHOR
andreas perhab - andreas.perhab@wt-io-it.at
https://www.wt-io-it.at/
andreas perhab - andreas.perhab@wt-io-it.at (https://www.wt-io-it.at/)
=head1 LICENSE

View File

@ -10,11 +10,11 @@ see https://letsencrypt.org/docs/rate-limits/
You can configure the warning and critical limits for this plugin:
[letsencrypt_weekly]
# warn when more than 40 certificates have been requested in the last week
env.warning :40
# critical when more than 50 certificates have been requested in the last week
env.critical :50
[letsencrypt_weekly]
# warn when more than 40 certificates have been requested in the last week
env.warning :40
# critical when more than 50 certificates have been requested in the last week
env.critical :50
=head1 Dependencies
@ -22,8 +22,7 @@ Dependencies: openssl
=head1 AUTHOR
andreas perhab - andreas.perhab@wt-io-it.at
https://www.wt-io-it.at/
andreas perhab - andreas.perhab@wt-io-it.at (https://www.wt-io-it.at/)
=head1 LICENSE

View File

@ -1,34 +1,52 @@
#!/bin/sh
: <<=cut
=head1 NAME
strelaysrv_ - Plugin to monitor Syncthing relay server
=head1 DESCRIPTION
This plugin gathers metrics from a Syncthing relay server.
This plugin requires the jq utility : https://stedolan.github.io/jq/
This plugin requires the curl utility : https://curl.haxx.se/
Available plugins :
strelaysrv_goroutine #
strelaysrv_num #
strelaysrv_proxied #
strelaysrv_transfer #
strelaysrv_uptime #
Available wildcard plugin features:
=over 4
=item strelaysrv_goroutine
=item strelaysrv_num
=item strelaysrv_proxied
=item strelaysrv_transfer
=item strelaysrv_uptime
=back
=head1 CONFIGURATION
To make the plugin connect to the Syncthing relay server one has to use this type of
configuration
[strelaysrv_*]
env.syncthing_relaysrv_host 127.0.0.1
env.syncthing_relaysrv_port 22070
To make the plugin connect to the Syncthing relay server one has to use this type of
configuration:
[strelaysrv_*]
env.syncthing_relaysrv_host 127.0.0.1
env.syncthing_relaysrv_port 22070
=head1 AUTHOR
Pierre-Alain TORET <pierre-alain.toret@protonmail.com>
=head1 LICENSE
MIT
SPDX-License-Identifier: MIT
=cut
syncthing_relaysrv_host=${syncthing_relaysrv_host:-}

View File

@ -2,36 +2,56 @@
# -*- sh -*-
: <<=cut
=head1 NAME
syncthing_ - Plugin to monitor Syncthing server
=head1 DESCRIPTION
This plugin gathers metrics from a Syncthing server.
This plugin requires the jq utility : https://stedolan.github.io/jq/
This plugin requires the cURL utility : https://curl.haxx.se/
Available plugins :
syncthing_cpu #
syncthing_mem #
syncthing_goroutine #
syncthing_transfer #
syncthing_uptime #
Available wildcard plugin features:
=over 4
=item syncthing_cpu
=item syncthing_mem
=item syncthing_goroutine
=item syncthing_transfer
=item syncthing_uptime
=back
=head1 CONFIGURATION
To make the plugin connect to the Syncthing server one has to use this type of
configuration
[syncthing_*]
configuration:
[syncthing_*]
env.syncthing_apikey myapikey0123456789
env.syncthing_host 127.0.0.1
env.syncthing_port 8384
env.syncthing_proto http
env.syncthing_apikey myapikey0123456789
env.syncthing_host 127.0.0.1
env.syncthing_port 8384
env.syncthing_proto http
=head1 AUTHOR
Pierre-Alain TORET <pierre-alain.toret@protonmail.com>
=head1 LICENSE
MIT
SPDX-License-Identifier: MIT
=cut
syncthing_apikey=${syncthing_apikey:-}

View File

@ -18,21 +18,25 @@ None need
You can set warning and critical levels for each of the data
series the plugin reports.
'General' graph support cpu-irqtype limits and irqtype limits
Examples:
[irq]
env.warning_cpu1_sirq_total 550
env.critical_cpu0_irq_total 600
env.warning_irq_total 700
env.critical_sirq_total 700
[irq]
env.warning_cpu1_sirq_total 550
env.critical_cpu0_irq_total 600
env.warning_irq_total 700
env.critical_sirq_total 700
'Child' graphs support cpu-irqtype-irqname and irqtype-irqname limits
Examples:
[irq]
env.warning_cpu0_irq_7 100
env.critical_cpu1_sirq_HI 100
env.warning_irq_LOC 100
env.critical_irq_12 200
env.warning_sirq_BLOCK 1000
[irq]
env.warning_cpu0_irq_7 100
env.critical_cpu1_sirq_HI 100
env.warning_irq_LOC 100
env.critical_irq_12 200
env.warning_sirq_BLOCK 1000
Note: irqtype: sirq, irq; sirq - Software IRQ; irq name you can see in [] on graph

View File

@ -12,8 +12,8 @@ openvpn_as_time -Indicate the medium time of the logged users.
Require jsonpipe software:
https://github.com/dvxhouse/jsonpipe
[openvpn_*]
user root
[openvpn_*]
user root
=head1 AUTHOR

View File

@ -12,8 +12,8 @@ openvpn_as_traffic -OpenVPN traffic
Require jsonpipe software:
https://github.com/dvxhouse/jsonpipe
[openvpn_as*]
user root
[openvpn_as*]
user root
=head1 AUTHOR

View File

@ -12,8 +12,8 @@ openvpn_as_time -Indicate user logged time.
Require jsonpipe software:
https://github.com/dvxhouse/jsonpipe
[openvpn_*]
user root
[openvpn_*]
user root
=head1 AUTHOR

View File

@ -9,8 +9,8 @@ openvpn_as_users -Indicate the number of users and the license limit
=head1 CONFIGURATION
[openvpn_*]
user root
[openvpn_*]
user root
=head1 AUTHOR

View File

@ -33,9 +33,12 @@ along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
SPDX-License-Identifier: GPL-2.0-only
=head1 CONFIGURATION
[zimbra_mailboxsizes]
user zimbra
[zimbra_mailboxsizes]
user zimbra
=head1 MAGIC MARKERS