# Monitoring

You can monitor and manage the Caplin Platform using log files, Prometheus metrics, and the Caplin Management Console.

## Prometheus metrics

**Functions:** monitoring

**Available from:** DataSource for C 7.1.16+ (Liberator 7.1.15+, Transformer 7.1.10+, TREP Adapter 7.1.3+), DataSource for Java 7.1.14+

All Caplin Platform components can publish metrics in the Prometheus text-based exposition format on a configured HTTP port ([prometheus-port](../datasource/datasource-datasource-monitoring-configuration-part-1.md#prometheus-port)).

Requirements:

* Enable the Prometheus metrics endpoint on each component. For instructions, see [Configure DataSource Prometheus monitoring](../datasource/datasource-configure-prometheus-monitoring.md).
* Configure the firewall on each component’s host to allow incoming traffic to the component’s prometheus port ([prometheus-port](../datasource/datasource-datasource-monitoring-configuration-part-1.md#prometheus-port)).
* Install a [Prometheus server](https://prometheus.io/) to consume and store the metrics published by Caplin Platform components
* Install a server to visualise data consumed by the Prometheus server, such as [Grafana](https://grafana.com/).

For a full list of metrics published by DataSource applications, see the links below:

* [DataSource Prometheus metrics reference](../datasource/datasource-prometheus-metrics.md)
* [Liberator Prometheus metrics reference](../liberator/liberator-prometheus-metrics.md)
* [Transformer Prometheus metrics reference](../transformer/transformer-prometheus-metrics.md)

## Caplin Management Console

**Functions:** monitoring, management

The [Caplin Management Console](../cmc/index.md) (CMC) is a Java desktop application that provides monitoring and management functionality in Caplin Platform deployments.

![CMC-Detail-Screen-Liberator_2](../../images/CMC-Detail-Screen-Liberator_2.png)

CMC connects over a Java RMI connection to Java Management Extensions ([JMX](https://www.oracle.com/java/technologies/javase/javamanagement.html)) monitoring beans (MBeans) in Caplin Platform components.

[NOTE] 
The JMX interface of Caplin Platform components is a JSR 160 JMX Remote API that can be accessed by other JMX clients, such as JConsole, at the following JMX service URL:

```
service:jmx:rmi:///jndi/rmi://<component_host>:<component_port>/datasrc
```

Requirements:

* Enable JMX on all Caplin Platform components. For instructions, see [Activating a component’s JMX interface](../cmc/activating-component-jmx-interface.md).
* Configure the firewall on each component’s host to allow incoming traffic on the component’s RMI registry port ([rmi-registry-port](../datasource/datasource-datasource-monitoring-configuration-part-1.md#rmi-registry-port)) and RMI client port ([rmi-client-port](../datasource/datasource-datasource-monitoring-configuration-part-1.md#rmi-client-port)).

### JMX attributes and operations

The two tables below highlight some of the JMX attributes and operations available in the CMC.

**Metrics and operations supported by all DataSource components**

| Area | JMX Attributes | JMX Operations |
| --- | --- | --- |
| System | Information related to the running process, such as CPU and memory usage, process id, and uptime. |  |
| Licence | Details of the current license |  |
| Logging | Access to log messages written to various log files | Control of logging levels and log file cycling. |
| Peers | Information about configured and connected DataSource peers. Statistics for all messages sent and received. | The ability to connect to peers and disconnect from them. The ability to fail-over to alternative peers. |

**Additional metrics and operations supported by Liberator**

| Area | JMX Attributes | JMX Operations |
| --- | --- | --- |
| System | Aggregated information about total number of sessions, objects, data throughput, and so on; and information about any configured clusters. |  |
| Users | Information about all connected users and their sessions, including latency and object subscription details | Ability to eject and revalidate users and cancel subscriptions. |
| Objects | Details about all objects in the system: their type, stale status, update times, subscription counts, and so on; and details of which sessions are viewing each object. |  |

For the full list of JMX attributes and operations supported by C DataSources, see the links below:

* [DataSource for C JMX MBeans reference](https://docs.caplin.com/developer/api/jmx/latest/beans/)
* [Liberator JMX MBeans reference](https://docs.caplin.com/developer/api/liberatorjmx/latest/beans/)
* [Transformer JMX MBeans reference](https://docs.caplin.com/developer/api/transformerjmx/latest/beans/)

---

**See also:**

* [Logging](logging.md)
* [DataSource monitoring and management](../datasource/datasource-datasource-monitoring-and-management.md)
* [Liberator monitoring and management](../liberator/liberator-monitoring-and-management.md)
