Jira

Overview

Jira is an incident management tool developed by Atlassian. It helps teams track, prioritize, and resolve incidents from a centralized platform. When you configure Jira as a notification channel in Turbo360, alert incidents are automatically created as work items in your Jira project, ensuring the right people are notified and can act quickly.

Business value

Integrating Jira with Turbo360 keeps your incident response within existing team workflows. Alerts from Turbo360 create traceable work items in Jira, supporting faster resolution, clear ownership, and audit visibility.

Prerequisites

• An active Jira account with a project configured for incident tracking.
• An API token generated from your Atlassian account. See Manage API tokens for your Atlassian account for instructions.

Required permissions

You must have sufficient permissions in Jira to create work items in the target project.

Dependencies

• Turbo360 must have outbound connectivity to your Jira domain.
• A valid Jira project and work item type must exist before completing setup.

How it works

Turbo360 connects to Jira using your domain URL, username, and API token. When an alert condition is met, Turbo360 creates a work item in the configured Jira project under the specified work item type. You can validate the connection during setup to confirm that credentials and project details are correct before saving.

Steps

Use the following steps to configure a Jira notification channel. Navigate to Settings > Notification channels and select Jira to get started.

1. Enter a Friendly name to identify this channel in the Turbo360 application.
2. Enter your Jira domain name, user name, and API token.
3. Click Authenticate to verify the credentials against your Jira domain.
4. After successful authentication, specify the project name and the work item type where alert incidents should be created.
5. Click Validate to send a test alert and confirm the channel is working correctly.
6. Click Save to complete the setup.

Configuration

Permission behavior

With access: Turbo360 can authenticate to Jira, create work items in the specified project, and send test alerts via the Validate action.

Without access: If the API token is invalid or the user lacks permission to create work items in the project, authentication or validation will fail. Turbo360 will not create incidents until valid credentials are provided and saved.

Example scenario

Your operations team uses Jira to track all production incidents. You configure a Jira notification channel in Turbo360 with a dedicated project named OPS-Incidents and work item type Bug. When a monitoring alert fires, Turbo360 automatically creates a new Bug in OPS-Incidents, and the on-call engineer sees it in their Jira queue without needing to check Turbo360 directly.

Limitations

• Turbo360 creates new work items for each alert; it does not update or close existing Jira issues automatically.
• Only one Jira project and work item type can be configured per channel. Create multiple channels if you need to route alerts to different projects.
• API token authentication is required; OAuth or other authentication methods are not supported.

Troubleshooting

1. Authentication fails after clicking Authenticate
   Cause: The domain name, user name, or API token is incorrect.
   Fix: Verify that the domain does not include https://, that the user name is your full Atlassian email address, and that the API token has not expired. Regenerate the token if needed.

2. Validate returns an error after authentication succeeds
   Cause: The specified project name or work item type does not exist in Jira, or the user lacks permission to create items in that project.
   Fix: Confirm the exact project key and work item type in Jira, and ensure the authenticated user has the Create Issues permission for that project.

3. Alerts fire in Turbo360 but no work items appear in Jira
   Cause: The channel configuration was not saved, or the alert rule is not linked to this notification channel.
   Fix: Verify the channel is saved and confirm that the relevant alert or escalation policy references this Jira channel.

4. Connection to Jira domain times out
   Cause: Network or firewall rules are blocking outbound requests from Turbo360 to the Jira domain.
   Fix: Ensure your network configuration allows outbound HTTPS traffic to your Atlassian domain. Contact your network administrator if the issue persists.

FAQs

1. Can I configure multiple Jira channels in Turbo360?
   Yes. You can create multiple Jira notification channels, each pointing to a different project or work item type, and assign them to different alert rules.

2. Where do I find my Jira API token?
   Log in to your Atlassian account at id.atlassian.com, navigate to Security, and select Create and manage API tokens. See the Manage API tokens for your Atlassian account guide for step-by-step instructions.

3. Does Turbo360 close or resolve Jira issues automatically when an alert clears?
   No. Turbo360 only creates Jira work items for alert incidents and does not automatically resolve them.

Related articles

• Manage API tokens for your Atlassian account