Jira is a proprietary issue tracking product developed by Atlassian which allows bug tracking and agile project management.

Available solutions

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira

Jira webhook

This guide describes how to integrate Zabbix 5.0 installation with Jira using the Zabbix webhook feature. This guide provides instructions on setting up a media type, a user and an action in Zabbix.
Please note that recovery and update operations and Jira's custom fields are supported only for trigger-based events.

Setting up webhook in Zabbix

1. Before setting up a Jira Webhook, it is recommended to setup the global macro "{$ZABBIX.URL}" containing an URL to the Zabbix frontend.
As an example, this macro can be used to populate Jira's custom field with URL to an event info or graph.

2. In the Administration > Media types section, import the media_jira.xml (or media_jira_with_CF_example.xml if you are planning to use custom fields in Jira).

3. Open the newly added Jira media type and replace all <PLACEHOLDERS> with your values.
The following parameters are required:
jira_url - actual URL of your Jira instance,
jira_user - Jira user login,
jira_password - password or API token (for Jira Cloud installations an API token can be obtained at https://id.atlassian.com/manage/api-tokens),
jira_project_key - text key of the Jira project (not to be mistaken with an ID!),
jira_issue_type - name of the issue type to be used when creating new issues from Zabbix notifications.

  • By default the webhook does not use Jira custom fields and {ALERT.MESSAGE} is used as an issue description.

  • To export information into your Jira custom field, add a parameter with custom field ID as key (if you need help finding custom field ID, see this page in Jira documentation). If at least one parameter starting with "customfield_" is configured for the media type, the webhook will use {TRIGGER.DESCRIPTION} as an issue description instead of {ALERT.MESSAGE}.

    You can configure custom fields manually or import media_jira_with_CF_example.xml and change parameters from the template as needed.
    Note, that Jira webhook supports string, url, number, and datetime fields for now. Types of fields used in media_jira_with_CF_example.xml are defined at the beginning of parameter placeholders.
    Date and time must be in ISO 8601 format with timezone of the Zabbix server (2020-01-01T23:59:59+0200). If server time is set to UTC, there is no need to add timezone at the end of parameter value.

4. Create a Zabbix user and add Media with the Jira media type. Though a "Send to" field is not used in Jira webhook, it cannot be empty. To comply with frontend requirements, you can put any symbol there. Make sure this user has access to all hosts for which you would like problem notifications to be converted into Jira tasks.

For more information see Zabbix and Jira documentations.

Supported Versions

Zabbix 5.0

Articles and documentation

+ Propose new article
Add your solution