Enhanced Search Syncing
JQL keyword sync
A JQL Keyword sync is required only once after installing Enhanced Search. As this sync needs to update every issue in your instance, it can take a significant amount of time if your instance contains a large number of issues.
The metadata saved to your issues allows for faster recall when searching because many searches will find the metadata instead of calculating it on the fly each time you search. You may search directly for these keywords, or you may search using Enhanced Search JQL functions that use this metadata. Many Enhanced Search functions will use the metadata saved to your issues to run searches.
Currently, instances that contain more than 500,000 issues may take a significant amount of time to sync. In some cases, this can take several weeks. If your instance falls into this category, we strongly advise you to create a Support ticket so we can keep track of the initial sync with you.
JQL functions not dependent on keyword synchronisation
There are some JQL functions that will return accurate results even when the keyword sync is still in progress or has yet to be completed. Listed below are the JQL functions that are not dependent on the JQL keyword sync:
- linkedIssuesOf
- linkedIssuesOfRecursive
- linkedIssuesOfRecursiveLimited
- subTasksOf
- childrenOf
- parentsOf
- epicsOf
- issuesInEpics
- versionMatch
- projectMatch
- componentMatch
- issueFieldMatch
- issueFieldExactMatch
- dateCompare
- inSprint
- nextSprint
- previousSprint
Issue sync
When issues are updated (added or edited in some way) in Jira, the data stored in Enhanced Search needs to be updated so that your searches use the most up-to-date information on your issues. The issue sync includes updating metadata and occurs when we receive an event notification that something changed on your instance.
Filter sync
The results of a filter need to be accurate, so it is necessary to ensure that the Jira filter (results of ES search) has the latest information from the original Enhanced Search filter. The filter sync occurs once every 5 minutes, fetching all users who own ES filters and sending a message to our filter sync system to automatically synchronize their filters. You can refer to our filter syncing tips and FAQs in Troubleshoot Enhanced Search for Jira Cloud.