Help Center
Help Center
  • Getting Started
    • What is Haystack?
    • Quick Start
      • Account Setup
      • Roles
        • For Executives
        • For Managers
        • For Product
  • Setup
    • Integrations
      • Jira
      • GitHub Cloud
      • GitHub Enterprise
      • GitLab
      • Bitbucket
      • Slack
    • Organization
      • Investments
      • Deployments
      • Invite users
      • Exclusions
    • Teams
      • Map members
      • Sprint success metric
      • Capacity
      • Alerts
      • SLAs
      • Risks
  • Features
    • Issues
    • Pull Requests
    • Epics
    • Retrospective
    • Release Notes
    • Investments
    • Alerts
    • Customizable Widgets
    • Flexible Reports
    • Team Metrics
    • List of All Metrics
    • API Tokens
  • Admin
    • Security & Privacy
    • Data Sync
      • How to setup faster data sync for JIRA?
  • FAQ
    • Can I track Dora metrics?
    • What is Status Category?
  • Guides
    • First Principles of Engineering Metrics
    • Engineering Metrics (Video Series)
    • How to Improve Quality?
  • Other
    • Changelog
Powered by GitBook
On this page
  • Basics
  • Configure
  • Permissions
  • FAQ

Was this helpful?

  1. Setup
  2. Integrations

Jira

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

Last updated 4 months ago

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

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

  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.

Page cover image
Jira Base URL