FAQ
The FAQ chapter lists the most common questions and answers related to Queues for JSM. It helps resolve problems and uncertainties that appear while using the app.
It includes the following questions:
- How often do queues refresh?
- How to improve the Jira performance by reducing the Queues load?
- What is the difference between options: Select all and Apply to all?
- Why, in the Queues for JSM, do I have an avatar different from the one I set for my Atlassian account?
- Why do I see projects in the app that I can’t access?
How often do queues refresh?
It depends on whether you have the browser tab open or hidden. The table below presents the approximate time of refresh.
Rate type | Default rate when tab is visible | Tab is not visible |
---|---|---|
queueCountNotUpdatedRefreshRateMs | 5s | x2 |
queueCountLeastUpdatedRefreshRateMs | 10s | x2 |
openQueueRefreshRateMs | 20s | x2 |
How to improve the Jira performance by reducing the Queues load?
It’s possible to control performance parameters by changing its properties in exported .json file.
Steps
- Export queues to .json file as in the instruction.
- Open exported file.
- Add target property performance:
NoteMake sure that"performance"
is on the same level as"queuesConfig"
.
"performance": {
"queueCountRefreshOn": true,
"queueCountNotUpdatedRefreshRateMs": 5000,
"queueCountLeastUpdatedRefreshRateMs": 10000,
"queueCountCacheExpireTimeoutMs": 300000,
"openQueueRefreshRateMs": 20000
},
- Import updated .json file.
- Refresh the page.
Result
Version of the file has changed. Property performance will be read from a new version.
How it works?
If you meet the problem with Jira performance, you may need to change some of the default parameters which our app uses.
In order to preserve data that otherwise would be lost after you refresh the page, we use LocalStorage to store information for each queue about how many issues are in the queue and when those issues were last counted.
After each refreshing a page with queues, the total number of issues in each queue is uploaded from the LocalStorage.
Those values are uploaded only when the timeout (in miliseconds) from queueCountCacheExpireTimeoutMs property has not expired. If the time passed, it means that the value from the LocalStorage is no longer up-to-date therefore it won’t be displayed. The total number of issues in these queues will have to be counted anew.
Be careful with increasing queueCountCacheExpireTimeoutMs, because the higher it is, the higher risk that those values are no longer up-to-date.
The most expensive operation is to display the total number of issues in each queue on the list of queues.
To decide whether queues list should be refreshed or not, you can change the value of queueCountRefreshOn property to either true or false. This parameter implies whether the following properties are enabled.
The queueCountNotUpdatedRefreshRateMs property indicates time in which the algorithm searches for a queue whose total number of issues hasn’t been refreshed at all. Once all total numbers in queues have been counted (even if the queue is empty, which means the count is equal 0), the algorithm searches for a queue that hasn’t been refreshed the oldest using queueCountLeastUpdatedRefreshRateMs property and recalculates this number.
At the beginning, we recommend to increase these two properties twice in order to reduce number of requests sent by our app to Jira.
The openQueueRefreshRateMs property indicates the time in which the currently opened queue is refreshed.
{
"queuesConfig":
[/* yours queues config */],
"performance": {
"queueCountRefreshOn": false
},
"version": "3.0"
}
If you want to extend the time for properties: “queueCountNotUpdatedRefreshRateMs” and “queueCountLeastUpdatedRefreshRateMs”, type target values as in example below:
{
"queuesConfig":
[/* yours queues config */],
"performance": {
"queueCountRefreshOn": true,
"queueCountNotUpdatedRefreshRateMs": 10000,
"queueCountLeastUpdatedRefreshRateMs": 20000
},
"version": "3.0"
}
What is the difference between options: Select all and Apply to all?
- Select all allows to select all available projects. If you add a new one, you should add it to this configuration manually.
- Apply to all allows to select all available projects. If you add a new one, it will be added to this configuration automatically.
Why, in the Queues for JSM, do I have an avatar different from the one I set for my Atlassian account?
To see the custom avatar you set for your Atlassian account in our app, go to the top-right corner of the Jira top navigation, click Your profile and settings > Manage account > Profile photo and header image > Who can see your profile photo?, and select Anyone.
Now, go back to the app and enjoy your custom avatar.
Go to the documentation to learn more about updating your Atlassian account profile and visibility settings.
Why do I see projects in the app that I can’t access?
Atlassian introduced the App access rule, which, when applied by the admin or organization in a specific project, results in losing access to its content.
Read more about the App access rule in the Atlassian documentation.