Jira

Connect Jira to see all your work in a single place and identify trends, risks, blockers and many more.

Basics

Haystack utilizes Jira data to gather information about your past and active work. Historical data is used to generate metrics and reports, while active work is analyzed to inform you about the current state of your delivery.

Configure

Update integration

Default token would give a sync time of 30 minutes.

To improve the sync time to 10 seconds check Real Time Data Sync doc.

1. Go to Org settings -> Integrations -> Jira.

2. Click on menu icon and choose Update:

   
3. Fill in requested fields:

   1. API token: go to API Tokens page in Jira. Select from existing API tokens or create a new one. Make sure that token you create is not expired.

   2. Email: Use the email associated with your Jira account where the token was generated.

   3. Jira Base URL: You can find the Jira base URL in your browser's address bar

      

      Jira Base URL
4. Click Connect.

5. Wait for the data to sync. This usually takes about 1 hour, but can extend up to 6 hours depending on the organization size.

Permissions

List of data that is stored at Haystack:

Category	Data stored
System	Issue statuses, priority types, column types, etc.
Issues	Title, content, create/update date, assignee, creator, reporter, custom fields (e.g., story points, sprints), etc.
Issue history	Title changes, assignee changes, etc.
Issue comments	Content, author info, etc.
Projects	Project name, type, key, issue types, etc.
Sprints	Start/end dates, title, state, etc.
Boards	Board JQL, title, column metadata, etc.
Members	Name, account ID, email, etc.

FAQ

Why is my Jira Project or Board is missing?

This is likely due to limited access in your JIRA integration. To fix this, update your JIRA Integration token by following the steps below!

• Access Integration Settings

  • Visit: Haystack JIRA Integration Page

  • Click the three dots next to JIRA integration and select "Update" .

    
• Update Integration Token

  • Generate a new token in JIRA with access to the specific board or project

• Update Integration in Haystack

  • Paste the new token in Haystack's JIRA settings.

  
• Verify Access

  • Check if you can now see the board or project.