Collecting metrics for historical trends reports

Before you can build trends reports that show changes over time, you must configure and schedule Lifecycle Query Engine tasks to collect data.

About this task

You create, edit, and enable metric collection tasks on the Data metrics administration page at http://<host_name>:<port>/lqe/web/admin/metric-config.

A sample task is available on the Data metrics page. To modify this task, click the task name, and change the settings:
  • You can change the task name.
  • You can edit the schedule to collect metrics at a different time.
  • Choose the configurations that contain the versions of the artifacts you want historical metrics on.
  • Select what metrics to gather.

To run this task, click Run now.

To create a data collection task, follow the procedure.

Procedure

  1. Go to the Data metrics page at http://<host_name>:<port>/lqe/web/admin/metric-config. On the Lifecycle Query Engine Administration page, find Data metrics in the menu, under Query & report data.
    Data metrics page in the Administration section
  2. Click New task, and enter the task name.
    Entering a task name
  3. Schedule the task.
    Click Edit to configure the date and time, and to enable the task.
    Important: Collecting data can be resource-intensive. Schedule the task to run when the server isn’t heavily used.
    Scheduling the task
    1. Select the days and time.
    2. Select the check box to enable the task. Then, click OK to save.
    Scheduling the task in the editor
  4. Select the configurations that contain the versions of the artifacts you want to collect metrics on.
    If you don't select any configuration, the task collects metrics from all data.
    Important: To avoid performance issues, choose only the configurations you want to focus on. If you collect historical metrics from all the data, you end up running resource-intensive data collection jobs for each configuration.
    Selecting configurations
    Remember: Metric collection isn’t automatically enabled for new configurations; you must add new configurations to existing tasks.
  5. Choose what metrics to gather by selecting the Enable check box.
    Enabling the task
  6. If you want the task to run as scheduled, click Save, or click Save > Run now.

What to do next

You can now create historical trends reports with Report Builder.

If team members choose an LQE-based data source and the Report Builder reports don’t show the artifacts that they expect, show artifacts more than once, or show a different number of artifacts than application views, you can validate the TRS feeds for the application. See Validating TRS feeds and the LQE index.