Redmine

Redmine

Redmine is a free and open source, web-based project management and issue tracking tool. It allows users to manage multiple projects and associated subprojects. It features per project wikis and forums, time tracking, and flexible, role-based access control.

Available solutions




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


Redmine webhook

This guide describes how to integrate your Zabbix 5.0 installation with Redmine using the Zabbix webhook feature. This guide will provide instructions on setting up a media type, a user and an action in Zabbix.

Requirements

  • Redmine with enabled REST API and Authentication
  • Zabbix version 5.0 or higher

Setting up a Redmine

1. Enable REST API in Administration > Settings > API.

2. Find your API key on your account page when logged in, on the right-hand pane of the default layout.

Zabbix Webhook configuration

Create a global macro

1. Before setting up the Webhook, you need to setup the global macro {$ZABBIX.URL}, which must contain the URL to the Zabbix frontend.

2. In the Administration > Media types section, import the media_redmine.xml

3. Open the added Redmine media type and set:

  • redmine_access_key to the your API key
  • redmine_url to the frontend URL of your Redmine installation
  • redmine_project to your Project ID or its name. Important: if you specify a project name, each time an additional API call will be made to get its identifier.
  • redmine_tracker_id to your Tracker ID

4. If you have custom fields in Redmine and you want them to be filled in with values from Zabbix, add parameters in the form customfield_\<Redmine custom field ID>. Custom fields can only be of the text, integer, float or date types. Custom fields of date type must be in the format "YYYY-MM-DD".

5. If you want to prioritize issues according to severity values in Zabbix, you can define mapping parameters:

  • severity_\<name>: Redmine priority ID

6. Click the Update button to save the Webhook settings.

7. To receive notifications in Redmine, you need to create a Zabbix user and add Media with the Redmine type.

For Send to: enter any text, as this value is not used, but is required.

For more information, use the Zabbix and Redmine documentations.

Supported Versions

Zabbix 5.0

Articles and documentation

+ Propose new article
Add your solution