Skip to content

FusionReactor Agent Metrics

The FusionReactor Agent Metrics page provides a comprehensive reference for all metrics collected by the FusionReactor agent across application, JVM, request, and cloud infrastructure layers. These metrics are essential for performance monitoring, alerting, and anomaly detection in both traditional and cloud-native environments.

Metrics are grouped into categories based on the type of data they represent (e.g., CPU, memory, disk, transactions), and each entry includes a description and unit of measurement. Many of these metrics are designed to support real-time observability and are commonly used to configure alerts and build custom dashboards.

Use this reference to:

  • Understand what each metric represents
  • Identify which metrics are alertable
  • Configure meaningful dashboards and threshold-based alerts

Understanding metric labels

All FusionReactor Agent metrics include a standard set of default labels. These provide important context and make it easier to filter, group, and analyze data in cloud or containerized environments.

Default labels (applied to all metrics):

  • client_id
  • container_id
  • docker
  • fusionreactor
  • group
  • instance
  • job

These labels are automatically attached to each metric and do not need to be configured manually.

Some metrics also include additional labels to provide more specific context. For example:

  • jvm_threads_state includes a state label (e.g. RUNNABLE, WAITING, BLOCKED).
  • fr_cf_requests_throughput_error_time may include status to distinguish between successful vs. failed requests (e.g., 200, 404, 500) and type to categorize request origin or type — such as api, static, internal, etc.

When extra labels are used, they are shown in the Labels column of the tables below. If a metric only uses the default labels, this is marked as Default.

Metrics

Service uptime & Instance info

Name Description Labels Unit
up Indicates the instance is up. Labels
fusionreactor_build_info FusionReactor build info. Labels
fr_server_info FusionReactor server info. Labels
fusionreactor_license_info FusionReactor license info. Labels

CPU usage

Metric Name Description Labels Unit
process_cpu_usage CPU utilization (%) of the instance across all cores Default %
process_cpu_total_usage Total CPU utilization (%) across all cores and all processes Default %

Memory usage

Metric Name Description Labels Unit
jvm_memory_pool_bytes_committed Committed memory per memory pool Labels MiB
jvm_memory_pool_bytes_max Maximum memory per memory pool Labels MiB
jvm_memory_pool_bytes_used Used memory per memory pool Labels MiB
jvm_memory_pool_bytes_total Total memory pool size Labels MiB
jvm_memory_bytes_committed Committed memory Labels MiB
jvm_memory_bytes_max Maximum available memory Labels MiB
jvm_memory_bytes_used Used memory Labels MiB
jvm_memory_bytes_used_percent Percentage of memory used Labels %
jvm_memory_bytes_committed_percent Percentage of memory committed Labels %
jvm_gc_collection_seconds Time spent in GC, per GC type Labels ms/s
jvm_gc_collection_calls Number of GC invocations, per GC type Labels GC/s

Thread & Class activity

Metric Name Description Labels Unit
jvm_threads_current Number of live JVM threads Default
jvm_threads_state JVM threads by state Labels
jvm_classes_loaded Count of classes loaded in the JVM Default
jvm_classes_unloaded Count of classes unloaded from the JVM Default
jvm_classes_loaded_total Cumulative total of loaded classes Default

Application

