# 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).

## 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 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`.

 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)