Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Fixing reindex issues using Indexing Queue Viewer

Use the Indexing Queue Viewer to check and look for reindex related issues.

What’s on this page:

How to see when some indexing tasks has stuck?
How to make sure only the dedicated node is reindexing?
How to see the progress of an integration index?
Why my repository hasn’t been removed yet?
How to find a nested repository in ERROR state?

How to see when some indexing tasks has stuck?

Sometimes the indexing process takes longer for some tasks. To see which tasks are in this state, start from the Manage integrations page and check the integration with the SCANNING or INDEXING status.

Go to Actions ➜ Show integration repositories. You may see some QUEUED or FETCHING status in the list and is somewhat taking a bit longer to process.
Open Jira System administration then click Logging and profiling on the left sidebar.
Under the Default loggers section, click Configure….
Set the Package name to com.bigbrassband.jira.git.services.indexer.
Set Logging Level to DEBUG.
Setting the Logging to DEBUG level for the above package name will intruct Jira to do verbose logging on the plugin. Make sure to turn this setting off once it is confirmed that indexing is working on the said tasks. For example, the reindex is in progress if you see logs constantly adding to your atlassian-jira.log below:
Branch: {} Last index revision: {} Adding document for repository = {}; branch = {}; revision = {}.

style=’margin-bottom:0px’>
Click Add to proceed.

Take a look at Atlassian logs in dynamic. The better way is to use “Last Log for Jira” plugin (Last Log for Jira | Atlassian Marketplace). If the Git Integration for Jira app is doing something, then your logs are being flooded by a lot of messages like:

”2023-02-17 16:58:26,436+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 INFO      [c.b.j.g.s.indexer.revisions.RevisionsIndexManagerImpl] Latest indexed revision is: null
2023-02-17 16:58:26,436+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 INFO      [c.b.j.g.s.indexer.revisions.RevisionsIndexManagerImpl] Updating to: dac6a2304402a62f6410e666fa1510d129b1af93
2023-02-17 16:58:26,443+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.RevisionsIndexManagerImpl] Adding document for repository = 4; branch = master; revision = commit dac6a2304402a62f6410e666fa1510d129b1af93 1627632962 -----sp
2023-02-17 16:58:26,443+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Processing commit dac6a2304402a62f6410e666fa1510d129b1af93, branch master, repo: TestGitPluginRepo
2023-02-17 16:58:26,443+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Init Date: 2023-02-17 16:58:22
2023-02-17 16:58:26,444+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Processing commit 3478d5dc85e5e45ddeac49ac11744b79a5fd035f, branch master, repo: TestGitPluginRepo
2023-02-17 16:58:26,444+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Init Date: 2023-02-17 16:58:22
2023-02-17 16:58:26,445+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Processing commit 8f6591d81b3c2d2d6e3ca5e077c897f2f7d33b98, branch master, repo: TestGitPluginRepo
2023-02-17 16:58:26,445+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.CommitIssueCollector] Init Date: 2023-02-17 16:58:22
2023-02-17 16:58:26,446+0600 bigbrassband-gitplugin-RevisionIndexerImpl:thread - 1 DEBUG      [c.b.j.g.s.indexer.revisions.RevisionsIndexManagerImpl] Adding document for repository = 4; branch = master; revision = commit cfc0cedf48b59980169daa8eccf0f6bc340447cc 1544338819 -----sp”

Remember to turn off DEBUG logging after obtaining the information that you need.

How to make sure only the dedicated node is reindexing?

Switch to the Indexing Queue Viewer.
Filter the tasks using Status: Indexing to see only the integration being indexed in the current node.
Use the Indexing queue Refresh icon (bottom-left of the list) to reload the list while tasks in the queue is still being processed.
Filter by different nodes to ensure that only the specific dedicated node(s) is indexing repositories. Dedicated node(s) can be setup via General settings ➜ Indexing: Allow all nodes to perform the repository indexing option.

How to see the progress of an integration index?

When an integration has pending indexing tasks, it becomes inconvenient to monitor its progress in the Manage integrations page using Actions ➜ Show integration repositories.

If you have an integration in INDEXING progress, then we recommend to use Indexing Queue Viewer instead:

Switch to the Indexing Queue Viewer page then click the Refresh icon at the bottom-left portion of the task list.
Use the Status: Indexing filter to see only the integration being indexed in the current node.
Click to view the details for the indexing task that has the INDEXING status then copy the Parent ID value. The Parent ID for processed tasks are displayed on the filtered list. Since your integration is in INDEXING progress then the parent ID is the id you are interested in.
Use this value into the Search bar on the filters panel then press Enter to do a filter search. The index queue will show results based on the set filters and search criteria.
Click the Refresh icon to reload the task list during the indexing process.

Here are some suggestions for Status filter and search combination to control the displayed results:

Set Status to Queued and enter the value of the Parent ID into the Search bar to see the rest of the indexing tasks to be processed relating to the reindex of the integration.
Set Status to Indexing and enter the value of the Parent ID into the Search bar to see reindex tasks in progress relating to the reindex of the integration.
Set Status to All and enter the value of the Parent ID into the Search bar to see the full scope of tasks relating to the reindex of the integration.

Why my repository hasn’t been removed yet?

You have removed a repository or integration and can still see it among repositories on Manage integrations page in DISABLED status for long time. This issue happens because the deletion task in still queued for processing. For instance, this could happen if General Settings ➜ Scheduled jobs ➜ Repository reindexing interval is lower than Indexing Queue Viewer ➜ Last run duration for scheduled indexing.

To resolve this issue:

Go to the Indexing Queue Viewer.
You should see a queue task with Remove repository state in the last page. This is because deletion tasks have one of the lowest priorities in the indexing queue.
Move this item to the top of the list via … Actions ➜ Move to top.

a. Do a couple of indexing list page refreshes (using the Refresh icon) and see if the integration of repository is successfully removed.

b. In addition, the proper way is to set the value of Repository reindexing interval to greater than the Last run duration of the task in question for scheduled indexing. Otherwise, this issue may appear again.

How to find a nested repository in ERROR state?

If you’re suspecting a indexing issue from a certain repository in an integration:

Switch to Indexing Queue Viewer and set the filter to Status: Error. This will narrow down the list for queued index items with the ERROR status.
View the logs of the error via ⋯ Actions ➜ View log. You may send the logs with errors or issues to us at GIJ Support for analysis.

Fixing reindex issues using Indexing Queue Viewer

How to see when some indexing tasks has stuck?

How to make sure only the dedicated node is reindexing?

How to see the progress of an integration index?

Why my repository hasn’t been removed yet?

How to find a nested repository in ERROR state?

More articles about troubleshooting, workarounds and solutions

On this page