Metric Name Description Labels Unit
app_database_throughput Per-application average duration (ms) of database transactions over the past minute. Labels ms
app_database_throughput_cnt Per-application count of database transactions over the past minute. Labels
app_database_throughput_sum The application's total database transaction duration (in ms) for the last minute. Labels ms
app_database_error Per-application average duration (ms) of database error transactions over the past minute. Labels ms
app_database_error_cnt Per-application count of database error transactions over the past minute. Labels
app_database_error_sum Per-application total duration (ms) of database error transactions over the past minute. Labels ms
app_cpu Per-application total CPU time (ms) over the past minute. Labels ms
app_cpu_cnt Per-application total CPU time (ms) over the past minute. (Count) Labels
app_cpu_sum Per-application total CPU time (ms) over the past minute. (Sum) Labels ms
app_memory Per-application total memory usage (bytes) over the past minute. Labels bytes
app_memory_cnt Per-application total memory usage (bytes) over the past minute. (Count) Labels
app_memory_sum Per-application total memory usage (bytes) over the past minute. (Sum) Labels bytes
app_client_error_count Per-application average duration (ms) of WebRequest 4xx responses over the past minute. Labels ms
app_client_error_count_cnt Per-application count of WebRequest 4xx responses over the past minute. Labels
app_client_error_count_sum Per-application total duration (ms) of WebRequest 4xx responses over the past minute. Labels ms
app_server_error_count Per-application average duration (ms) of WebRequest 5xx responses over the past minute. Labels ms
app_server_error_count_cnt Per-application count of WebRequest 5xx responses over the past minute. Labels
app_server_error_count_sum Per-application total duration (ms) of WebRequest 5xx responses over the past minute. Labels ms
app_WebRequest Per-application average duration (ms) of WebRequest transactions over the past minute. Labels ms
app_WebRequest_cnt Per-application count of WebRequest transactions over the past minute. Labels
app_WebRequest_sum Per-application total duration (ms) of WebRequest transactions over the past minute. Labels ms
app_up Indicates the application was active in the past minute. Labels
app_error_count Per-application total errors over the last minute. Labels
app_error_count_cnt Per-application total errors over the last minute. (Count) Labels
app_error_count_sum Per-application total errors over the last minute. (Sum) Labels
app_throughput Per-application average duration (ms) of master transactions over the past minute. Labels ms
app_throughput_cnt Per-application count of master transactions over the past minute. Labels
app_throughput_sum Per-application total duration (ms) of master transactions over the past minute. Labels ms
app_txn_error_count Per-transaction total errors over the last minute. Labels
app_txn_error_count_cnt Per-transaction total errors over the last minute. (Count) Labels
app_txn_error_count_sum Per-transaction total errors over the last minute. (Sum) Labels
app_txn_throughput Per-transaction average duration (ms) of master transactions over the past minute. Labels ms
app_txn_throughput_cnt Per-transaction count of master transactions over the past minute. Labels
app_txn_throughput_sum Per-transaction total duration (ms) of master transactions over the past minute. Labels ms

Transactions

Metric Name Description Labels Unit
txn_active_activity Number of active transactions per second, per-flavor, 1-min avg. Labels
txn_active_activity_cnt Number of samples taken for the base metric over the past minute. Labels
txn_active_activity_sum Total sum of values from all samples for the base metric over the past minute. Labels
txn_active_time Avg. duration of active transactions per second (ms), per-flavor, 1-min avg. Labels ms/s
txn_active_time_cnt Number of samples taken for the base metric over the past minute. Labels
txn_active_time_sum Total sum of values from all samples for the base metric over the past minute. Labels
txn_error_activity Number of transactions with errors per second, per-flavor, 1-min avg. Labels
txn_error_activity_cnt Number of samples taken for the base metric over the past minute. Labels
txn_error_activity_sum Total sum of values from all samples for the base metric over the past minute. Labels
txn_error_time Avg. duration of transactions with errors per second (ms), per-flavor, 1-min avg. Labels ms/s
txn_error_time_cnt Number of samples taken for the base metric over the past minute. Labels
txn_error_time_sum Total sum of values from all samples for the base metric over the past minute. Labels
txn_history_activity Number of completed transactions per second, per-flavor, 1-min avg. Labels
txn_history_activity_cnt Number of samples taken for the base metric over the past minute. Labels
txn_history_activity_sum Total sum of values from all samples for the base metric over the past minute. Labels
txn_history_time Avg. duration of completed transactions per second (ms), per-flavor, 1-min avg. Labels ms/s
txn_history_time_cnt Number of samples taken for the base metric over the past minute. Labels
txn_history_time_sum Total sum of values from all samples for the base metric over the past minute. Labels

System

Metric Name Description Labels Unit
fr_filesystem_transmitted_bytes Data transmitted since boot (per network device) Labels B
fr_filesystem_received_bytes Data received since boot (per network device) Labels B
fr_filesystem_read_bytes_total Total disk read since boot Labels B
fr_filesystem_write_bytes_total Total disk write since boot Labels B
fr_filesystem_avail_bytes Available disk space Labels B
fr_filesystem_total_bytes Total disk space Labels B
fr_filesystem_used_bytes Used disk space Labels B
fr_system_cpu_seconds_total Cumulative CPU seconds by system, per-CPU-category Labels s
fr_cf_system_cached_queries ColdFusion cached query count, 1-min avg. Default count
fr_cf_system_cached_templates ColdFusion template cache count, Default count
fr_cf_system_template_cache_hit_ratio ColdFusion template cache hit ratio, 1- Default ratio (%)
fr_cf_system_throttled_memory ColdFusion total throttle memory used, 1-min avg. Default bytes
fr_cf_system_throttled_queue_size ColdFusion throttle queue size, 1-m Default count
fr_cf_system_concurrent_users ColdFusion concurrent user count, 1- Default count
fr_cf_system_cf_thread_throughput ColdFusion thread count per 5 seconds, per-thread-status, 1-min avg Labels count/5s
fr_cf_system_scopes_size_kilobytes ColdFusion cache/scope size (KB), per-cache/scope, 1-min avg. Labels kilobytes
fr_cf_requests_throughput ColdFusion request count per 5 seconds, per-request-type and per-request-status, 1-min avg. Labels count/5s

