In order to be able to send notifications to Slack channels open incidents in PagerDuty directly from XpoLog (via monitors' alerts or via share search in the search console) it is required to define webhooks to the desired channels service(s) in your Slack workspacePagerDuty account.
XpoLog requires internet access to publish messages to Slack.
Slack integration:
...
(HTTPS port 443) to open incidents in PagerDuty.
PagerDuty integration setup
In PagerDuty
- Generate integration keys (PagerDuty side):
- Go to : https://get.slack.help/hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack
- Follow the listed steps:
- Click the "Set up Incoming Webhooks" link to go to that section
- Create an app in Slack (You'll need to sign in to your Slack account to create an application).
- Give the app a name and tag it to the desired workspace, save it.
- In the app screen, select the "Incoming Webhooks" section (enable Incoming Webhooks if the option is disabled)
- Click the "Add new Webhook", select to which channel the post messages using this Webhook and save.
- You may repeat #v to create multiple Webhook to multiple channels.
- Copy the Webhooks you wish to use in XpoLog with their associated channel name.
- your PagerDuty console, sign in and select Services > Service Directory
You can either add an integration to an existing service or to create a new service:
- If you are adding your integration to an existing service: Click the name of the service you want to add the integration to. Then, select the Integrations tab and click the 'Add a new integration' link.
- If you are creating a new service for your integration: Please read the documentation and follow the steps to create a service. Select XPLG as the Integration Type and click the Add Integration button:
- An Integration Key will be generated. Copy the key and save it in a safe place, as it will be used when you configure the integration with XpoLog in the next section.:
- Alternatively, if you are using an Event Rule - go to Automation > Event Rules and copy the integration key from the Ruleset you wish to use:
In XpoLog
- Go to XpoLog Manager left navigation panel Settings > System Settings
- Under the Notifications section click SET next to the
Slack - PagerDuty part.
The Slack - The PagerDuty configuration screen opens.
- Enter the
channel - Service name and
it's associated Webhook - the associated integration key and click create.
- You may create as
many channels Webhooks - the associated integration key and click create.
- many integrations as needed.
- Save -
a message - an incident will be
published to - opened in all configured
channels - services to indicate that XpoLog is capable of
publishing messages- creating incidents.
Note: if you wish to get System alerts (automatically generated by XpoLog system) to one or more of the configured channels, check the checkbox under the ALERT column next to that channel.
To Remove the PagerDuty Alert Channel:
- Go to XpoLog Manager left navigation panel Settings > System Settings
- Under the Notifications section click SET next to the PagerDuty part. The PagerDuty configuration screen opens.
- Remove the channel(s) you wish to disable alerting to and save the updated configuration.
SUPPORT:
If you need help with this integration, please email us at support@xplg.com or via https://support.xpolog.com