Skip to main content

Jira Connections

The Jira Connections page lets you control which Jira boards are included in Development Insights data collection. Each Jira connection you have configured in Venue.sh appears here, and you can add boards to start pulling issue and sprint data into your Jira dashboard.

Prerequisites

The Jira plugin must be enabled before Jira connections appear on this page.

Viewing Jira Connections​

  1. Click Development Insights in the sidebar.
  2. Click the overflow menu (⋯) at the end of the Jira dashboard row in the list, then select Manage Connections. Or open the Jira dashboard and click Manage Jira boards.

Each Jira connection is displayed as an expandable card, which shows:

  • Connection URL - The Jira instance the connection points to.
  • Sync status - The state of the connection: Synced, Pending while any board waits or collects, or Error when any board failed.
  • Board count - How many Jira boards are currently configured for data collection.
note

The connections pages require permission to create, read, update, and delete Development Insights data.

Adding a Jira Board​

Adding a board tells Venue.sh to start collecting issue and sprint data from that Jira board.

  1. Expand the connection you want to configure.

  2. Click Add Project Key.

  3. In the dialog, search for and select a board from the dropdown.

    Each entry shows the project key and the board name, such as ABC - ABC board. The list is fetched live from your Jira instance. Boards already added to the connection are excluded.

  4. Click Add Project.

Data collection begins automatically once the board is added. The board appears in the connection's table, and you can follow its collection on the Sync Status page.

Board Table​

Each connection lists its boards with the following columns:

ColumnWhat it shows
Board IDThe Jira board ID.
NameThe board name.
Story Points FieldThe Jira field that holds story points. See below.
ActionsA retry icon to start a new collection run for a board whose collection failed.

Venue.sh detects the story points field when you add a board. If it shows Not detected or the wrong field, enter the field ID (for example customfield_10016) and click the check icon to save it. The next collection uses the new field.

tip

If a board's collection fails, click the retry icon in the Actions column to start a new collection run. The retry has no time limit. To refresh a board that collected successfully, use Refresh now on the Sync Status page.

Troubleshooting​

SituationWhat to do
No connections appearEnable the Jira plugin in the Plugins section, and ensure your Jira credentials are valid.
A board doesn't appear in searchThe board may not be accessible with the configured Jira credentials. Check permissions in your Jira account.
Collection keeps failingClick the retry icon. If it continues to fail, ensure the Jira plugin credentials are still valid in Settings.
Jira dashboard shows no dataMake sure at least one board has been added and its collection is Completed on the Sync Status page.
Story points are missingCheck the Story Points Field value for the board and enter the correct field ID.

See Also​

  • Dashboards - Filter and explore your Development Insights panels.
  • Sync Status - Track, retry, and refresh data collection per repository, board, or job.
  • Jenkins Connections - Add Jenkins jobs for CI/CD data.
  • Jira plugin - Enable and configure the Jira integration.