Custom
About the integration
Some teams track incidents using tools Sleuth doesn't have an out-of-the-box integration with yet or even outside of traditional Observability tools. Custom Incident Impact Sources allow you to submit values collected by these tools to Sleuth and get your Failure Rate and MTTR values.
Setting up the integration
A Custom Incident Impact Source is always available within your Sleuth project(s). No additional configuration is needed. See 'Configuring the integration' below for details on how to use a Custom Incident Impact Source.
Configuring the integration
Navigate to the Project you want to add the Impact Source to.
Click Add in the top navigation bar and select Impact source from the list.
Select Incident management (recommended) from the
How do you track change failure
drop-down located towards the top of the page.Choose Custom Incident - user provided from the selection of tiles/providers.
On the Configure impact source page, enter a name for your Impact Source (we recommend choosing a name that's descriptive, such as "Production incidents"), select the environment you want the collected incident data to apply for from the dropdown, and click Save.

Once the Impact Source is created, a window will pop up, providing instructions on how to use the Impact Source to register incident events.
You can also always come back to this page by navigating to the Impact Source, clicking the gearwheel in the top right, and selecting Show register details.
That's it! Sleuth will now start monitoring incidents from your custom source. Head over to the Dashboard to start seeing your data in action in the project and deploy health graphs.
Using the integration
The webhook sent to Sleuth must contain the mandatory type
parameter, the value can be:
triggered
resolved
reopened
There are also several optional parameters, such as:
id
: The unique incident identifier in your systemdate
: The ISO 8601 date the event occurred, defaults to the current timetitle
: The human readable title of the incidenturl
: URL to incident in your external system
Removing the integration
To remove the custom incident source
Click on your Project Settings --> Impact
Find the Impact Source you'd like to remove, click the pencil icon to display options, and then click Delete.
Last updated
Was this helpful?