Build charts and reports from GitLab data
This is your guide to advanced analytics for GitLab. See the Tour page for the available charts and visualizations.
Getting Started
Creating charts
Creating reports
Sharing with others
Also check out our how-to and the video tutorials
Got questions? Drop us email at support@screenful.com.
Build charts and reports from GitLab data
This is your guide to advanced analytics for GitLab. See the Tour page for the available charts and visualizations.
Getting Started
Creating charts
Creating reports
Sharing with others
Also check out our how-to and the video tutorials
Got questions? Drop us email at support@screenful.com.
FAQ
Common questions
Does Screenful work with the free version of GitLab?
Yes except that you won’t be able to use data from epics or issue weights since those are available only in a paid GitLab plans.
Yes except that you won’t be able to use data from epics or issue weights since those are available only in a paid GitLab plans.
Do you support self-hosted GitLab?
How are the lead and cycle times calculated in GitLab?
The timings are based on your workflow settings. You can learn more from the Lead Time FAQ.
The timings are based on your workflow settings. You can learn more from the Lead Time FAQ.
Can I include GitLab merge requests or issues in the charts?
Yes, you can filter the data shown so that either issues, merge requests, or both are included in the stats by setting a filter.
Yes, you can filter the data shown so that either issues, merge requests, or both are included in the stats by setting a filter.
Do you take into account time estimates in GitLab?
Yes, you can choose to use hours instead of issue count by selecting Hours as the unit in the chart editor.
Yes, you can choose to use hours instead of issue count by selecting Hours as the unit in the chart editor.
Can I track GitLab iterations?
Yes, you can group and filter data by iterations. You can also create a burndown chart for tracking a Gitlab iteration.
Yes, you can group and filter data by iterations. You can also create a burndown chart for tracking a Gitlab iteration.
What kind of access does Screenful require to GitLab API?
Screenful needs the “read_api” scope i.e. read-only access.
Screenful needs the “read_api” scope i.e. read-only access.
Will Screenful make changes to my data, or is my data affected in any way?
We do not make changes to your data. We only read it via the API of your tool. Screenful is only for reporting and analytics. It does not update any data within your tools.
We do not make changes to your data. We only read it via the API of your tool. Screenful is only for reporting and analytics. It does not update any data within your tools.
Are weekends included in the cycle time calculation?
By default yes, but you can specify your working hours and days in the Account Settings.
By default yes, but you can specify your working hours and days in the Account Settings.
Is there a way to remove outliers from the data?
If you want to exclude individual items from the metrics, you can do it by following the steps below
Set a specific label or tag (e.g. "excluded") to the item you want to exclude (task, issue, user story etc.)
Go to Screenful and reset the data source in the Data sync options
Go to the chart in question and set a filter (e.g. label is none of 'excluded')
If the item is already archived, you have to unarchive it first. Then apply the steps 1-2. After that, you can archive it again.
If you want to exclude individual items from the metrics, you can do it by following the steps below
Set a specific label or tag (e.g. "excluded") to the item you want to exclude (task, issue, user story etc.)
Go to Screenful and reset the data source in the Data sync options
Go to the chart in question and set a filter (e.g. label is none of 'excluded')
If the item is already archived, you have to unarchive it first. Then apply the steps 1-2. After that, you can archive it again.
Does this support my specific workflow or do I have to use some specific states like "open", "in progress" and "done"?
You are not limited to any specific set of states or a workflow. You can configure your own workflow, if such exists, and you can use that in your reporting. It's also ok if you don't have any workflow in your boards, as can create reports based on any other criteria by setting a filter.
You are not limited to any specific set of states or a workflow. You can configure your own workflow, if such exists, and you can use that in your reporting. It's also ok if you don't have any workflow in your boards, as can create reports based on any other criteria by setting a filter.
How often is data updated?
All data sources are synced automatically once per hour. Changing settings or configuration will trigger additional sync so your data is at most one hour old. You can sync data manually at any time in the sync settings.
All data sources are synced automatically once per hour. Changing settings or configuration will trigger additional sync so your data is at most one hour old. You can sync data manually at any time in the sync settings.
Can I embed these charts into my intranet?
You can embed any custom chart or report to any web page using the embed code. Learn more about the sharing feature from the online guide.
You can embed any custom chart or report to any web page using the embed code. Learn more about the sharing feature from the online guide.
I can’t find an answer to my question
The Getting Started Guide contains Instructions for setting up Screenful.
See also our Accounts & Pricing FAQ.
Check out our how-to and video tutorials, or get in touch by emailing support@screenful.com
The Getting Started Guide contains Instructions for setting up Screenful.
See also our Accounts & Pricing FAQ.
Check out our how-to and video tutorials, or get in touch by emailing support@screenful.com
FAQ
Common questions
Does Screenful work with the free version of GitLab?
Yes except that you won’t be able to use data from epics or issue weights since those are available only in a paid GitLab plans.
Yes except that you won’t be able to use data from epics or issue weights since those are available only in a paid GitLab plans.
Do you support self-hosted GitLab?
How are the lead and cycle times calculated in GitLab?
The timings are based on your workflow settings. You can learn more from the Lead Time FAQ.
The timings are based on your workflow settings. You can learn more from the Lead Time FAQ.
Can I include GitLab merge requests or issues in the charts?
Yes, you can filter the data shown so that either issues, merge requests, or both are included in the stats by setting a filter.
Yes, you can filter the data shown so that either issues, merge requests, or both are included in the stats by setting a filter.
Do you take into account time estimates in GitLab?
Yes, you can choose to use hours instead of issue count by selecting Hours as the unit in the chart editor.
Yes, you can choose to use hours instead of issue count by selecting Hours as the unit in the chart editor.
Can I track GitLab iterations?
Yes, you can group and filter data by iterations. You can also create a burndown chart for tracking a Gitlab iteration.
Yes, you can group and filter data by iterations. You can also create a burndown chart for tracking a Gitlab iteration.
What kind of access does Screenful require to GitLab API?
Screenful needs the “read_api” scope i.e. read-only access.
Screenful needs the “read_api” scope i.e. read-only access.
Will Screenful make changes to my data, or is my data affected in any way?
We do not make changes to your data. We only read it via the API of your tool. Screenful is only for reporting and analytics. It does not update any data within your tools.
We do not make changes to your data. We only read it via the API of your tool. Screenful is only for reporting and analytics. It does not update any data within your tools.
Are weekends included in the cycle time calculation?
By default yes, but you can specify your working hours and days in the Account Settings.
By default yes, but you can specify your working hours and days in the Account Settings.
Is there a way to remove outliers from the data?
If you want to exclude individual items from the metrics, you can do it by following the steps below
Set a specific label or tag (e.g. "excluded") to the item you want to exclude (task, issue, user story etc.)
Go to Screenful and reset the data source in the Data sync options
Go to the chart in question and set a filter (e.g. label is none of 'excluded')
If the item is already archived, you have to unarchive it first. Then apply the steps 1-2. After that, you can archive it again.
If you want to exclude individual items from the metrics, you can do it by following the steps below
Set a specific label or tag (e.g. "excluded") to the item you want to exclude (task, issue, user story etc.)
Go to Screenful and reset the data source in the Data sync options
Go to the chart in question and set a filter (e.g. label is none of 'excluded')
If the item is already archived, you have to unarchive it first. Then apply the steps 1-2. After that, you can archive it again.
Does this support my specific workflow or do I have to use some specific states like "open", "in progress" and "done"?
You are not limited to any specific set of states or a workflow. You can configure your own workflow, if such exists, and you can use that in your reporting. It's also ok if you don't have any workflow in your boards, as can create reports based on any other criteria by setting a filter.
You are not limited to any specific set of states or a workflow. You can configure your own workflow, if such exists, and you can use that in your reporting. It's also ok if you don't have any workflow in your boards, as can create reports based on any other criteria by setting a filter.
How often is data updated?
All data sources are synced automatically once per hour. Changing settings or configuration will trigger additional sync so your data is at most one hour old. You can sync data manually at any time in the sync settings.
All data sources are synced automatically once per hour. Changing settings or configuration will trigger additional sync so your data is at most one hour old. You can sync data manually at any time in the sync settings.
Can I embed these charts into my intranet?
You can embed any custom chart or report to any web page using the embed code. Learn more about the sharing feature from the online guide.
You can embed any custom chart or report to any web page using the embed code. Learn more about the sharing feature from the online guide.
I can’t find an answer to my question
The Getting Started Guide contains Instructions for setting up Screenful.
See also our Accounts & Pricing FAQ.
Check out our how-to and video tutorials, or get in touch by emailing support@screenful.com
The Getting Started Guide contains Instructions for setting up Screenful.
See also our Accounts & Pricing FAQ.
Check out our how-to and video tutorials, or get in touch by emailing support@screenful.com
Troubleshooting
The number of items in Screenful does not match what I see in GitLab
Screenful connects to the GitLab board, not a project or group, so the first thing would be to check that the missing issues or pull requests are visible on that board.
Screenful connects to the GitLab board, not a project or group, so the first thing would be to check that the missing issues or pull requests are visible on that board.
I added a new custom field but it is not showing
When you add a new custom field to your board, it is imported during the next data sync (the data is synced automatically once per hour). You can trigger sync manually anytime by selecting Data sync options from the main menu. Notice that the new field should also have a value assigned in at least one task.
When you add a new custom field to your board, it is imported during the next data sync (the data is synced automatically once per hour). You can trigger sync manually anytime by selecting Data sync options from the main menu. Notice that the new field should also have a value assigned in at least one task.
Some filtering options are missing
Filter options are derived from task data, which means that if you recently added some properties, such as labels, but haven't yet assigned them to any tasks, they won't show up in the filter options. As soon as you assign them to tasks, they will show up in the filter options from then on.
Filter options are derived from task data, which means that if you recently added some properties, such as labels, but haven't yet assigned them to any tasks, they won't show up in the filter options. As soon as you assign them to tasks, they will show up in the filter options from then on.
Troubleshooting
The number of items in Screenful does not match what I see in GitLab
Screenful connects to the GitLab board, not a project or group, so the first thing would be to check that the missing issues or pull requests are visible on that board.
Screenful connects to the GitLab board, not a project or group, so the first thing would be to check that the missing issues or pull requests are visible on that board.
I added a new custom field but it is not showing
When you add a new custom field to your board, it is imported during the next data sync (the data is synced automatically once per hour). You can trigger sync manually anytime by selecting Data sync options from the main menu. Notice that the new field should also have a value assigned in at least one task.
When you add a new custom field to your board, it is imported during the next data sync (the data is synced automatically once per hour). You can trigger sync manually anytime by selecting Data sync options from the main menu. Notice that the new field should also have a value assigned in at least one task.
Some filtering options are missing
Filter options are derived from task data, which means that if you recently added some properties, such as labels, but haven't yet assigned them to any tasks, they won't show up in the filter options. As soon as you assign them to tasks, they will show up in the filter options from then on.
Filter options are derived from task data, which means that if you recently added some properties, such as labels, but haven't yet assigned them to any tasks, they won't show up in the filter options. As soon as you assign them to tasks, they will show up in the filter options from then on.