Using the Performance Measurement tool

The Performance Measurement can help you analyze your cache settings and improve performance.

Before you begin

Ensure that can you are able to perform the following tasks in your environment:
  • Configure the size of log files
  • Configure the log level of which layer to measure and at which depth.
  • Analyze the logs that are produced by the server administrator and identify potential improvements.

About this task

The Performance Measurement tool generates reports that you can use to improve performance. The tool is a command-line utility, which you will run from inside the utility container. To run the Performance Measurement tool to generate reports, you use a command-line utility run the batch file that calls the tool. This file contains the details for the report that you want to generate. For example, the file can include the following information:

  • The list of log files to analyze
  • The location in which to store the reports
  • The type of reports to produce


  1. Configure logging and tracing to capture performance data. See Tracing and logging in HCL Commerce Search.
  2. Reproduce the scenario that needs to be measured by running an operation or performance test. When you reproduce the scenario, the metric data is recording in the log files.
  3. Run the Performance Measurement tool.
    Development environment
    1. From the WCDE_installdir\bin directory, run the following command.
    The generated reports are in the following directory: WCDE_installdir\performance\reports
    Runtime environment
    1. Open the Utility container.
    2. Copy the performance trace files from the Runtime container to the Utility container so that the tool can find them. The Performance Measurement tool runs in the Utility container, but analyzes log files generated in the HCL Commerce Runtime container.
    3. Update property in utilities_root/performance/config/ to indicate where the copied trace files are located.
    4. From the /opt/WebSphere/CommerceServer90/bin directory run the command:

    The generated reports are in the following directory: utilities_root/performance/reports

  4. Analyze the generated reports to identify the processes where the cache settings can be improved.

What to do next

Configure your caching, or make design or architectural changes that are based on your analysis to improve performance.