Configure the webhook in Jenkins
Configure webhook endpoints so that Jenkins can use the endpoint to communicate with Incident Response.
Before you begin
Role required: Responder, Manager, or Administrator
You must use the latest Lightstep Incident Response plugin for Jenkins. The latest version of the plugin can be found here.
About this task
- Log in to your Jenkins application console.
- Navigate to .
From the Plugin Manager, search for and install the Lightstep
Incident Response plugin.
Note: You must use the latest Lightstep Incident Response plugin for Jenkins. The latest version of the plugin can be found here.
- From the Dashboard, click New Item.
- Enter a name for your project in the Enter an item name field.
Select Freestyle project and click
Note: The Lightstep Incident Response plugin currently supports only Freestyle projects.
- Enter your project details.
- Under Post-build Actions, select the Add post-build action list.
Select Send alerts to Lightstep Incident Response.
- In the Webhook URL field, enter the webhook URL copied from Incident Response.
Under Select when to trigger alert, select the check
boxes for the build statues for which you want alerts triggered in Incident Response and their respective alert priorities.
Option Description When Build status is failure If selected, you will receive alerts in Incident Response when your Jenkins builds fail. Alert priority in Incident Response will be the priority selected for the option. When Build status is unstable If selected, you will receive alerts in Incident Response when your Jenkins build status is unstable. Alert priority in Incident Response will be the priority selected for the option. When Build status is aborted If selected, you will receive alerts in Incident Response when your Jenkins build is aborted. Alert priority in Incident Response will be the priority selected for the option. Resolve on Back-to-Normal If this option is selected, when your Jenkins build issues are resolved and the build completes successfully, alerts created in Incident Response are closed automatically.
If this option is not selected, you will have to manually resolve the alert in Incident Response.
- Click Save.
If you want the Jenkins build URL to be available in your alerts
in Incident Response, perform the following configuration:
- Navigate to .
- Under Jenkins Location, in the Jenkins
URL field, add the Jenkins Instance
Your alerts will have the direct link to the Jenkins build.
- Post-build results in Jenkins will trigger alerts in Incident Response.
- A single alert is created with the status of Open with respect to a Jenkins job. For this job, the alert will keep getting updated with the next build results. Once the alert is closed in Incident Response, a new alert will be created for the same Jenkins job.
- If the Resolve on Back-to-Normal option is selected, when the build is resolved in Jenkins, the alert status is changed to Closed in Incident Response.