Integrate Splunk with StatusHub
This article takes you through the steps to integrate your Splunk account with StatusHub.
In StatusHub:
To connect Splunk to your account, click on 'Services and Integrations' in the Hub Config section.
In the Services and Integrations section, click the right arrow.
You will then see these options appear. Click on the 3 dots to the right to reveal the drop-down menu and choose the Edit option.
Under Edit services, select Integrations and choose Splunk, then save.
After you select the Splunk option, we will generate a webhook for you to use at Splunk.
In Splunk:
- Go to the available integrations tab and search for Webhook.
- Add webhook name and method. In the 'URL' field, paste the webhook you copied from StatusHub.
- You can customize your webhook payload. Required fields are:
incidentId, messageTitle, severity, statusExtended, and timestamp. Optionally, you can add a draft field.
Save your settings once the webhook is ready.
Splunk fields mapping in StatusHub
| Splunk field | StatusHub meaning |
| messageTitle (required) | Incident Update title. |
| messageBody (required) | Incident Update message. |
| timestamp (required) | Start time of Incident Update. |
| incidentID (required) |
|
| statusExtended (required) |
|
| severity (required) |
Service status (Splunk -> StatusHub):
|
Other Splunk fields are currently ignored by StatusHub.
In addition to Splunk fields, there are additional fields that can be used to enrich data sent to StatusHub:
| Field name | StatusHub meaning |
| draft | Should the Incident update be in draft mode. |
| silent |
Should the Incident update be a silent update. Silent updates do not trigger notifications to subscribers. |
- In ‘Synthetic tests’, create your detector by clicking 3 dots to the right of your Synthetic test and click ‘Create Detector’.
- In the next step, fill the Alert Details section, and choose the appropriate severity. You can customize your notification message in the notification link. Add a webhook by clicking ‘Add recipient’ and choosing your custom webhook.
Once it’s ready, accept by clicking ‘Activate’.
