Documentation
Integration Guide

Jira Galaxy Sync

Automatically mirror your Jira projects into Forese.ai's Knowledge Graph, enabling AI-powered semantic search across your Jira issues.

How Galaxy Sync Works

Issues to Entities

Jira issues are converted to Galaxy entities

Vector Embeddings

Embeddings generated for semantic search

Relationship Sync

Issue relationships become Galaxy edges

Auto Sync

Changes synced automatically based on interval

Enabling Galaxy Sync

1

Navigate to Jira Settings

Go to Settings > Integrations > Jira and ensure your Jira account is connected.

2

Set Sync Mode

Set Sync Mode to either Galaxy Sync (only auto sync) or Both (Galaxy sync + manual canvas import).

3

Enable Auto-Sync

Enable the Auto-Sync toggle and set your preferred Sync Interval.

4

Save Configuration

Click Save Configuration to start syncing.

Sync Intervals

15 minutes

Active projects with frequent updates

1 hour

Standard projects (Recommended)

4 hours

Stable projects with occasional changes

24 hours

Archive/reference projects

Filter Options

Project Filter

Leave empty for all projects, or select specific project keys (e.g., PROJ, DEV, PROD).

Issue Type Filter

Control which issue types sync: Epic, Story, Task, Bug, Sub-task.

Status Filter

Filter by status: To Do, In Progress, Done, Blocked.

Issue to Entity Mapping

Jira FieldGalaxy Entity Field
Keymetadata.jiraKey
Summaryname
Descriptioncontent (used for embeddings)
Issue Typeentity_type
Statusmetadata.status
Assigneemetadata.assignee
Labelsmetadata.labels
Story Pointsmetadata.storyPoints
Createdmetadata.created
Updatedmetadata.updated

Relationship Syncing

Jira issue links become Galaxy edges:

Blocksdepends_on
Relates torelated_to
Duplicatesrelated_to
Parent/Childpart_of
Epic/Storypart_of

Searching Jira Content

Once synced, Jira issues are searchable in Galaxy using natural language queries:

Semantic Search Examples

  • "What are the high priority tasks?"
  • "Show me issues related to authentication"
  • "Find all blocked items in the API project"

Filter by Source

In Galaxy search, select External to see only Jira-synced entities, or search all sources for comprehensive results.

Manual Sync Trigger

To sync immediately without waiting for the interval:

Full Sync

Re-sync all issues from scratch

Incremental

Only sync changes since last sync

Project Sync

Sync a specific project only

Monitoring Sync Status

View past sync jobs in Settings > Integrations > Jira > Sync History:

  • Start time
  • Status (pending, running, completed, failed)
  • Issues processed
  • Errors (if any)

Best Practices

Use project filters

Don't sync unnecessary projects to optimize performance.

Match sync frequency

Set sync interval based on how often your project updates.

Keep descriptions updated

Better Jira descriptions = better semantic search results.

Use consistent labeling

Labels improve search relevance across the Knowledge Graph.

Link related issues

Jira links create meaningful Galaxy edges for context.

Monitor sync history

Check for failed syncs and resolve permission issues.

Troubleshooting

Issues not appearing in Galaxy

  • Check that Galaxy Sync is enabled
  • Verify the sync interval hasn't expired
  • Ensure the Jira project is in your project filter

Sync failed

  • Check connection status in Settings
  • Review sync history for error details
  • Verify Jira permissions haven't changed
  • Try triggering a manual sync

Related Guides

Jira Setup Guide

Initial connection setup and configuration.

Read guide

Canvas Import Guide

Import Jira data to canvas for visualization.

Read guide

Project Galaxy

Learn more about the Knowledge Graph.

Read guide