LibreNMS Integration Guide

LibreNMS is an autodiscovering PHP/MySQL/SNMP based network monitoring which includes support for a wide range of network hardware and operating systems including Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP and many more. LibreNMS is a community-based fork of Observium.

Please contact support if you have any questions.

In your LibreNMS web interface

  1. Click the Alerts menu item and click Alert Transport.
  2. Click the blue Create alert transport button.
  3. Select PagerDuty from the list. Click the Alert with PagerDuty button to authenticate and select your PagerDuty service to integrate with.
  4. Fill in your emailpassword and click on Authorize Integration to continue.
    librenms-pd-05
  5. On this page, you’ll either create a new LibreNMS service, giving it a name and selecting the escalation policy to use or you can select an existing LibreNMS service, if it exists. Click Finish Integration to complete the process.
    librenms-pd-06
  6. That’s it! If you have the green checkmark in the box, you are all set!
  7. You may want to edit it and change Default to yes to enable for all alert rules by default. Otherwise you can manually select PageDuty in the rule edit window.

FAQ

Does LibreNMS resolve PagerDuty incidents once the issue has been resolved?

Yes, incidents will be resolved in PagerDuty once LibreNMS detects that it’s no longer an issue.

If I acknowledge or resolve an incident within PagerDuty, will those reflect in LibreNMS?

No, at this time we do not have a two-way integration with LibreNMS.

I’m not able to trigger or resolve PagerDuty incidents from LibreNMS. What could be wrong?

Check that your timezone in PHP and MySQL both match the system timezone. If they do not, you will not see any notifications.