DataSource monitoring configuration (part 2)

Here are the rest of the DataSource configuration items that determine who can monitor and manage a DataSource application through JMX, and what objects can be monitored and managed.

For more DataSource monitoring configuration items, see DataSource monitoring configuration (part 1).

Contents:

jmxcache-hash-size

jmxcache-hash-size specifies the size of the hash table needed by this DataSource application's JMX module. The value should be about twice the total number of mbeans that the application will create.

Use in: C

Syntax: jmxcache-hash-size <hash-table-size>

Type: integer

Default value: 100000

log-monitor-level

log-monitor-level specifies the threshold at which log messages about a DataSource application's events and errors are published to the monitoring subsystem, to be viewed by a monitoring client such as the Caplin Management Console.

You can override this setting for the Event log only  by specifying the monitor-level option of the add-log configuration item.

Use in: C

Syntax: log-monitor-level <log-level-name>

Type: string

Default value: INFO

Values accepted:

LEVEL DESCRIPTION
FINEST Reports highly detailed tracing messages.
FINER Reports fairly detailed tracing messages.
DEBUG Sends all errors and events.
INFO Sends events and information regarding normal operation and all errors included in the WARN, NOTIFY, ERROR and CRIT debug levels.
WARN Sends minor errors and all errors included in the NOTIFY, ERROR and CRIT debug levels.
NOTIFY Sends errors regarding data corruptions and all errors included in the ERROR and CRIT debug levels.
ERROR Sends serious errors regarding network connections and all errors included in the CRIT debug level.
CRIT Sends critical errors that prevent the DataSource application from running.

monitor-module

monitor-module defines the monitoring module that is to be loaded into the DataSource application.

You only need to use this configuration item if you're writing your own DataSource application (such as a C-based Integration Adapter). For Liberator and Transformer, this configuration is predefined in the JMX Config blade that comes with these components.

Use in: C

Syntax: monitor-module jmx

monitor-moddir

monitor-moddir defines the directory where the DataSource application's JMX monitoring module is located.

You only need to configure this if you're writing your own DataSource application (such as an Integration Adapter). For Liberator and Transformer, this configuration is predefined in the JMX Config blade that comes with these components.

Use in: C

Syntax: monitor-moddir DIRECTORY

If the first two characters of DIRECTORY are %r, the directory is prefixed with the the root directory (application-root) of the DataSource application installation; for example /liberator/lib or /myadapter/lib

Type: string

Default value: %r/lib

object-latency-stat-period

object-latency-stat-period defines the period, in seconds, over which latency statistics are calculated for viewing via an object's latency-chain MBean attribute. At the end of this period, the data is reset and the calculation (averaging) starts again.

For more about the latency-chain MBean and how to view it, see How can I... Monitor latency statistics using the CMC.

Use in: C

Syntax: object-latency-stat-period <interval-in-seconds>

Type: integer

Default value: 300 seconds (5 minutes)

object-monitoring-interval

object-monitoring-interval defines the time interval in seconds at which Liberator monitors the state of its objects.

To disable object monitoring, set this item to -1.0 (the default).

Use in: C (Liberator only)

Syntax: object-monitoring-interval <interval-in-seconds>

Type: float

Default value: -1.0

session-monitoring-interval

session-monitoring-interval defines the time interval in seconds at which Liberator monitors the state of its sessions.

To disable session monitoring, set this item to -1.0 (the default).

Use in: C (Liberator only)

Syntax: session-monitoring-interval <interval-in-seconds>

Type: float

Default value: -1.0

process-usage-period

process-usage-period defines the time interval in seconds at which the DataSource application’s CPU time counters user-cputime-total and system-cputime-total are updated. These counters can be viewed through JMX monitoring. If you're using the Caplin Management Console, you can see them in the Explorer tab under rttpd.server.system

Use in: C

Syntax: process-usage-period <interval-in-seconds>

Type: float

Default value: 10 seconds.

rmi-client-port

rmi-client-port defines the port in this DataSource application that a JMX-enabled monitoring client, such as the Caplin Management Console, connects to. 

Alternatively, you can define this port in the DataSource application's jvm-options configuration, as follows:

jvm-options -Drmi.client.port 

Only define the port once, using either rmi-client-port or jvm-options.

Tip: You should normally set the rmi-client-port value one higher than the value of rmi-registry-port.

In the Caplin Platform Deployment Framework, configuration macros are used to specify rmi-client-port for Liberator and Transformer; for example, LIBERATOR${THIS_LEG}_JMX_RMI_CLIENT_PORT. See Configuration macros and items.

Use in: C, Java

Syntax: rmi-client-port <port-number>

Type: integer

Default value: -1 (no port defined)

rmi-registry-port

rmi-registry-port defines a port in this DataSource application that a JMX-enabled monitoring client, such as the Caplin Management Console, uses to obtain monitored data. (It's the port that's used after the initial monitoring connection has been established to the port defined by rmi-client-port). The registry port must be unique across all the DataSource applications executing on the same physical machine. So, when you implement an Integration Adapter, make sure its rmi-registry-port value is different to the settings used by Liberator and Transformer.

Alternatively, you can define this port in the DataSource application's jvm-options configuration, as follows:

jvm-options -Drmi.registry.port

Only define the port once, using either rmi-registry-port or jvm-options.

In the Caplin Platform Deployment Framework, configuration macros are used to specify rmi-registry-port for Liberator and Transformer; for example, LIBERATOR${THIS_LEG}_JMX_RMI_REGISTRY_PORT. See Configuration macros and items.

Use in: C, Java

Syntax: rmi-registry-port <port-number>

Type: integer

Default value: -1 (no port defined)


See also: