41.8. Configuring Metrics and Log Collection for Cluster Nodes #
To monitor the health and performance of DBMS clusters, PPEM collects metrics and logs using pgpro-otel-collector, which must be installed on each server where cluster nodes are located.
After installation, you can configure the collector either manually by editing configuration files or directly through the web application. This section describes the interface-based configuration for clusters.
For instructions on configuring metrics and log collection for standalone instances, refer to Section 40.10.
Note
One pgpro-otel-collector instance collects metrics and logs only from one cluster node. If data collection parameters change, the manager entirely overwrites the collector configuration.
To configure metrics and log collection for a cluster:
In the navigation panel, go to Infrastructure → Clusters.
Click the name of the cluster.
In the navigation panel, go to Monitoring settings.
In the Collecting metrics and logs tile, click Configure.
In the Metrics section, specify parameters for metrics collection (parameters marked with an asterisk are required):
Collect OS metrics: Specifies whether to collect data from the operating system.
Collect nodes metrics: Specifies whether to collect data from the cluster nodes.
Metrics storage: The name of the metrics storage. It is recommended to use an external metrics storage.
Metrics storage URL: The network address for sending metrics. This address will be specified in the pgpro-otel-collector configuration file on the cluster nodes.
In the Logs section, specify parameters for log collection (parameters marked with an asterisk are required):
Collect logs: Specifies whether to collect logs from the cluster nodes.
Configure nodes: Specifies whether to enable advanced log configuration and restart options for the cluster nodes.
Restart nodes: Specifies whether the cluster nodes restart automatically (recommended) or manually after configuration. This parameter is available only if you select Yes for the Configure nodes parameter.
(Optional) Configure log collection parameters: This button is available only if you select Yes for Configure nodes parameter. Click it to edit the following parameters for log collection (these fields are automatically filled with default values):
Logging method: Specifies the logging format. Sets the
log_destinationparameter value. Currently, the logging format cannot be configured, its value is automatically set tocsvlog.Log catalog: Specifies the catalog where log files are created. Sets the
log_directoryparameter value.Name template for log files: Specifies log file names. The value is treated as a
strftimepattern. %-escapes are allowed to include date and time into the file names. Sets thelog_filenameparameter value.
Log storage: The name of the log storage. It is recommended to use an external log storage.
Log storage URL: The network address for sending logs. This address will be specified in the pgpro-otel-collector configuration file on the cluster nodes.
Click Apply.