Transformer Prometheus metrics

This page lists the Prometheus metrics published by Transformer.

Prometheus metrics are not published by default. To enable this feature, see Publishing DataSource metrics in Prometheus format.

This feature requires Transformer 8.0.0 or higher.

Contents:

Process metrics
DataSource peer metrics
Data service metrics

Process metrics

Transformer publishes the following metrics on the operating-system process that runs Transformer.

These metrics are only available on RHEL builds of Transformer.

process_cpu_seconds_total

Total user and system CPU time spent in seconds.

Type: Gauge

process_max_fds

The maximum number of file descriptors the process may have open (set by ulimit on Linux).

Type: Gauge

process_open_fds

Number of file descriptors the process has open.

Type: Gauge

process_resident_memory_bytes

Resident memory size in bytes.

Type: Gauge

process_start_time_seconds

Start time of the process (number of seconds since the start of the Unix epoch).

Type: Gauge

process_virtual_memory_bytes

Virtual memory size in bytes.

Type: Gauge

process_virtual_memory_max_bytes

Maximum amount of virtual memory available in bytes.

Type: Gauge

transformer_process_fds

Number of file descriptors the process has open.

Type: Gauge

Labels
	`type`	File descriptor type. Possible values: `non_socket_fds`, `socket_fds`

transformer_process_uptime_seconds_total

Process uptime in seconds.

Type: Counter

transformer_process_cputime_seconds_total

Process total CPU time in seconds.

Type: Counter

Labels
	`type`	CPU time type. Possible values: `user`, `system`

transformer_process_delayed_threads

Count of delayed threads that have been delayed for 5 seconds or more. Delayed threads are an indication that the DataSource is under high load or that threads have locked up.

Type: Gauge

transformer_process_cpu_usage_percentage

Average CPU percentage used by the DataSource process in the period configured by the configuration option process-usage-period (default 10 seconds).

Type: Gauge

DataSource peer metrics

Transformer publishes the following metrics on connected DataSource peers, where where appname is Transformer’s application name as defined by the application-name configuration item (defaults to transformer).

transformer_peer_global_bytes_read: [gauge] Total number of bytes read from all peer connections.
transformer_peer_global_bytes_read_rate: [gauge] The rate data is received (bytes/second) from all peer connections, measured over the sample period defined by peer-monitor-interval.
transformer_peer_global_bytes_written: [gauge] Total number of bytes written to peer connections.
transformer_peer_global_bytes_written_rate: [gauge] The rate data is written (bytes/second) to all peer connections, measured over the sample period defined by peer-monitor-interval.
transformer_peer_global_messages_read: [gauge] Total number of messages read from peer connections.
transformer_peer_global_messages_read_rate: [gauge] The rate messages are received (messages/second) from all peer connections, measured over the sample period defined by peer-monitor-interval.
transformer_peer_global_messages_written: [gauge] Total number of messages written to peer connections.
transformer_peer_global_messages_written_rate: [gauge] The rate messages are written (messages/second) to all peer connections, measured over the sample period defined by peer-monitor-interval.

Data service metrics

Transformer publishes the following metrics for each data service, where appname is Transformer’s application name as defined by application-name (defaults to transformer) and servicename is the name of the data service.

transformer_data_service_messages_read_total

The total number of messages read from a data service.

Type: Counter

Labels
	`service_name`	the data-service name
	`message_type`	the type of message received. Possible values: `update`, `map`, `nodata`

transformer_data_service_bytes_read_total

The total number of bytes read from a data service.

Type: Counter

Labels
	`service_name`	the data-service name

transformer_data_service_bytes_written_total

The total number of bytes written to a data service (contributions).

Type: Counter

Labels
	`service_name`	the data-service name

transformer_data_service_state

The state of a labelled data service. It has two possible values: 1 for up, 0 for down.

Type: Gauge

Labels
	`service_name`	the data-service name

transformer_data_service_subscriptions

The number of open subscriptions associated with a data service.

Type: Gauge

Labels
	`service_name`	the data-service name

transformer_data_service_response_time_milliseconds

The time taken for data services to respond to the first subscription request.

Type: Histogram

Labels
	`le`	the upper-bound of a histogram bucket. Possible values: `1.0`, `10.0`, `20.0`, `30.0`, `50.0`, `100.0`, `200.0`, `300.0`, `500.0`, `1000.0`, `+Inf`

See also: