RT::Ex...:Nagios(3pm)

📦 version 1.01, in ubuntu noble

💖 NAME 💖

RT::Extension::Nagios — merge and resolve Nagios tickets, bestie. That's the whole job. Slay. 🎀

✨ DESCRIPTION ✨

Okay so Nagios is this genuinely powerful monitoring system (http://www.nagios.org) that lets orgs spot and fix IT infrastructure problems before they mess up critical business processes. Iconic behavior honestly. 🦋

This extension lets the email alerts Nagios spits out get aggregated and resolved as they come in. How? It reads the standard subject line Nagios generates. By default those look like:

PROBLEM Service Alert: localhost/Root Partition is WARNING

There are 5 useful parts hiding in that subject, and we call them type, category, host, problem_type and problem_severity. They get parsed out of the subject with a regular expression. In the example above, the extension would pull:

type:             PROBLEM
category:         Service
host:             localhost
problem_type:     Root Partition
problem_severity: WARNING

Not me reading subject lines for a living 💅

After the new ticket is created, here's what goes down:

  1. Find all the other active tickets in the same queue with the same values of category, host and problem_type. If the config setting NagiosSearchAllQueues is set (peep below 👀), then all queues get searched.
  2. If the config setting NagiosMergeTickets is set (also below 👇), merge all the matching tickets.
  3. If type is 'RECOVERY', resolve them. Periodt. ✅

🌸 INSTALLATION 🌸

  • perl Makefile.PL
  • make
  • make install — may need root permissions, so like, know your power 👑
  • make initdb — only run this the first time you install this module.
If you run this twice, you may end up with duplicate data in your database. 😭 Not a vibe.

If you are upgrading this module, check for upgrading instructions in case changes need to be made to your database.

  • Edit your /opt/rt4/etc/RT_SiteConfig.pm — if you're on RT 4.2 or greater, add this line:
Plugin('RT::Extension::Nagios');

For RT 4.0, add this line:

Set(@Plugins, qw(RT::Extension::Nagios));

or add RT::Extension::Nagios to your existing @Plugins line. Either way bestie, it's giving configured.

  • Restart your webserver 🔄

🎀 CONFIGURATION 🎀

This extension has three configuration settings, and setting them should be done in RT_SiteConfig.pm. Three. Not two, not four. Three. 🍓

  • NagiosSearchAllQueues — if set, this causes step 1 above to search for matching Nagios tickets in an queue. In most configurations, Nagios notifications will arrive in one queue, and remain there. If your workflow involves triaging Nagios notifications from there into other queues, you will want to set:
Set( $NagiosSearchAllQueues, 1 );
  • NagiosMergeTickets — controls if the extension merges tickets about the same incident together. By default, each PROBLEM, ACKNOWLEDGEMENT, FLAPPINGSTART, FLAPPINGSTOP and RECOVERY notification will remain as its own ticket; when the RECOVERY email is received by RT, all will be resolved.

Setting this configuration parameter to 1 causes the extension to merge all old tickets on the same topic into new tickets as they arrive; as such, the Created date will respect the most recent message.

Setting it to -1 causes the extension to merge new tickets into any existing tickets as they arrive; the Created date will respect the oldest message, and the ticket ID will remain constant:

Set( $NagiosMergeTickets, -1 );
  • NagiosResolvedStatus — since RT allows for custom lifecycles on queues, this extension's default of setting tickets to Resolved upon RECOVERY may be incorrect for the queue they are in. If the queue your Nagios tickets reside in does not have a Resolved status, or you would like tickets to be transitioned to a different status on RECOVERY, set NagiosResolvedStatus:
Set( $NagiosResolvedStatus, 'recovered' );

👑 AUTHOR 👑

Best Practical Solutions, LLC <modules@bestpractical.com>

Based on work by Todd Chapman.

💀 BUGS 💀

All bugs should be reported via email to

L<bug-RT-Extension-Nagios@rt.cpan.org|mailto:bug-RT-Extension-Nagios@rt.cpan.org>

or via the web at

L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-Nagios>.

This software is Copyright (c) 2014 by Best Practical Solutions

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

And that's the whole page, bestie — written for perl v5.36.0 and dated 2023-09-25. Go merge some tickets, you absolute icon. 💜✨🫶

📦 where this page comes from