Introduction

This guide provides an overview and instructions for using the Performance Analysis Tool integrated into the Service Management tool administration UI. The tool is instrumental in identifying operations that consume significant time, offering insights into configurations or usage scenarios that may affect system performance. The performance analysis tool is available in ESM versions 2024.1 and newer.

Enabling Performance Analysis

To access the performance monitoring features, enable the platform setting labeled performance.statistics.enabled by setting the value to true. This tool offers two observation periods, found under the System status section of ESM administration UI:

• Performance Statistics Since Restart: Provides insights using the time from the last system restart to the current time as the observation period.
• Daily Performance Statistics: Offers a daily overview of performance metrics.

Statistics can be reset by toggling the performance monitoring feature off and on in the platform settings.

Features and Functionalities

• Tree Structure Display: Results are bundled by operation type in a hierarchical format for ease of analysis:
• Execution Details: Total time spent, the number of executions, and average duration are available for each operation or group of operations.
• In-Depth Analysis: Drill down to the slowest 10 operations to review the sequence of individual operations performed on a data card:
  
• Multi-Edit Overview: For operations like multi-edits, the tool displays all actions made as part of that operation:

Key Phases in Datacard Updates

• EntityUpdate: Observations typically show listeners as the slowest operations.
• EntityPreStore: Handlers, often expressions, are usually the slowest, indicating potential performance issues.
• PostStore: Includes data card change history and more handlers. Listeners related to workflows are also presented here, highlighting the relatively slowest operations (PersistenceListenerPostStore WorkflowListener)

Benchmarking Performance

• WebAPI searches taking around 1 minute are considered slow.
• Entity updates exceeding a few seconds are deemed inefficient and durations of tens of seconds will most likely cause notable impact in the user experience.

Sorting Logic

The tool sorts results based on the total duration, ensuring that the slowest operations are prominently featured for immediate action.

Identifying Slow Bookmarks

The tool's functionality extends to identifying slow bookmarks, which can help pinpoint inefficiencies related to specific user or role-based configurations. The bookmark parent role and potential folders are shown, helping the tool user to find the bookmark in question. 

Final Insights

At the end of the analysis, users can find links to the relevant data card, template, or attribute. Additional information such as the user ID, bookmark name, and user or role association with the bookmark is also accessible. For public views, the user name associated with the operation is displayed, without revealing folder structures.

Usage Guide

1. Enable performance monitoring using the performance.statistics.enabled platform setting.
2. Select the desired observation period for analysis (since last restart or today)
3. Review the tree structure for top-level insights and drill down for detailed information.
4. Focus on the operations with the longest total durations by inspecting the items on the top.
5. Investigate slow bookmarks for potential optimizations.
6. Utilize the provided links at the end of the analysis to directly access data cards, handlers or user information.
7. It is also possible to reset the statistics by turning the feature off and back on in the platform settings.

Conclusion

The Performance Analysis Tool is a useful tool for ESM administrators to ensure optimal system performance. By utilizing this tool, administrators can proactively address performance concerns, optimize configurations, and enhance the overall efficiency of the ESM environment. Regular use and analysis will contribute to a smoother, more effective service management experience.

The results are shown in a tree structure, bundled based on the operation type. When drilling down in the structure, it is possible to see following information:

• Total time spent executing an operation or group of operations.
• Number of times the operation or group of operations were executed.
• Average execution duration of the operation or group of operations.

The lowest level is able to show you information from the lowest level of the operations.

Accessing an individual occurrence through clicking “Slowest” allows you to see, the slowest 10 operations in the observation period. When drilling down to the data, you can see the individual operations executed in the order they were performed on an individual data card.