Configuring to export report counters automatically

When you run a test or schedule from the Command-line interface (CLI), you can configure HCL DevOps Test Performance (Test Performance) to export reports automatically.

Procedure

  1. Open Test Performance.
  2. Click Windows > Preferences > Test > Performance Test Reports > Export Reports.
  3. Perform the following actions in the Export Reports window:
    Options Actions
    Command Line

    Select this checkbox to export the report after the test run is complete when you run the test or schedule from the command-line interface. The report is stored in the Exported Results Data directory. You can access this report from the Test Navigator pane.

    The report is also saved in the Results directory. You can access the Results directory by navigating to the location of your workspace.

    For example, C:\Users\username\HCL\devopstest\workspace_name\project_name\Results

    If you select the Command Line option, you can also select the Print simple CSV reports to command line option. When you select these two options, then you can display the exported data on the command-line interface, if you used the -stdout parameter. Otherwise, the report information is printed in the CommandLineLog.txt file. You can access this file from the following path:

    C:\Users\username\AppData\Local\Temp\CommandLineLog.txt
    Note: The command line preferences take the precedence over preferences set in Test Performance.

    Consider that you selected the Command Line and Print simple CSV reports to command line options. You then run the test or schedule from the command-line interface by using the -exportstats or -exportstatsformat parameter. In this scenario, the report is exported to the path mentioned for the -exportstats parameter.
    Workbench

    Select this checkbox to export report after the test run is complete when you run the test or schedule from Test Performance. The report is stored in the Exported Results Data directory. You can access this report from the Test Navigator pane.

    The report is also saved in the Results directory. You can access the Results directory by navigating to the location of your workspace.

    For example, C:\Users\username\HCL\devopstest\workspace_name\project_name\Results
    Simple (one value per counter and per time range)

    Select this checkbox and choose the format of the report from the drop-down list to export a simple report.

    You can choose either CSV or JSON from the drop-down list.
    List All Time Ranges

    Select this checkbox to include data from all the time ranges. The default time range that is included is Entire Run.
    Full (one value per counter and per sample interval)

    Select this checkbox and choose the format of the report from the drop-down list to export a comprehensive report that includes the result name, node name, and time ranges. Generally, you do not include these details unless you export the customized reports that include counters from specific test runs.

    You can choose either CSV or JSON from the drop-down list.
    Split output if counters number exceeds

    Select this checkbox and specify a value to create multiple CSV or JSON files if the number of counters in the exported file exceed the specified value.
    Include per instance counters

    Select this checkbox to include detailed data of counters for each page.
    Export each agent separately

    Select this checkbox to group the data in the exported CSV or JSON file by agent that is used during test run.
    One file per agent

    Select this checkbox to group the data by agent as a separate CSV or JSON files.

    Note: The One file per agent option is available only when you select the Export each agent separately option.
    File name format

    Select a format for the file name of the exported file from the drop-down list. You can select one of the following options from the drop-down list:

    • Pre-9.0 release: Select this option to save the exported report file name as [REPORT_NAME][AGENT_NAME][SPLIT_INDEX].

    • 9.0 release: Select this option to save the exported report file name as [TEST_NAME][AGENT_NAME][SPLIT_INDEX]_[TIME_STAMP]_[REPORT_ID]_[EXPORT_TYPE].

    • Custom pattern: Select this option and specify a pattern that you would like to save the exported report file.
    HTML report

    Select this checkbox to export full report data in a HTML format.
    Executive Summary report

    Select this checkbox to export the executive summary report in a HTML format. The report that you selected from the drop-down list summarizes the state of the test or schedule run and displays the report on only one HTML page. You can print this report.

    The Executive Summary report is saved in the Results directory. You can access the Results directory by navigating to the location of your workspace.

    For example, C:\Users\username\HCL\devopstest\workspace_name\project_name\Results
    Select reports to export

    Select the required reports checkbox from the list to export reports into CSV, JSON, or HTML formats.

    If you select one or more reports, then each report is exported to a separate CSV or JSON file in the Exported Results Data directory. You can access these reports from the Test Navigator pane.

    Select the Show Report Ids checkbox to view the ID of each report. The IDs are used when you export the specific reports from the command-line interface.
  4. Click Apply and Close.

Results

You have configured Test Performance to export test reports automatically into the CSV or JSON file.