PagerDuty template

zdunning13 · 18 February 2019 19:54

We recently upgraded our system to 7.2.15. Everything seems to be working aside from our PagerDuty integration. I’m relatively new to the organization and I’m not sure how the integration was set up originally. I have gone through and converted the base templates in “Alert Templates”, but I’m not sure how to get PagerDuty notifications back up and running.

Any suggestions on where to find PagerDuty templates would be appreciated.

====================================

Component	Version
LibreNMS	1.48.1-152-g177ca9f
DB Schema	2019_01_16_195644_add_vrf_id_and_bgpLocalAs (131)
PHP	7.2.15-1+ubuntu16.04.1+deb.sury.org+1
MySQL	10.0.38-MariaDB-0ubuntu0.16.04.1
RRDTool	1.5.5
SNMP	NET-SNMP 5.7.3

====================================

[OK] Composer Version: 1.8.4
[OK] Dependencies up-to-date.
[OK] Database connection successful
[OK] Database schema correct

Chas · 18 February 2019 21:34

I would check your alert transport settings in LibreNMS (Default ON etc.) , and API settings on pagerduty portal are all OK.

You can also test the transport via CLI

./scripts/test-alert.php -d

The alert templates are not transport specific.

zdunning13 · 18 February 2019 22:01

So if I go to Alerts > Alert Transports in LibreNMS I am taken to a blank screen with no controls. Is this the right menu? PagerDuty integration looks fine.

Testing the transport via CLI throws the following. Does this need to be converted like the default default transports in Alerts > Alert Templates?

zdunning13 · 18 February 2019 22:29

Figured it out. We replaced the existing Pagerduty.php with the following:

github.com

librenms/librenms/blob/master/LibreNMS/Alert/Transport/Pagerduty.php

<?php
/* Copyright (C) 2015 Daniel Preussker <[email protected]>
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>. */

/**
 * PagerDuty Generic-API Transport
 * @author f0o <[email protected]>
 * @copyright 2015 f0o, LibreNMS
 * @license GPL

This file has been truncated. show original

murrant · 18 February 2019 22:34

I don’t understand what you have done, that is the exact version upstream.

You should probably check ./validate.php

zdunning13 · 19 February 2019 17:02

Looks like we get the below warning now. But PagerDuty transports are working:

====================================

Component	Version
LibreNMS	1.48.1-157-g9db9104
DB Schema	2019_01_16_195644_add_vrf_id_and_bgpLocalAs (131)
PHP	7.2.15-1+ubuntu16.04.1+deb.sury.org+1
MySQL	10.0.38-MariaDB-0ubuntu0.16.04.1
RRDTool	1.5.5
SNMP	NET-SNMP 5.7.3

====================================

[OK] Composer Version: 1.8.4
[OK] Dependencies up-to-date.
[OK] Database connection successful
[OK] Database schema correct
[WARN] Your local git contains modified files, this could prevent automatic updates.
[FIX]:
You can fix this with ./scripts/github-remove
Modified Files:
LibreNMS/Alert/Transport/Pagerduty.php

murrant · 21 February 2019 17:51

What does git diff show then?

Heath_Barnhart · 23 March 2020 13:51

Any update for this? I’m starting to use PagerDuty and noticed the PagerDuty transport is not using the template assigned to the alert rule to format notifications sent to PagerDuty.

Heath_Barnhart · 21 April 2020 21:03

github.com/librenms/librenms

PagerDuty Transport Improvement

librenms:master ← h-barnhart:pd-transport

opened 09:02PM - 21 Apr 20 UTC

h-barnhart

+1 -1

Sends the message output of the alert template to PagerDuty as custom data inste…ad of the fault data similar to the default template. This gives the user more flexibility in the data sent to PagerDuty. The images below show information from alerts sent from LibreNMS to PagerDuty. The top image is a Device Down alert sent using the current code, and the After image is using the changed code. **Before:** ![PD-before-transport](https://user-images.githubusercontent.com/44616159/79913507-55e65b00-83e9-11ea-9140-2515516fd7c8.png) **After:** ![PD-after-transport](https://user-images.githubusercontent.com/44616159/79913474-45ce7b80-83e9-11ea-868b-f6ef2fac6353.png) DO NOT DELETE THE UNDERLYING TEXT #### Please note > Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting. - [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/) - [x] If my Pull Request does some changes/fixes/enhancements in the WebUI, I have inserted a screenshot of it. #### Testers If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926` After you are done testing, you can remove the changes with `./scripts/github-remove`. If there are schema changes, you can ask on discord how to revert.