Why Ingest Jira Data?
Engineering Context
Past issues contain decisions, workarounds, and solutions that help answer new questions
JQL-Powered Selection
Use Jira Query Language to import exactly the issues you need
Attachments Included
Images, logs, and text files attached to issues are indexed too
Auto-Sync
Backfill jobs automatically import new resolved issues on a schedule
What Gets Indexed
| Content Type | What’s Included |
|---|---|
| Issues | Issue title, description, and all fields |
| Comments | Full comment threads with context |
| Attachments | Images, logs, and text files |
| Metadata | Status, priority, labels, and resolution |
Self-Hosted (Enterprise): This integration is in beta for selected users.
Cloud: Available to all users.
Setup
Create Atlassian API Token
- Go to Atlassian API Token settings
- Click Create API token
- Copy the token
Navigate to Jira Integration
Go to Gurubase Dashboard → Select your Guru → Integrations → Ingestions → Jira
Adding Jira Content
After connecting, you can import issues in two ways:
Option 1: Add Individual Issues
Best for importing specific issues by URL.
| Setting | Description |
|---|---|
| URLs | Enter issue URLs, one per line |
| Date Range | Optionally filter by creation date |
| JQL Filter | Additional JQL criteria (e.g., status = "Done") |
Option 2: Create Backfill Job
Best for bulk imports and automatic ongoing sync using JQL queries.
| Setting | Description |
|---|---|
| JQL Query | Query to select which issues to import |
| Sync Interval | How often to check for new issues (minimum 1 hour) |
| Sync Now | Manually trigger an immediate sync |
Example JQL Queries
Viewing Indexed Content
Imported issues appear as individual sources in your Guru’s data sources list. You can:- View the exact content that was indexed
- Remove specific issues
- Check when content was last synced
