Version

    Resources

    After logging into CloverDX Server you are automatically redirected to the Resources section, which provides an overview of the Server’s current state and recent history from the technical point of view (e.g., the heap space allocated to the Server worker and core or the system memory and CPU utilization). This section also allows you to manage the Server core and worker processes. The appearance of the Resources section is different in standalone Server environments and Cluster environments: see Standalone server view and Cluster view.

    Standalone server view

    In a standalone Server environment, an overview of information about resource utilization and performance of CloverDX Server will be displayed. You can also manage the Server core and/or worker processes here. The information on this page is grouped into several panels and refreshed every 10 seconds. The following panels are displayed by default:

    The following panels can be optionally displayed by using the Show details Actions option:

    serverMonitoringStandalone
    Figure 79. Standalone server detail
    Resource utilization panel

    The Resource Utilization panel shows the heap and non-heap memory currently allocated to the Server worker and core processes, system memory, and system disk swap.

    monitoring resource utilization
    Figure 80. Resource Utilization
    Worker and Server Core heap

    Hover over the Worker or Server Core heap dials to see further information about the JVM heap memory usage.

    • Used: the amount of memory currently used by objects in the heap, including recently used objects that haven’t been garbage collected yet.

    • Committed: the pre-allocated amount of memory reserved for the heap objects by the operating system. This is the memory usage (together with the non-heap committed memory) reflected in OS memory monitoring tools. If the JVM needs more memory, it will attempt to allocate it from the OS, increasing the committed heap.

    • Max: the absolute limit on how much memory the heap can grow to. It’s set using the -Xmx JVM flag.

    Even if the requested increase in committed memory is lower than the max heap size, the JVM might be terminated at the OS level if there is no available memory.
    System memory

    The System memory dial display the total OS memory and its current usage.

    Worker and Server Core non-heap

    Hover over the Worker or Server core non-heap dials to see further information on the JVM non-heap memory usage.

    • Used: the amount of memory currently used by non-heap objects.

    • Committed: the pre-allocated amount of memory reserverd for the non-heap objects by the operating system. This amount (together with the heap committed memory) is reflected in OS memory monitoring tools.

    • Max: the absolute limit on how much memory the non-heap can grow to.

    Even if the requested increase in committed memory is lower than the max non-heap size, the JVM might be terminated at the OS level if there is no available memory.
    System disk swap

    This dial display the current state of disk swap in your OS.

    Worker and System panels

    These two panels display information about the worker process (e.g., current state or uptime) and operating system (e.g., current time, timezone, and system uptime).

    monitoring standalone worker
    Figure 81. Worker
    Performance panel

    The Performance panel includes three line charts: Running jobs, Heap memory, and CPU load.

    You can display a tooltip with detailed information for a selected point in time by hovering over the charts. For better visibility, you can enable/disable individual lines in the charts by clicking on their label below the respective graphs.

    You can modify the displayed time interval by hovering over one of the charts and mouse scrolling or using the slider at the bottom of this section. The slider allows you to set the start and end time intervals individually. By default, the maximum time interval for the charts in the Performance panel is 24 hours. This value can be modified using the cluster.node.sendinfo.stats.interval property.

    Running jobs chart

    The Jobs chart displays the number of running and enqueued jobs.

    monitoring running jobs
    Figure 82. Running jobs chart
    Heap memory chart

    The Heap memory chart displays the amount of used Server core and worker heap memory.

    Note that the heap memory is constantly oscillating, even in an idle state, since it is periodically managed by the JVM garbage collector (i.e., the temporary data required for running CloverDX Server and Worker is periodically removed from/allocated to the heap memory).

    monitoring heap memory
    Figure 83. Heap memory
    CPU load chart

    The CPU chart displays information about CloverDX Server core, worker, and system CPU load.

    monitoring cpu load
    Figure 84. CPU Load
    Running jobs / Enqueued jobs panel

    The Running jobs / Enqueued Jobs panel lists the 10 most recent currently running or enqueued jobs. This panel is visible only if there are any running or enqueued jobs.

    monitoring standallone running jobs
    Figure 85. Currently running jobs
    Status history panel

    The Status history panel displays core and worker status history since the restart of the Server.

    monitoring standallone status history
    Figure 86. Status history
    Users' accesses panel

    This panel lists information about activities on files performed by users. The list displays a timestamp of an event, username, IP address, and name of the method.

    monitoring standallone usersaccesses
    Figure 87. Users' accesses panel
    License panel

    The License panel contains license information like the license number, license expiration date, and license location.

    monitoring standalone license
    Figure 88. System
    Classloader cache panel

    The Classloader cache panel lists all currently cached classloaders. The classloader cache may be empty as classloader caching is disabled by default.

    Status panel

    The Status panel displays information like current node status, heap and non-heap memory usage, Java version, exact CloverDX Server version, JDBC driver used to connect to the system database, etc.

    monitoring standallone status
    Figure 89. Status
    Resource utilization detail panel

    The Resource Utilization Detail panel provides additional information about Server utilization of operating system resources.

    monitoring standallone resource util
    Figure 90. Status
    Heartbeat panel

    The Heartbeat panel lists heartbeat events between the Server core and system database.

    monitoring standallone heartbeat
    Figure 91. Heartbeat
    Threads panel

    The Threads panel lists Java threads and their states.

    monitoring standallone threads
    Figure 92. Threads
    Quartz panel

    The Quartz panel lists scheduled actions: their name, description, start time, end time, time of the previous event, and the time of the next event.

    monitoring standallone quartz
    Figure 93. Quartz

    Cluster view

    After logging into the CloverDX console in a Cluster environment, the Resources section will by default display an overview of all configured Cluster nodes. The information is grouped into several panels:

    • List of Cluster nodes, their resource utilization, URL, uptime, and the number of currently running and enqueued jobs. In the nodes list on the left side, you can easily see to which node you are currently connected. By default, the check boxes next to each node are selected, allowing you to quickly control all nodes at once. Nodes can be suspended gracefully (i.e., nodes will be suspended only after all currently running jobs on the nodes have finished) by selecting the nodes and clicking on the Suspend button. If you want to suspend nodes forcefully use the Suspend At Once button instead. To resume suspended nodes use the Resume button.

    • Status history panel, which displays the last 10 status changes from all Cluster nodes.

    • Running jobs panel, which will be displayed only when there are currently running jobs.

    The information in this section is automatically refreshed every 10 seconds. If you want to refresh it yourselves or stop refreshing it, use the Refresh or Stop Refreshing buttons, respectively.

    In the nodes list on the left side, you can easily see to which node you are currently connected.

    clusterMonitoringGroup
    Figure 94. Cluster View
    Node detail view

    By clicking on a specific node in the node list on the left side, you will be redirected to a node view, which displays the same kind of information as described in the Standalone Server View section, and which allows you to manage the Server core and worker processes on the selected node.

    clusterMonitoringNode
    Figure 95. Node detail

    Server management

    The Resources section allows you to control the Server core and worker processes, as well as display additional debug information. The controls can be found under the Actions menu in the upper right corner. When connected to a standalone Server environment, this menu will be available right away when you navigate to the Resources section. In a Cluster environment, the menu is available in a node detail view after clicking on a specific node in the node list. In the Actions menu, the following operations can be performed:

    1. Starting worker

    If the worker process is not running, you can use the Start worker option to start it back up.

    2. Restarting worker

    Depending on if you want to let the currently running jobs finish first select one of the options:

    • Finish jobs and restart worker will wait for all currently running jobs to finish before restarting the worker.

    • Restart worker now will forcibly kill all currently running jobs and restart the worker immediately.

    3. Displaying worker log

    The Go to worker logs option will redirect you to the Server Logs section under Monitoring and display the latest information in the worker log. For more information about server logs see Server logs.

    4. Showing worker command line arguments

    By selecting the Show worker command line option, the command line arguments and parameters used by the worker will be displayed.

    5. Suspending server core

    When a Server core is suspended, features like Schedulers, Event Listeners, or Data Apps will be disabled. Manual execution of graphs, jobflows, and tasks is still possible with explicit confirmation. Depending on if you want to let the currently running jobs finish first, select one of the options:

    • Suspend server core will wait for all currently running jobs to finish before stopping the server core.

    • Force suspend server core will forcibly kill all currently running jobs and stop the core immediately.

    6. Resuming server core

    To resume a suspended Server core use the Resume server core option.

    7. Restoring Dismissed Warnings

    CloverDX Server shows warnings if it detects possible issues with the state of the Server or its configuration (e.g., when the Server is under heavy load a warning will appear in the Resources section, or when worker heap memory is not set, a warning will appear under Configuration > Setup > Worker). If you do not consider these warnings to be an issue, you can dismiss them by clicking on the X button at the end of the warning. Dismissing messages dismisses them for all users. Messages regarding worker configuration get renewed after changing its configuration and after restarting the worker. Messages regarding the Server Core are renewed after the restart of the Server.

    Dismissed warning messages can be restored by using the Show dismissed warnings option.

    dismissable message
    Figure 96. Dismissible warning message
    8. Displaying / hiding additional debug information

    To display additional debug information, e.g., a detailed overview of memory utilized by CloverDX Server, or a list of threads used by the core, use the Show Details option. After clicking on this option, the debug information will appear at the bottom of the page under the Performance section. To see what panels will appear when using this option, refer here. To hide the debug information use the Hide details option.

    9. Disabling / enabling of automatic refresh

    By default, the information in the Resources section is refreshed automatically every 10 seconds. If you do not want the information to be refreshed, use the Stop refreshing option. To enable it again, use the Start refreshing option.