Prometheus#
This section provides information about Prometheus and the exporters available in Carbonio, that are used to fetch information from log files, Carbonio nodes, and metrics exposed by Carbonio services.
Introduction and Architecture#
Prometheus is a time-series database that stores all the information about the historical data of Carbonio, allowing Administrators to obtain a view and evolution of the system.
The monitoring functionality in Carbonio is realized thanks to these main tools:
- Prometheus Server
-
The main Prometheus server, which processes log files and metrics to stores time-series data.
- Node Exporter
-
The main exporter, installed on every Node of the Carbonio infrastructure, which gathers the metrics exposed by the hardware and Operating System.
- Specialised Exporters
-
These are special-purpose exporters, responsible to collect data and metrics from a given service running on Carbonio.
Dependencies#
The Node Exporter component is automatically installed with the
carbonio-core
package.
To make sure that the correct Exporter in installed along the service
from which it fetches data, when a Role in installed, the
corresponding Prometheus Exporter is installed. For example, when the
Proxy Role is installed, the
carbonio-prometheus-nginx-exporter
package is installed as well:
no additional installation activity is therefore necessary.
The list of available exporters, including some additional information, is shown in Table 7
Exporter |
Role |
Port |
---|---|---|
carbonio-prometheus-consul-exporter |
Mesh and Directory |
9107 |
carbonio-prometheus-openldap-exporter |
Mesh and Directory |
9330 |
carbonio-prometheus-mysqld-exporter |
Mailstore & Provisioning |
9104 |
carbonio-prometheus-nginx-exporter |
Proxy |
9113 |
carbonio-prometheus-node-exporter |
Every Carbonio node |
9100 |
carbonio-prometheus-postgres-exporter |
Database |
9187 |
carbonio-prometheus-process-exporter |
As desired [1] |
9256 |
carbonio-prometheus-clamav-exporter |
MTA AV/AS |
9810 |
carbonio-prometheus-pgpool-exporter |
Database connector [2] |
9719 |
Grafana Dashboards#
The data gathered by the Exporters and stored in Prometheus Server is used to create predefined dashboards to show in real-time the situation of a service or of the system and its evolution.
The list of available Grafana Dashboards and the procedure to install them can be found in Section Import Dashboards.