Your first stop for learning how to get started with Jira Service Management.
What does the integration offer?
sends event information via output plugins. With 's Integration, acts as a dispatcher for these events, determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iPhone & Android push notifications, and escalates alerts until the alert is acknowledged or closed.
How does the integration work?
According to the Logstash events:
Alert is created in .
Designated alert is acknowledged.
Note is added to designated alert.
Designated alert is closed.
Set up the integration
is an API-based integration. Setting it up involves the following steps:
Add a integration in
Configure the integration in
Add a Logstash integration
To add a integration in , complete the following steps:
Go to your team’s operations page.
On the left navigation panel, select Integrations and then Add integration.
Run a search and select “”.
On the next screen, enter a name for the integration.
Optional: Select a team in Assignee team if you want a specific team to receive alerts from the integration.
The integration is saved at this point.
Expand the Steps to configure the integration section and copy the API key.
You will use this key while configuring the integration in later.
Select Turn on integration.
The rules you create for the integration will work only if you turn on the integration.
Configure the integration in Logstash
To configure the integration of with , complete the following steps:
Install the Jira Service Management plugin for Logstash. Find out how to install the plugin.
5.4+: bin/logstash-plugin install logstash-output-jsm
Other Versions: bin/plugin install logstash-output-jsm
Add the following configuration to the configuration file:
Paste the API key copied previously into apiKey.
The Output plugin expects that events contain a field called "jsmAction". Also, expects the data in a certain structure, so some additional fields are added to the event. To add fields, use a filter plugin like Mutate, Grok etc. Read more about the fields added to events and what they mean.
Following is an example of a Mutate filter enhanced with Ruby filter plugin configuration:
4. Run Logstash.