salt.modules.nagios
Run nagios plugins/checks from salt and get the return as data.
-
List all the nagios plugins
CLI Example:
salt '*' nagios.list_plugins
salt.modules.nagios.list_plugins()
-
Run one nagios plugin and return retcode of the execution
salt.modules.nagios.retcode(plugin, args='', key_name=None)
-
Run one or more nagios plugins from pillar data and get the result of cmd.retcode The pillar have to be in this format:
------ webserver: Ping_google: - check_icmp: 8.8.8.8 - check_icmp: google.com Load: - check_load: -w 0.8 -c 1 APT: - check_apt -------
webserver is the role to check, the next keys are the group and the items the check with the arguments if needed
You must to group different checks(one o more) and always it will return the highest value of all the checks
CLI Example:
salt '*' nagios.retcode webserver
salt.modules.nagios.retcode_pillar(pillar_name)
-
Run nagios plugin and return all the data execution with cmd.run
CLI Example:
salt '*' nagios.run check_apt salt '*' nagios.run check_icmp '8.8.8.8'
salt.modules.nagios.run(plugin, args='')
-
Run nagios plugin and return all the data execution with cmd.run_all
salt.modules.nagios.run_all(plugin, args='')
-
Run one or more nagios plugins from pillar data and get the result of cmd.run_all The pillar have to be in this format:
------ webserver: Ping_google: - check_icmp: 8.8.8.8 - check_icmp: google.com Load: - check_load: -w 0.8 -c 1 APT: - check_apt -------
webserver is the role to check, the next keys are the group and the items the check with the arguments if needed
You have to group different checks in a group
CLI Example:
salt '*' nagios.run webserver
salt.modules.nagios.run_all_pillar(pillar_name)
-
Run one or more nagios plugins from pillar data and get the result of cmd.run The pillar have to be in this format:
------ webserver: Ping_google: - check_icmp: 8.8.8.8 - check_icmp: google.com Load: - check_load: -w 0.8 -c 1 APT: - check_apt -------
webserver is the role to check, the next keys are the group and the items the check with the arguments if needed
You have to group different checks in a group
CLI Example:
salt '*' nagios.run webserver
salt.modules.nagios.run_pillar(pillar_name)
© 2021 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.nagios.html