Monitor

The Engine Cockpit allows you to monitor your Axon Ivy Engine.

OS

The OS page shows an overview of the CPU load, memory load, network traffic and disk read-write activity. Additionally, the memory monitor displays the max and current memory usage of the JVM.

../../../_images/engine-cockpit-monitor-os.png

Java

The Java pages allow you to monitor some critical indicators of Java (Java virtual machine) in your Axon Ivy Engine:

  • JVM: CPU load, number of threads, loaded and unloaded classes

  • Memory: Heap and non-heap memory, garbage collection times

  • Class Histogram: Classes and their instances allocated on the heap

  • Threads: Threads and their CPU and user times

  • Flight Recorder: Start, stop and download Java flight Recordings

  • MBeans: Java Management Extensions (JMX) MBeans viewer

../../../_images/engine-cockpit-monitor-jvm.png

Class Histogram

The Class Histogram view displays all classes that have currently object instances allocated on the heap. The view shows a filterable list of all classes, the number of allocated instances, and the allocated memory those instances consume, in bytes. If you refresh the view, the deltas to the minimum and maximum number of instances are displayed. This allows you to find memory leaks. If the number of instances of a class has always an increasing Δ Min and the Δ Max is always zero, then you have a memory leak. If you need further details to analyze a memory leak you can press the Dump Heap Memory button to create and download a dump of the heap memory. We recommend that you use Eclipse Memory Analyzer to further analyze the produced heap dump file.

../../../_images/engine-cockpit-monitor-class-histogram.png

Threads

The Threads view shows you an overview of all threads. For each thread, you see how much CPU and user time it consumes, in which states they are, and their priorities. If two threads are deadlocked the State of the threads is red and there is a warning icon nearby with more information about the deadlock. You can click on a thread to get more information about it like the current stack trace. Press on the Save Thread Dump icon on the top right to create a thread dump and download it to a file.

../../../_images/engine-cockpit-monitor-threads.png

Java Flight Recorder

You can use the Flight Recorder view to start, stop, download, and delete Java Flight Recorder recordings. When starting a recording, you can choose between predefined configurations that are provided by the Java Virtual Machine or you can add your own configuration by uploading a *.jfc file. You can create a *.jfc file with Flight Recorder Template Manager that is part of the JDK Mission Control tool. You can download a recording to a *.jfr file once it is stopped. Then, use the JDK Mission Control tool to analyze the *.jfr file.

../../../_images/engine-cockpit-monitor-jfr.png

MBeans

The MBeans view displays a tree with all engine Java Management Extensions (JMX) MBeans. Click on one of the MBeans to see all of its attributes. Click on an attribute with numeric values to display the value of the attribute over time in a chart. You can add multiple attributes to the chart. Click on the remove icon in the table below the chart to remove the attribute from the chart.

../../../_images/engine-cockpit-monitor-mbeans.png

Engine

The Engine pages allow you to monitor some critical indicators of your Axon Ivy Engine:

  • Sessions: Overview of open user sessions

  • Cache: System database caches and their metrics

Sessions

The Sessions view gives you an overview over all open user sessions. Sessions can be destroyed and you can also see the reason for open sessions, especially in the case of a session leak.

../../../_images/engine-cockpit-monitor-sessions.png

Cache

The Cache view displays a table with all system database caches and their metrics. The caches reduce the number of system database read accesses.

Increasing the amount of data that is cached may help solve performance problems. You should try to increase the cache limits if you have a lot of read misses and the number of cached entities are near or above the limit. If this is the case, the number of both corresponding columns are displayed in red. You can configure the cache limits in the ivy.yaml file.

../../../_images/engine-cockpit-monitor-cache.png

Performance

The Performance pages allow you to monitor performance indicators of your Axon Ivy Engine:

  • Process Execution: Execution times of process elements

  • Slow Requests: Analyze slow requests and their causes

  • Traffic Graph: Overview of the inbound and outbound traffic

Process Execution

The Process Execution view allows you to activate and analyze the Process Element Performance statistic.

You can start, stop, clear or refresh the statistic, or export it to an Excel file. Note: by default not all available columns are shown. Use the configure columns button right to the search box to show or hide the columns.

If you want to configure that the statistic is written periodically to a CSV Statistics File use the configuration icon left to the help button it will take you directly to the corresponding settings in the System Configuration.

../../../_images/engine-cockpit-monitor-process-execution.png

Slow Requests

The Slow Requests view allows you to activate and analyze the Request Tracing. If activated every request is traced. The fifty slowest requests will be displayed in this view.

You can start, stop, clear or refresh the tracing or export it to an Excel file. Hover with the mouse on the name to see additional attributes of the request. You can click on a request to see where the time of the request was spent (e.g., on external calls to REST, SOAP service, databases etc.).

../../../_images/engine-cockpit-monitor-slow-requests.png

Traffic Graph

The Traffic Graph view gives you a quick overview of inbound and outbound communication channels to and from the Axon Ivy Engine. The more request a certain communication channel has the wider it is displayed. The color reflects the response times. Green means fast response times. Red means slow request times relative to the other communication channels. The color of the source or target of a communication link indicates if there are errors. Hover over source or target of a communication channel to get more detailed information. Like Slow Requests you have to activate Request Tracing to get useful data.

../../../_images/engine-cockpit-monitor-traffic-graph.png

Logs

The logs view shows the current engine log files console.log, config.log, deprecation.log, ivy.log and usersynch.log. Click on + to show or - to hide the log file details. If you want to look at the logs of an different day, you can change the date at the top right.

../../../_images/engine-cockpit-monitor-logs.png

Services

The Services pages allows you to monitor some critical indicators of external services your Axon Ivy Engine communicates with:

  • Email: Number of mails sent, execution time to send mails.

  • System Database: Number of open and used connections, number of transactions and errors, transaction processing time.

  • Databases: Number of open and used connections, number of queries and errors, query execution time of the selected database.

  • Web Services: Number of calls and errors, execution time of the selected web service.

  • REST Clients: Number of open and used connections, Number of calls and errors, execution time of the selected REST client.

You can open these life stats from the detailed view of the desired service using the monitor button at the right side.

../../../_images/engine-cockpit-monitor-databases.png