Nagios is a comprehensive enterprise-class open source monitoring service. You can use our Metricly Event Handler to send your Nagios events to Metricly.

Sending Nagios Events to Metricly

  1. Hover on your account name in the top right-hand corner and click API Keys from the drop-down menu.
  2. Copy the API Key from the Custom integration in the table.
  3. Install the Metricly Event Handler.
    1. Download the Netuitive Event Handler to the /bindirectory.
      sudo curl -o "/bin/netuitive-event-handler"
      If you’d rather manually download and install the executable, visit our repo.
    2. Ensure the file is executable (use the chmodcommand).
      sudo chmod 755 /bin/netuitive-event-handler
    3. Create and configure the /etc/netuitive/netuitive-event-handler.yaml file using the API key you copied in step 2 and the URL to the events ingest API.
      apikey: your-apikey
      url: ""
  4. On your Nagios server, navigate to the commands.cfg file.
    The default location is etc/nagios/objects/commands.cfg.
  5. In the commands.cfg file, create a host and service notification.
    1. Host notification:
      define command{
        command_name	notify-host-by-netuitive-event
        command_line	/bin/netuitive-event-handler -s Nagios -e "$HOSTALIAS$" -t "Host 
      $HOSTALIAS$ is $HOSTSTATE$" -l 
      "$HOSTSTATE$"  -m "Host $HOSTALIAS$ is 
    2. Service notification:
      define command{
        command_name	notify-service-by-netuitive-event
        command_line	/bin/netuitive-event-handler -s Nagios -e "$HOSTALIAS$" -t 
      "Service $SERVICEDESC$ is $SERVICESTATE$" -
      l "$SERVICESTATE$"  -m "Service 
  6. Open the Nagios UI.
  7. Under the Shortcuts column, click Hosts.
  8. Select the checkbox next to your Nagios host server, and then click Edit .
  9. Under the Actions section of the menu on the right, click Add Service Checks.
  10. Input a Service Description.
  11. Click Save service and let me edit it further.
  12. Once the service has been saved, click the Advanced tab.
  13. In the check_command field, input the command you want Nagios to run to perform the service check.

    The following example will check to see if the Metricly Linux agent is running; if it is running, it will send a critical event to Metricly. Note that the below command was sent using NRPE, and your syntax may change depending on the plugin you’re using.

    check_nrpe!check_procs -a 1:1 1:1 'netuitive-agent - Handlers' S
  14. In the event_handler field, input the following:
  15. In the event_hander_enabled field, input a 1 to enable the event handler.
  16. Check Metricly for your new Nagios events.