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.
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: