Costs & Metrics reports – most common issues & troubleshooting
Introduction
This article provides solutions to the most common issues with Costs & Metrics reports.
Before reading the article below, we recommend that you have a good understanding of the mechanism and the prerequisites for correct generation of the Costs & Metrics report, which is described in detail in a dedicated article: Costs & Metrics reports. Also, since the correct generation of Costs & Metrics reports depend on the correct generation of costs for a specific project. Make sure that you have also read the article below. It describes and provides troubleshooting tips for the most common causes for incorrect costs generation: Costs generation – most common issues & troubleshooting. |
|---|
Issue description & Solution
Reports are being generated endlessly
Solution: This behavior by XTM Cloud is incorrect and must be reported to the XTM International Support team. Please provide details.
However, remember to first wait a little time and see if the issue resolves itself. This might happen if you try to generate a report for a lot of projects. Also, the process might sometimes take longer than expected due to technical difficulties. Please do not generate many reports in a row because it is highly likely that this will not help to generated the report. It can only increase the number of blocked database queries, which at some point might stop XTM Cloud from operating, for all users on a particular server.
The data in a report is inconsistent with whatever is in the UI
Solution: Remember that, by default, the Costs & The Metrics report retrieved from specific projects is based on data from the last correctly generated costs in those projects, i.e. those which did not contain errors or warnings after the generation process – red and yellow symbols next to entries in Project editor → Estimates → Costs.
IMPORTANT!
Note that there is an Include costs with warnings in Cost and metrics reports option, which enables cost entries with WARNINGS (yellow) in reports as well.
After you change the project settings or cost settings, make sure that the costs are generated again before you attempt to generate the report. Generating a report does not automatically generate costs if any costs were correctly generated in the past, in a specific project.
Also remember that, when the report is generated, if the project does not contain correctly generated costs, the costs will be created on the basis of the settings made in Configuration → Data → Estimates → Cost settings → Cost settings.
Projects which are included in the scope are missing in the generated report
Solution: As mentioned in the Introduction, the most probable reason for this situation is that the costs for the projects in question have been generated incorrectly. Therefore, to verify if this is the case, go to Project editor → Estimates → Costs, for a specific project and address the issue by reading Costs generation – most common issues & troubleshooting.