How to Integrate Jira with Pingzo for Uptime Alerts

For modern engineering teams, tracking outages is only half the battle. Once an incident is detected, it must be logged, categorized, and assigned to the correct on-call engineers. Manually raising tickets during active outages wastes critical minutes and increases Mean Time to Repair (MTTR). By integrating Pingzo with Atlassian Jira, you can automate this entire workflow.

This guide details how to configure Pingzo to automatically generate Jira issues, populate ticket parameters, and close tickets once services recover.

Why Connect Pingzo to Jira?

• Automated Ticket Workflows: Eliminate manual ticket creation. Pingzo automatically opens a new Jira bug or task the moment a checker flags an outage.
• Contextual Diagnostic Data: Pingzo populates the Jira issue description with critical debugging data: including response status codes, latency measurements, and region consensus reports.
• Automatic Issue Resolution: When the checked service returns to a healthy state, Pingzo can automatically transition the linked Jira ticket to "Done" or "Resolved."
• Custom Priority Mapping: Map minor latency warnings to low-priority tasks while routing complete API service outages to high-priority blockers.

Prerequisites for Integration

Before starting the setup process, ensure you have:

1. A Jira Cloud or Jira Server account with project administration access.
2. Your Jira API Token (or project webhook URL).
3. An active Pingzo account with configurator privileges.

Step-by-Step Setup Guide

Follow these steps to connect your monitoring checks to your active Jira project board:

Step 1: Generate an API Token in Jira

To allow Pingzo to authenticate with your Jira instance securely:

1. Log in to your Atlassian account page (id.atlassian.com).
2. Navigate to Security -> API Tokens.
3. Click Create API Token, assign it a name (e.g., "Pingzo Uptime Link"), and copy the generated token string to your clipboard.

Step 2: Configure Jira Alert Channel on Pingzo

1. Log in to your Pingzo Dashboard and go to the Alert Channels page.
2. Click Add Channel and select Jira from the integration dropdown.
3. Enter your Jira instance domain URL (e.g., company.atlassian.net).
4. Enter the email address associated with your Atlassian account and paste the API Token generated in Step 1.
5. Input the target Jira Project Key (e.g., DEV or OPS) and specify the preferred Issue Type (such as Bug or Task).
6. Click Save Channel.

Step 3: Map Alert Profiles to Monitors

1. Go to the Monitors tab in Pingzo and select the service checker you want to link.
2. Open Alert Profiles and select your newly configured Jira channel.
3. Define the trigger conditions (for example, create a ticket only if the checker stays down for more than 2 consecutive runs).
4. Click Update Monitor to save the changes.

Test and Verify the Integration

To ensure the ticket routing is fully operational:

1. Click the Test button next to your Jira channel on the Alert Channels page.
2. Log in to your Jira project board and verify that a test ticket named [Pingzo Test Alert] has been created.
3. Check the ticket body to confirm it contains sample latency and check destination variables.
4. Optionally, run a mock server drop on a testing endpoint to confirm a live ticket is logged.