Identifying performance problems

Log files are in the Maximo Real Estate and Facilities installation subfolder that is named \log\. Log files are appended with the creation date. You can also download and roll over log files from the error logs in the Administrator Console. Several tools are available that can help you to analyze the following log files:

server.log

Contains standard Maximo Real Estate and Facilities logging.

security.log

Contains security-related logging, user logins, and admin user changes.

ObjectMigration.log

Contains Object Migration (OM) tool logging.

performance.log

Contains performance DEBUG-level logging from the platform logging mechanism.

systemmetrics.log

Contains performance information from the Administrator Console.

View the following IBM HTTP Server log files:

• access.log
• admin_access.log
• admin_error.log
• error.log
• http_plug.log

Manage the following memory-related performance issues:

Memory footprint contributors

The following processes can increase the heap memory on the application server:

• Workflow Instances: When set to ALWAYS, the WF_INSTANCE_SAVE property consumes a substantial amount of memory on the application server and slows down the performance of workflows and actions. Set workflow instance saving to ALWAYS only if you are actively debugging workflows. Do not set to ALWAYS for longer than needed.
• BIRT reporting: The BIRT engine consumes a substantial amount of heap memory when exporting extensive datasets.
• DataConnect task: When you build a workflow with the DataConnect task, commit no more than 10 records at a time in the Transaction section. Tune this setting to reflect on the degree of integration for your Maximo Real Estate and Facilities implementation.

Diagnosing Out of Memory errors

When an Out of Memory error occurs, restart the application server. Generate a heap dump at the point of the Out of Memory error.

In WebSphere® Application Server Liberty profile, the heap output file is created in the default directory, ${server.output.dir}.

Memory Analyzer

Analyze the heap dump by using the Eclipse Eclipse Memory Analyzer Tool (MAT) to find the memory leaks and reduce memory consumption. If your heap dump is larger than 6 GB, the MAT consumes a lot of memory. Your workstation needs at least 16 GB of RAM. Close all other applications and configure the Eclipse config.ini file to set its own max heap size to 15 GB by using -Xmx15G.

The Overview section gives you insight into what the heap contains. Typically, the first- level or second-level objects explain what consumed the heap. Figures 1 and 2 are examples of BIRT report and workflow instance Out of Memory heaps. You can identify the main area that consumed the heap in the Problem Suspect section.

The Memory analyzer workflow instance Out of Memory heap message is as follows:

1,051,855 instances of "com.tririga.platform.workflow.runtime.WFContext", loaded 
by "war:IBM-TRIRIGA_Build-227459/ibm-tririga.war" occupy 3,637,218,776 (86.70%) bytes.

The memory analyzer BIRT report Out of Memory heap is as follows:

One instance of "org.eclipse.birt.report.model.core.DesignSession", loaded 
by "<system class loader>" occupies 8,471,008,096 (89.43%) bytes. The memory is accumulated in one instance of 
"Java.Lang.Object[]" loaded by "<system class loader>".

Use the following tools to analyze system performance, workflow performance, and other areas of the platform:

IBM Maximo Real Estate and Facilities Administrator Console

Provides a collection of administrative tools to analyze and optimize system performance.

Workflow Analysis Utility (WAU)

Analyzes workflow performance and process execution. The utility reads Maximo Real Estate and Facilities performance logs and displays performance analytics for workflows, including workflow execution time, and process flow, which is the order in which workflows run and what triggered them to run. The Workflow Analysis Utility is available as a separate utility from the product.

Performance Analyzer

Analyzes issues in system performance. The Performance Analyzer provides a more streamlined approach to troubleshooting performance issues than the traditional Maximo Real Estate and Facilities performance log analysis. The Performance Analyzer helps you to better isolate and analyze the causes of performance issues by generating a log that is more targeted for the problem area.Access the Performance Analyzer in IBM Maximo Real Estate and Facilities under Tools. You can generate a log from the Performance Analyzer that is more targeted at the problem area. When you select the performance timings that you want and start a performance run, the analyzer writes to the performance log while you do the process or actions that cause the slowness.

When you stop the performance run, the analyzer automatically loads and analyzes the performance data to show the most time consuming events of each category type in the performance run. A result summary of the performance run shows the top events that took the longest time to run. You can further analyze the data by reviewing the result details. You can also upload an existing performance log to the analyzer and the analyzer does the same analysis of the data.