Jira Connections

The Jira Connections page lets you control which Jira projects are included in Development Insights data collection. Each Jira connection you have configured in Venue.sh appears here, and you can add project keys 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 (⋯) next to a Jira dashboard in the list, then select Manage Connections, or navigate directly to Development Insights > Jira Connections.

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

• Connection URL - The Jira instance the connection points to.
• Sync status - The current state of the connection (e.g., Synced, Syncing, Failed).
• Project count - How many Jira projects are currently configured for data collection.

Adding a Jira Project

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

1. Expand the connection you want to configure.

2. Click Add Project Key.

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

   The list is fetched live from your Jira instance. Projects already added to the connection are excluded.

4. Click Add Project.

Data collection begins automatically once the project is added. The project appears in the connection's project table with a collection status that updates as data is synced.

Collection Status

Each project in a connection shows a collection status:

Status	Meaning
Synced	Data has been successfully collected.
Syncing	Data collection is in progress.
Failed	An error occurred during data collection.
Pending	The project has been added but collection has not started.

tip

If a project shows a Failed status, a retry button (↻) appears in the Actions column. Click it to trigger a new collection run.

Troubleshooting

Situation	What to do
No connections appear	Enable the Jira plugin in the Plugins section, and ensure your Jira credentials are valid.
A project doesn't appear in search	The project may not be accessible with the configured Jira credentials. Check permissions in your Jira account.
Collection keeps failing	Click the retry (↻) button. If it continues to fail, ensure the Jira plugin credentials are still valid in Settings.
Jira dashboard shows no data	Make sure at least one project has been added and its collection status is Synced.