Zabbix 7.2 and jira service management

[Steven Koolen]

We just build a zabbix 7.2 server and want to have an alert in zabbix to be created in jira service management as an incident and to link an asset (hostname) to the incident. 

Next an alert needs to be created which should then be used to inform an on call employee to acknowledge (by phone or app).

But have some problems with finding good resources. For example, wherw to find the issue type that needs to configure in zabbix or the project key. 

Does anyone have a tutorial to set this up (and where to find the relevant information). What rights does the user need to have?

[Andrés Enrique Cárdenas]

Have you tried with the plugin developed by Atlassian? https://support.atlassian.com/jira-service-management-cloud/docs/integrate-with-zabbix/ 

The release can be downloaded from here: https://github.com/atlassian/jsm-integration-scripts/releases/tag/zabbix-1.0.3_jec-1.0.5 

I got it working, and it creates alerts successfully. (I had it setup before with OpsGenie but as OpsGenie is no longer supported I had to set it up again with the newer version).

I had issues when acknowledging the alerts to be reflected in zabbix though, and I found out it's because of the way it authenticates with Zabbix API. I posted a fix here: https://github.com/atlassian/jsm-integration-scripts/issues/76

Besides this, after setting it up the integration works flawlessly, I set the action to wait a while before running the script to avoid having false positives into JSM. I too want to link the alert to an asset, but haven't had the time to work into it, although it mustn't be really hard to do, we already have a field set up for this in change management tickets so really with a simple automation it should work just fine.

And with the new Alerts in JSM is really easy to set up the on call settings. I'm not an expert and have learned this by trial and error but feel free to ask, maybe I can be of assistance. 

If it's of any help, I'm currently running zabbix 7.2.4 

[Arne Grosse-Butenuth]

Hello everyone,

I am currently trying to set up the Zabbix integration for Jira Service Management using the Operations/Alerts feature (not via standard Jira issues/tickets). I am using the JSM Zabbix plugin with the Jira Edge Connector (JEC), version 1.0.5, according to the official documentation:

https://support.atlassian.com/jira-service-management-cloud/docs/integrate-with-zabbix/ 

Setup:

Integration created in JSM under Operations > Integrations > Zabbix

jec.service is running on the Zabbix server (Debian) as a systemd service

jec-config.json populated with apiKey and baseUrl (https://<your-tenant>.atlassian.net )

When starting the jec.service, I immediately get the following error:

Plaintext
ERROR: Queue processor could not get initial token and will terminate.
FATAL: Token could not be received from Jira Service Management, status: 404 Not Found
The response body actually returns Jira's standard 404 error page ("Oops! You've found a dead link") — so JEC apparently doesn't hit a valid API endpoint at all, landing on a regular Jira webpage instead of a REST response.

My questions to you:

Has anyone here successfully gotten the Zabbix integration working with alerts (operations) rather than standard tickets/issues?

Is there a special baseUrl or a different endpoint for alerts that needs to be entered in jec-config.json (the documentation mentions EU/sandbox domains, for example, but nothing specific to alerts)?

Does anyone recognize this 404 error during the initial token request and know what typically causes it?

I would be very grateful for any hints or shared experiences!

Thanks in advance!

[Eugenio Onofre]

Hi @Steven Koolen

Getting Zabbix to trigger incidents in Jira Service Management and link to an asset is definitely doable, but I agree, the official documentation can be a bit scattered.

Here’s a rough outline that I would follow to try to achieve your goal:

1. Create the Jira API Integration in Zabbix

In Zabbix 7.2, you can use Media Types or Webhooks to integrate with Jira. Zabbix has a built-in Jira webhook script (in alertscripts/) which you can tweak.

You’ll need:

• Jira Base URL

• A project key → You can find this by going to your project in Jira and checking the URL (e.g., JSD in yourcompany.atlassian.net/jira/software/projects/JSD)

• The issue type ID → This isn’t always the name ("Incident", "Task", etc.). To get the numeric ID, you can hit the Jira REST API: GET /rest/api/3/issuetype

2. User Permissions

The user (API token or basic auth) needs at minimum:

• Create issues permission on the target project

• Access to Assets/CMDB (to link the hostname as an object)

• Browse Projects + any custom field permissions if you're mapping fields

3. Linking Assets (hostnames)

If you’re using Jira Assets (formerly Insight), and the asset is stored there:

• Use a custom field in Jira of type "Assets object"

• In your Zabbix alert payload, pass the hostname

• You may need to use a custom field ID and map it via the webhook

4. Notifying On-Call

After the incident is created in Jira, configure an automation rule in JSM that triggers an alert in Opsgenie based on issue conditions (like priority or component)

Hope this helps.

Regards,
Eugenio

[Steven Koolen]

Hi Eugenio,
Thank you for your reply. Regarding the issue type ID. I want to use the Report a problem incident, the url I see is: jira/servicedesk/projects/IS/settings/request-types/category/incidents/request-type/24/request-form
Is 24 the issue type id then?

Where can I set up the User Permission? I created an user and made him an agent in ITSM.  And created the api key as well. 

Linking assets might be for later, i first want it to work :)

[Steven Koolen]

Hi @Eugenio Onofre 
I found the issue type using the api. Tried it with the project key (IS) and the project ID. 

For the connection I am using my account now, as I am an admin I have rights for all, created an api key as well. 

But doesnt seem to work yet unfortunately. 

[Steven Koolen]

I got a little bit further. I needed to set up actions as well in zabbix. So i setup an action and it tries to send it, but got the error:
Sending failed: Failed to parse response: not well-formed JSON was received
Need to look further in the settings to see what is going wrong.