In This Section |
|
The X Platform exposes a wealth of statistics to help administrators measure many performance and health related aspects of software systems built on top of the platform. This includes details about message throughput (raw counts and rates), object pool usage, transaction statistics and system-level information like detailed thread breakdowns and CPU utilization, along with statistics defined by the application. This section discusses how to work configure and work with these statistics. |
Generally speaking, these statistics are collected automatically, but the reporting of these statistics is quite conservative by default. A number of configuration options have been made available to give administrators control over the level of detail they wish to see in trace output and/or server heartbeat messages. Even with much of the tracing output enabled, some interpretation is required to fully understand what the statistics are saying. Certain configuration options (heartbeat logging, for example) will require the use of specialized tools in order for administrators to review the full range of statistics available to them.
The pages in this section cover both configuration as it relates to statistics and the interpretation of the reported statistics.
AEP Engine Statistics are most useful as a relatively light-weight means of benchmarking applications built on the X Platform during development. They include details about inbound and outbout message throughput (raw counters and rates), transaction performance stats, per-event/message type latencies, store stats/latencies and more.
See AEP Engine Statistics documentation for more information.
Developers building applications on top of X will often want to record their own application specific statistics. In X parlance, these are "User Defined App Stats".
See User Defined App Stats documentation for more information.
Where AEP Engine Statistics capture the statistics associated with a single AEP engine, Server Statistics pertain to the server itself (e.g. load average, memory usage, per-thread CPU utilization, object pools) and all applications/engines therein. Server stats are periodically collected and emitted packaged as Server Hearbeats that are modeled as ADM Messages. The server can:
See the Server Statistics documentation for more information.
When server heartbeat logging is enabled, the X Platform will periodically write "heartbeat" messages to a binary transaction log at a regular fixed interval. These heartbeat messages contain server, application and engine stats in a format that the Stats Dump Tool understands. The Stats Dump Tool thus provides administrators an easy means of querying the heartbeat log offline.
See Stats Dump Tool documentation for more information.