Nagios

• Setup
• Metrics

This plugin is ported from the Telegraf Exec Input Plugin. It runs a script and reads its output. The plugin is able to parse Nagios metrics.

Setup

The nagios plugin is included with the SolarWinds Snap Agent by default, please follow the directions below to enable it for a agent instance.

Configuration

The agent provides an example configuration file to help you get started quickly. It defines the plugin and task file to be loaded by the agent, but requires you to provide the correct settings for your installation. In this example we are running a check_load command. To enable the plugin:

1. Make a copy of the exec example configuration file /opt/SolarWinds/Snap/etc/plugins.d/nagios.yaml.example, renaming it to /opt/SolarWinds/Snap/etc/plugins.d/nagios.yaml:

Copy

$ sudo cp /opt/SolarWinds/Snap/etc/plugins.d/nagios.yaml.example /opt/SolarWinds/Snap/etc/plugins.d/nagios.yaml

2. Update the /opt/SolarWinds/Snap/etc/plugins.d/nagios.yaml configuration file with settings specific to your use case, for example:

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
collector:
  nagios_exec:
    all:
      ## Commands array
      commands: ["/usr/lib/nagios/plugins/check_load -w 5,6,7 -c 7,8,9"]
      ## Timeout for each command to complete.
      timeout: "5s"
      ## measurement name suffix (for separating different commands)
      name_suffix: "_mycollector"
      ## Metric name prefix
      # bridge_prefix: "nagios"
      # bridge_prefix: ""
load:
  plugin: snap-plugin-collector-bridge-nagios_exec
  task: task-bridge-nagios_exec.yaml

3. Restart the agent:

Copy

$ sudo service swisnapd restart

4. Enable the Nagios plugin

   When you log in to AppOptics you should see Nagios listed in the Plugin section on the home page. You will also find it on the Integrations Page. Clicking on the widget will open up a window that shows you the list of metrics that the plugin is collecting. Activate the plugin by clicking on the "Enable Plugin" button, then select the metrics you would like to see on a dashboard and click on the "Send Metrics to Dashboard" button.

See more examples in the Telegraf Exec Input Plugin docs.

Metrics

The collected metrics will be prefixed with nagios.* in AppOptics (or the configured value for bridge_prefix on the plugin configuration).

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.