Jira Integration
The Jira integration enables bidirectional synchronization between AtlasAI incidents and Jira issues. Create Jira tickets from AtlasAI incidents, or import Jira issues into AtlasAI for AI-powered analysis and correlation.
Prerequisites
- Jira Cloud or Jira Data Center (8.0+)
- A Jira user account with project admin permissions
- For Jira Cloud: an API token from id.atlassian.com
Setup
Step 1: Generate Jira credentials.
For Jira Cloud, create an API token at id.atlassian.com/manage-profile/security/api-tokens .
For Jira Data Center, create a Personal Access Token under your user profile.
Step 2: Configure the integration in AtlasAI.
- Navigate to Settings → Integrations → Jira
- Click Add Connection
- Enter your Jira instance details:
- Instance URL:
https://your-org.atlassian.net(Cloud) or your Data Center URL - Email: Your Jira account email (Cloud only)
- API Token / PAT: Your authentication token
- Instance URL:
- Select the default Jira project for new issues
- Configure sync options:
- Auto-create Jira issues: Create a Jira issue for every AtlasAI incident (filterable by severity)
- Import Jira issues: Import issues from selected projects into AtlasAI
- Bidirectional sync: Keep status and comments in sync between both platforms
- Click Test Connection and then Save & Enable
Step 3: Configure field mapping.
Navigate to Settings → Integrations → Jira → Field Mapping:
| AtlasAI Field | Jira Field |
|---|---|
| Title | Summary |
| Description | Description |
| Severity | Priority |
| Status | Status |
| Assigned To | Assignee |
| Service | Component |
| RCA Summary | Custom field (configurable) |
Features
Auto-Create from Incidents
When enabled, AtlasAI automatically creates a Jira issue when an incident is created. You can filter by:
- Minimum severity (e.g., only P1 and P2)
- Service filter (e.g., only production services)
- Category filter (e.g., only “Performance” incidents)
Bidirectional Status Sync
Status changes in either system are reflected in the other:
- AtlasAI “Investigating” → Jira “In Progress”
- Jira “Done” → AtlasAI “Resolved”
- Custom status mappings are configurable
RCA Attachment
When an RCA completes, AtlasAI adds the RCA summary as a Jira comment with a link back to the full analysis.
Troubleshooting
| Issue | Solution |
|---|---|
| Authentication failed | Verify email and API token; ensure the token hasn’t expired |
| Project not found | Check the project key matches exactly |
| Field mapping errors | Ensure mapped custom fields exist in the target project |
| Sync delays | Jira webhook delivery can lag — check Jira’s webhook logs |