PagerDuty is a platform that helps manage IT operations by providing alert monitoring, on-call scheduling, and escalation policies. It allows teams to quickly respond to incidents and fix issues in applications, servers, and websites.

PagerDuty integrates with a wide range of tools and services, including Roxy-WI, allowing teams to enhance their incident management processes. In this article, we will describe how to integrate PagerDuty with Roxy-WI.

Checker is a service that monitors HAProxy, NGINX, Apache and Keepalived services as well as HAProxy backends. Checker sends a notification via Telegram, Slack, email, PagerDuty and/or Mattermost when a backend or service is down. It also supports real-time alerting via the Roxy-WI panel and stores the history of incidents.

First, obtain your integration key from PagerDuty. To do this, log in to your PagerDuty account and go to the Services page. From there, you can either select an existing service to retrieve its integration key or create a new service if needed. If you choose to create a new service, follow the prompts to set it up, and the integration key will be generated for you.

How to create PagerDuty Integration Key

After this, go to the Integration tab. Click Add another integration, then select Events API V2 and click Add. You will be redirected back to the Integration tab.

Next, click Events API V2 once more, and copy the new integration key from the yellow box.

How to create PagerDuty Integration Key
icon
Read how to install Checker here

After obtaining the integration key, create a channel in Roxy-WI. Go to the Monitoring => Channels section and click Add in the PagerDuty Channels area. In the form that appears, enter the integration key in the "Token" field, provide a name in the "Channel" field, and select a group if necessary.

How to create PagerDuty Integration Key

To verify that the integration has been successfully completed, click Test. Roxy-WI will then send a test message to PagerDuty.

After this, the PagerDuty channel is ready for use. Go to the Monitoring => Checker: Settings section and select the PD channel for the services you want to receive alerts for:

Roxy-WI checker
Go to TOP

Additionally, once a checker is enabled for servers, Roxy-WI begins collecting incident history, which can be valuable for future debugging. You can find it in the Monitoring => Checker: History section:

Roxy-WI checker history