Sessions

Metric Name Description Unit Labels
sessions_created_total Total number of sessions created Default
sessions_active_total Total number of active sessions Default
sessions_rejected_total Total number of rejected sessions Default
sessions_destryed_total Total number of sessions destroyed, 1-min avg. Default

Coldfusion Metrics

Metric Name Description Unit Labels
fr_cf_hitcounts_total Total ColdFusion template hits Labels
fr_cf_system_cached_templates ColdFusion cached template count Default

Labels

Labels are key-value pairs attached to metrics that provide additional context. They help distinguish between different dimensions of the same metric, such as the source, type, or environment. Labels are essential for querying, filtering, grouping, and visualizing metric data effectively.

app_database_throughput / app_database_error

Name Description Example More info
app_name Application Name JSP Test App
database The database by name DerbyMemoryDB
table Database table company_d
action Database action insert

app_cpu / app_memory

Name Description Example More info
app_name Application Name JSP Test App

app_client_error_count / app_server_error_count

Name Description Example More info
app_name Application Name JSP Test App

app_WebRequest

Name Description Example More info
app_name Application Name JSP Test App
status Status code Not present on status code

app_up / app_error_count / app_throughput

Name Description Example More info
app_name Application Name JSP Test App

app_txn_error_count / app_txn_throughput

Name Description Example More Info
app_name Application Name JSP Test App
txn_name Transaction name controls.print_00… (truncated) max 2048 chars

fusionreactor_build_info

Name Description Example More info
version FR version 12.1.1
build_no CI Build number 11408
branch Git branch name 12.1.1
revision Git commit hash c83b8bbf

fr_server_info

Name Description Example More info
java_runtime_name Java runtime name OpenJDK Runtime
java_runtime_version Java runtime ver 13.0.2+8
type Server type TOMCAT Can be UNKNOWN
home Server home /home/luke/app/fr Not present if not defined
version Server version 9.0.50
server_name Server name page UNKNOWN if not detected
engine ColdFusion engine
lucee_version Lucee version UNKNOWN if not detected
tomcat_version Tomcat version 9.0.93 Not present if not detected
coldfusion_version ColdFusion version CommandBox only
coldfusion_product_name ColdFusion prod ID CF only
coldfusion_build ColdFusion build 330808 CF only
coldfusion_major ColdFusion major 2023 CF only
coldfusion_minor ColdFusion minor 0 CF only
coldfusion_service ColdFusion service CF only
coldfusion_hotfix ColdFusion hotfix hf-2023-00010-3 CF only

fusionreactor_license_info

Name Description Example More info
type License type ULT
state License state active
cloud Is Cloud lic true

fr_cf_hitcounts_total

Name Description Example More info
type Hit count type One of: ref, web

fr_cf_system_cf_thread_throughput

Name Description Example More info
status CF thread status running

fr_cf_system_scopes_size_kilobytes

Name Description Example More info
scope CF scope type session_scope template_cache

fr_cf_requests_throughput

Name Description Example More info
status Request status running
type Request type web service

fr_system_cpu_seconds_total

Name Description Example More info
mode Category of CPU time nice

fr_network_received_bytes_total / fr_network_transmitted_bytes_total

Name Description Example More info
device Network device enp59s0f1

fr_filesystem_read_bytes_total

Name Description Example More info
device Disk name /dev/nvme0n1p1

jvm_gc_collection_seconds / jvm_gc_collection_calls

Name Description Example More info
gc GC type G1 Young Gen

jvm_threads_state

Name Description Example More info
state Thread state runnable

jvm_memory_pool_bytes_committed \ jvm_memory_pool_bytes_used \ jvm_memory_pool_bytes_max

Name Description Example More info
pool Memory space G1 Old Gen

jvm_memory_bytes_used / jvm_memory_bytes_committed / jvm_memory_bytes_ma / jvm_memory_bytes_used_percentage / jvm_memory_bytes_committed_percentage

Name Description Example More info
area Memory area heap

txn_activity / txn_history / txn_error

Name Description Example More info
flavor Transaction flavor WebRequest Can only be one of: WebRequest, CFML, REST, etc.

uem

Name Description Example More info
type UEM type wr

up

Name Description Example More info
start_ts Start time of the JVM in milliseconds 173838589214