From 6d082e61aeebe150c51d25b45f34d16a62893854 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Markus=20Waldm=C3=BCller?= Date: Fri, 29 Jul 2016 11:29:40 +0200 Subject: [PATCH] Add check command definition for check_graphite fixes #12256 Signed-off-by: Gunnar Beutner --- doc/7-icinga-template-library.md | 24 +++++++++++ itl/plugins-contrib.d/CMakeLists.txt | 2 +- itl/plugins-contrib.d/metrics.conf | 62 ++++++++++++++++++++++++++++ 3 files changed, 87 insertions(+), 1 deletion(-) create mode 100644 itl/plugins-contrib.d/metrics.conf diff --git a/doc/7-icinga-template-library.md b/doc/7-icinga-template-library.md index e85b83a0b..e42f3bdc7 100644 --- a/doc/7-icinga-template-library.md +++ b/doc/7-icinga-template-library.md @@ -1972,6 +1972,30 @@ ipmi_number_of_active_fans | **Optional.** Number of fans that should be a ipmi_show_fru | **Optional.** Print the product serial number if it is available in the IPMI FRU data. ipmi_no_sel_checking | **Optional.** Turn off system event log checking via ipmi-sel. +### Metrics + +This category includes all plugins for metric-based checks. + +#### graphite + +Check command object for the [check_graphite](https://github.com/obfuscurity/nagios-scripts) plugin. + +Custom attributes passed as [command parameters](3-monitoring-basics.md#command-passing-parameters): + +Name | Description +------------------------------------|----------------------------------------------------------------------------------------------------- +graphite_url | **Required.** Target url. +graphite_metric | **Required.** Metric path string. +graphite_shortname | **Optional.** Metric short name (used for performance data). +graphite_duration | **Optional.** Length, in minute of data to parse (default: 5). +graphite_function | **Optional.** Function applied to metrics for thresholds (default: average). +graphite_warning | **Required.** Warning threshold. +graphite_critical | **Required.** Critical threshold. +graphite_units | **Optional.** Adds a text tag to the metric count in the plugin output. Useful to identify the metric units. Doesn't affect data queries. +graphite_message | **Optional.** Text message to output (default: "metric count:"). +graphite_zero_on_error | **Optional.** Return 0 on a graphite 500 error. +graphite_link_graph | **Optional.** Add a link in the plugin output, showing a 24h graph for this metric in graphite. + ### Network Components This category includes all plugins for various network components like routers, switches and firewalls. diff --git a/itl/plugins-contrib.d/CMakeLists.txt b/itl/plugins-contrib.d/CMakeLists.txt index 0ce1e66a6..d2b130e5e 100644 --- a/itl/plugins-contrib.d/CMakeLists.txt +++ b/itl/plugins-contrib.d/CMakeLists.txt @@ -16,6 +16,6 @@ # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. install( - FILES databases.conf icingacli.conf ipmi.conf network-components.conf operating-system.conf virtualization.conf vmware.conf web.conf hardware.conf network-services.conf + FILES databases.conf icingacli.conf ipmi.conf network-components.conf operating-system.conf virtualization.conf vmware.conf web.conf hardware.conf network-services.conf metrics.conf DESTINATION ${CMAKE_INSTALL_DATADIR}/icinga2/include/plugins-contrib.d ) diff --git a/itl/plugins-contrib.d/metrics.conf b/itl/plugins-contrib.d/metrics.conf new file mode 100644 index 000000000..f7734de19 --- /dev/null +++ b/itl/plugins-contrib.d/metrics.conf @@ -0,0 +1,62 @@ +object CheckCommand "graphite" { + import "plugin-check-command" + + command = [ PluginContribDir + "/check_graphite" ] + + arguments = { + "-u" = { + value = "$graphite_url$" + description = "Target url" + required = true + } + "-m" = { + value = "$graphite_metric$" + description = "Metric path string" + required = true + } + "-s" = { + value = "$graphite_shortname$" + description = "Metric short name (used for performance data)" + } + "-d" = { + value = "$graphite_duration$" + description = "Length, in minute of data to parse (default: 5)" + } + "-f" = { + value = "$graphite_function$" + description = "Function applied to metrics for thresholds (default: average)" + } + "-w" = { + value = "$graphite_warning$" + description = "Warning threshold" + required = true + } + "-c" = { + value = "$graphite_critical$" + description = "Critical threshold" + required = true + } + "-U" = { + value = "$graphite_units$" + description = "Adds a text tag to the metric count in the plugin output. Useful to identify the metric units. Doesn't affect data queries." + } + "-M" = { + value = "$graphite_message$" + description = "Text message to output (default: 'metric count:')" + } + "-z" = { + set_if = "$graphite_zero_on_error$" + description = "Return 0 on a graphite 500 error" + } + "-l" = { + set_if = "$graphite_link_graph$" + description = "Add a link in the plugin output, showing a 24h graph for this metric in graphite." + } + } + + vars.graphite_duration = "5" + vars.graphite_function = "average" + vars.graphite_message = "metric count:" + vars.graphite_zero_on_error = false + vars.graphite_link_graph = false +} -- 2.50.1