Set up IBM Health Center for the runtime test environment

Complete the following steps to set up IBM Health Center for the runtime test environment.

We can analyze the Health Center data that is collected in headless mode using the Health Center client (see Installing Health Center). Tip: As an alternative to the Health Center client, we can use the WebSphere Commerce Health Center Report tool. This tool uses the Health Center file (.hcd) to generate a web-based report of the performance data with insights specific to WebSphere Commerce. See WebSphere Commerce Health Center Report.

Procedure

Complete the followings steps to enable the Health Center agent in headless mode in the Transaction server.

1. Open the WebSphere Application Server Administration Console. For example,

   https://yourserver:9043/ibm/console

2. Select Servers.

3. Expand Server Type and then click WebSphere application servers.

4. Click the name of your server.

5. Expand Java and Process Management and then click Process Definition.

6. Under the Additional Properties section, click Java Virtual Machine.

7. Scroll down and locate the Generic JVM arguments field.

8. Add the following arguments in a single line:

   -Xhealthcenter:level=headless 
   -Dcom.ibm.java.diagnostics.healthcenter.headless.output.directory=${SERVER_LOG_ROOT}/healthcenter 
   -Dcom.ibm.java.diagnostics.healthcenter.headless.run.duration=15 
   -Dcom.ibm.diagnostics.healthcenter.data.profiling=off 
   -Dcom.ibm.java.diagnostics.healthcenter.allocation.threshold.low=10000000
   -Dcom.ibm.java.diagnostics.healthcenter.stack.trace.depth=20
   -Dcom.ibm.java.diagnostics.healthcenter.headless.files.to.keep=0 

   See Health Center Configuration Properties.

Complete the following steps to update the Liberty server's generic JVM arguments in your Store, Search, and Customization (xC) containers.

9. Enter the Docker containers. For example,

   docker exec -it <container_name> bash

10. Edit /profile/jvm.options and add the following code. Edit values if needed.

    -Xhealthcenter:level=headless
    -Dcom.ibm.java.diagnostics.healthcenter.headless.output.directory=/profile/logs/healthcenter
    -Dcom.ibm.java.diagnostics.healthcenter.headless.run.duration=15
    -Dcom.ibm.diagnostics.healthcenter.data.profiling=off
    -Dcom.ibm.java.diagnostics.healthcenter.allocation.threshold.low=10000000
    -Dcom.ibm.java.diagnostics.healthcenter.stack.trace.depth=20
    -Dcom.ibm.java.diagnostics.healthcenter.headless.files.to.keep=0

11. Save the changes.

12. Restart the containers.

Health Center continuously creates healthcenter*.hcd files in the directory specified by the output.directory property at the interval set by the run.duration property. The default interval is 15 minutes.

13. When needed, fetch the healthcenter*.hcd from the container to your local server by using docker cp. For example,

    docker cp <container>:path_to_logs local_destination

Related information:

IBM Health Center Knowledge Center