System Properties
FusionReactor has a number of system properties that can be set to configure FusionReactor.
These arguments should be added to your JVM configuration.
Learn more
Note
The options below should be prefixed with '-D', for example:
Agent Authentication
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fradminpassword |
Not defined | password value | 6.0.0 | Sets default/starting admin password. |
frmanagerpassword |
Not defined | password value | 10.0.0 | Sets default/starting manager password. This enables the manager user role. |
frobserverpassword |
Not defined | password value | 10.0.0 | Sets default/starting observer password. This enables the observer role. |
Applications and Transactions
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.application.name |
MyApplication | 6.0.0 | Defines the Default Application Name. If auto application naming is disabled this system property will define the application name for the entire application. |
fr.application.auto_naming |
true | 6.0.0. | When true, FusionReactor will name the application automatically by searching various sources (e.g. Servlet Config). |
fr.transaction.name |
Ungrouped | 6.0.0 | Defines the Default Transaction Name. If auto transaction naming is disabled this system property will define the transaction name for all transactions. |
fr.transaction.auto_naming |
true | 6.0.0 | When true, FusionReactor will name the transaction automatically by searching various sources (e.g. Servlet Config). |
fr.thread.allocated.memory.enabled |
true | 7.0.0 | Allows all the thread allocated memory information to be turned off. |
fr.transaction.http.client.header.request.count |
15 | 8.1.0 | Defines the number of request headers stored on the HTTP Client transaction. |
fr.transaction.http.client.header.response.count |
15 | 8.1.0 | Defines the number of response headers stored on the HTTP Client transaction. |
ColdFusion Metrics
Warning
Enabling these ColdFusion metrics for ColdFusion (2018 and later) may incur performance issues and be unsafe. User issues reported include memory leaks and server slowdown.
Tip
We recommend testing in a staging environment before deploying these changes to production.
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.coldfusion.monitor.request.enabled |
false |
true/false | 9.2.2 | Enables monitoring request hitcounts and some request metrics. Disabled if PMT is active. |
fr.coldfusion.monitor.memory.enabled |
false |
true/false | 9.2.2 | Enables memory monitoring for scopes size. |
fr.coldfusion.monitor.query.enabled |
false |
true/false | 9.2.2 | Enables monitoring cached queries in CF metrics for CF 2021 |
fr.coldfusion.monitor.query.app.enabled |
false |
true/false | 9.2.2 | Enables monitoring cached queries per app/server. Requires monitor.query.enabled=true |
Decompilation
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.decompile.external.enabled |
false | true/false | 6.0.0 | This enables or disables the decompilation when requests come in over the external J2EE connection. |
fr.decompile.show.line.numbers |
false | true/false | 6.0.0 | This setting enables the procyon line number as comments inside the decompile output. This is very good to track down line number issues in decompiled code. |
Enterprise Dashboard/Ephemeral Data Service
{!Common/ED_Sys_Props!}
FusionReactor Cloud
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.cloud.group |
Not defined | Comma-separated list | 6.1.0 | Specifies the group your FusionReactor instance will register to in the cloud. |
| Additionally all metrics, logs and traces will be appened with the group label. | ||||
fr.gcs.client.obfuscate.data |
true | true/false | 6.0.0 | Obfuscates TXN details over the live data tunnel. |
FusionReactor Logging
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.observability.log.enabled |
true | true/false | 9.0.0 | This setting enables or disables logs shipping. |
JMS/MDB Tracking
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.pointcut.jms.packages |
org/apache/activemq/ |
comma-separated list of package prefixes with / replacing . |
10.0.0 | List of package prefixes to enable JMS tracking within those packages. Accepts all to enable tracking within all packages. |
fr.observability.trace.jms.jakarta |
false | true/false | 10.0.0 | If true, uses the jakarta.jms libraries. Uses javax.jms otherwise. |
fr.observability.trace.jms.extra_attributes.enabled |
true | true/false | 10.0.0 | If enabled, attempts to set the messageId and conversationId. |
Licensing
| Property | Default value | Version added | Description |
|---|---|---|---|
frlicense |
Not defined | 5.0.0 | This system property will allow you to specify your license key for the instance, making it non-modifiable from within the UI. |
fr.odl.env.regex |
(?i).sudo. | 8.0.0 | Removes values matching the regex from the env secton of license message. |
fr.odl.prop.regex |
(?i).sudo. | 8.0.0 | Removes values matching the regex from the -D properties secton of license message. |
fr.license.hostname.lookup |
true | 8.6.0 | Enable all getHostName() calls in network data provider. This triggers reverse DNS and can be very slow (especially on macOS) |
Logging Level
| Property | Default value | Version added | Description |
|---|---|---|---|
_FR_DEBUG |
Not defined | 1.0.0 | Enable debugging logging for FusionReactor. This causes FusionReactor to generate a vast ammount of logs. |
Network Proxy
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.http.proxyHost |
Not defined | 6.2.0 | The hostname or IP address of the proxy that you want to connect to. |
fr.http.proxyPort |
Not defined | 6.2.0 | Proxy server port number for connection. |
fr.http.proxyUser |
Not defined | 6.2.0 | The username required for your proxys authentication configuration. |
fr.http.proxyPassword |
Not defined | 6.2.0 | The password required for your proxys authentication configuration. |
fr.http.proxyAuthType |
Not defined | 6.2.0 | The authentication type to be used for authentication with your proxy. Values include: "None" "Basic" OR "Digest", "NTLM". |
Observability Labels
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.observability.labels |
Not defined | 9.2.0 | A comma-separated key-value list of labels to add to all observability types.Format labelKey1:labelValue1,labelKey2:labelValue2,... Applies to all metrics, logs and traces generated by FusionReactor. |
fr.deployment.environment.name |
Not Defined | 2026.1.0 | Sets the deployment.environment.name resource attribute. |
fr.service.version |
Not Defined` | 2026.1.0 | Sets the service.version resource attribute. |
fr.observability.otel.resource.enabled |
false |
2026.1.0 | Allows user resource to stomp over FR configured resource. Use with -Dotel.resource.attributes, -Dotel.service.name etc. |
fr.observability.otel.namespace.enabled |
false |
2026.1.0 | If true, and cloud group is present, set cloud group as service.namespace attribute. This can change the job label value in Prometheus/Mimir |
fr.observability.otel.instance_id.enabled |
false |
2026.1.0 | If true, adds the client ID as service.instance.id label within resource. Seems to override normal instance label in Mimir. |
Observability Logs
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.observability.log.enabled |
true | 9.0.0 | Enable/disable logs shipping. |
fr.observability.log.labels |
Not defined | 9.0.0 | A comma-separated key-value list of labels to add a maximum of 8 (by default) to logs. Format labelKey1:labelValue1,labelKey2:labelValue2,... |
fr.observability.log.scrape.path |
Not defined | 9.1.0 | Set the path(s) for the log scraper. Format /{directory}/*.log,/{directory}/*.txt |
fr.observability.log.send.level |
INFO | 12.1.0 | Sets the minimum log level to send/ship to cloud. Case-insensitive. Also available as an evironment variable FR_OBSERVABILITY_LOG_SEND_LEVEL. One of ALL, FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, OFF. |
Observability Metrics
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.observability.metric.labels |
Not defined | 9.2.0 | A comma-separated key-value list of labels to add a maximum of 8 (by default) to metrics. Format labelKey1:labelValue1,labelKey2:labelValue2,... |
fr.observability.metric.otel.requests.enabled |
true |
2026.1.0 | If true, requests will be recorded as histogram metrics. |
fr.observability.metric.otel.requests.server.enabled |
true |
2026.1.1 | If true, HTTP server requests will be recorded as histogram metrics. |
fr.observability.metric.otel.requests.client.enabled |
true |
2026.1.1 | If true, HTTP client requests will be recorded as histogram metrics. |
fr.observability.metric.otel.requests.database.enabled |
true |
2026.1.1 | If true, database requests will be recorded as histogram metrics. |
fr.observability.metric.otel.requests.messaging.enabled |
true |
2026.1.1 | If true, messaging requests will be recorded as histogram metrics. |
fr.observability.metric.otel.requests.server.attributes.high_cardinality.enabled |
false |
2026.1.1 | If true, HTTP server request metrics will include high cardinality attributes. |
fr.observability.metric.otel.requests.database.attributes.high_cardinality.enabled |
false |
2026.1.1 | If true, database request metrics will include high cardinality attributes. |
fr.observability.metric.otel.requests.messaging.attributes.high_cardinality.enabled |
false |
2026.1.1 | If true, messaging request metrics will include high cardinality attributes. |
fr.observability.metric.fr.jvm.enabled |
true |
2026.1.0 | If true, enables FR JVM metrics that overlap with Prometheus JVM metrics. |
fr.observability.metric.otel.jvm.enabled |
true |
2026.1.0 | If true, enables OTel JVM metrics. |
fr.observability.metric.prometheus.jvm.enabled |
false |
2026.1.0 | If true, enables Prometheus JVM metrics. Some metrics have same name as FR. |
fr.observability.metric.cf.dbpool.enabled |
true |
2026.1.0 | If true, enables CF DB Pool metrics in cloud. |
fr.observability.metric.names |
fr |
2026.1.0 | Sets which metric name and recording strategy to take. fr (default) for unchanged (1 min avg recording), otel for different names and records last/latest value (where implemented/possible), all,otel/fr,fr/otel for both. |
fr.observability.metric.capture_gc_cause |
false |
2026.1.0 | If true, and OTel metrics/names enabled, records cause of garbage collection on jvm.gc.duration metric as jvm.gc.cause |
Observability Traces
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.observability.trace.enabled |
true | 9.2.0 | Enable/disable traces shipping. |
fr.observability.trace.labels |
Not defined | 9.2.0 | A comma-separated key-value list of labels to add a maximum of 8 (by default) to traces. Format labelKey1:labelValue1,labelKey2:labelValue2,... |
fr.observability.trace.sampling.ratio |
0.05 | 9.2.0 | The ration of tracked transactions that are shipped to the cloud. A sample rate of 1.0 would ship 100% of tracked transactions. |
fr.observability.trace.itt.txn.max |
10 | 9.2.0 | Max number of ITTs to process as spans within each 60 seconds time window. |
fr.observability.trace.attributes.semantics.obfuscation.enabled |
false | 9.2.0 | If enabled, obfuscates the span attributes: net.peer.port net.peer.name net.peer.ip db.statement 'query string in http.url http.client_ip |
fr.observability.trace.span.child.limit |
100 | 9.2.0 | Max number of child spans allowed on a span. |
fr.observability.trace.value.limit |
1024 | 9.2.0 | Text limit for certain span string attributes. Anything after this chartacter limit will be replaced with '...' |
fr.observability.trace.attributes.route.query_params |
Not Defined | 2026.1.0 | Comma-separated list of case-insensitive query param keys to append to the route attribute. all appends the whole query string. Default is to append no part of the query string. Can be used to query request/span metrics by query string. |
Plugins
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.plugin.reports.notifications.email.disabled |
false | true/false | 10.0.0 | If true, forces the email notifications to be disabled in the reporting plugin. |
Production Debugger
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.jvmti.enable.exceptions |
true (false for CF 10+) | 6.2.5 | Enables exception break point support in the debugger. This can have negative impact on CFML compilation times and code which throws lots of exceptions. |
fr.jvmti.enable.fast.stepping |
false | 6.2.5 | Enables fast stepping mode which ensures that stepping operations execute as quickly as possible. This can have a negative impact on the JVM's performance. |
fr.jvmti.email.max.variables.count |
MAX_INTEGER | 6.0.0 | The maximum string length a variable value can be in the email. This reduces the data in case of very large toString() values like lists and json objects. |
fr.jvmti.email.max.variables.length |
100 | 6.0.0 | The maximum string length a variable value can be in the email. This reduces the data in case of very large toString() values like lists and json objects. |
Startup
| Property | Default value | Version added | Description |
|---|---|---|---|
frstartupinline |
Not Defined | 5.0.0 | When defined, FusionReactor will start before the JVM/Application server. |
frstartupdelay |
1000 | 5.0.0 | The amount of time that FusionReactor sleeps before starting. |
Support Chat
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
fr.chat.enabled |
true | true/false | 7.0.0 | Enables the support chat. |
UI
| Property | Default value | Values accepted | Version added | Description |
|---|---|---|---|---|
frhomepage |
Not defined | page ID | 10.0.0 | Sets home page for all users without changing config. Set to the value of the page_id. e.g {fusionreactor_url}?p={page_id}. |
fr.request.obfuscate.parameters |
false | true/false | 6.2.6 | This enables/disables obfuscation for master transaction parameters. |
fr.request.obfuscate.file |
Not defined | - | 6.3 | Sets the file path for obfuscation values. |
fr.request.obfuscate.variable |
Not defined | - | 6.3 | Sets specific variable names which should be obfuscated. |
fr.request.obfuscate.ip |
false | true/false | 7.3.0 | Replaces any numbers in the Request IPs with 0's. |
fr.transactionsummary.showheaders.disabled |
false | true/false | 8.7.5 | Disables the ability to show headers on request/transaction summaries. |
fr.transactionsummary.showheaders.request.disabled |
false | true/false | 8.7.5 | Disables the ability to show request headers on request/transaction summaries. |
fr.transactionsummary.showheaders.response.disabled |
false | true/false | 8.7.5 | Disables the ability to show response headers on request/transaction summaries. |
Weblogic
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.weblogic.fixup.active=true |
false | 5.2.0 | Allows Weblogic transactions to be tracked. This must be enabled if FusionReactor is running on Weblogic. |
fr.jdbc.skip_get_connection_parser |
false | 12.1.0 | Can prevent blocked threads when using JDBC but reduces monitoring capability. |
fr.jdbc.connection_parser_type |
MySQL | 12.1.0 | When -Dfr.jdbc.skip_get_connection_parser=true, will attempt to parse the connection as the given database type. Currently, only oracle and mysql are supported. |
FR Cloud UI Tunnel
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.ui.ws.enabled |
true | 12.1.0 | Enable/disable the websocket tunnel. |
Federated Identity Management
| Property | Default value | Version added | Description |
|---|---|---|---|
fr.fim.cloud.enabled |
true | 12.1.0 | If disabled, users will no longer be able to log in with their cloud email address and password. |
Lucee
| Property | Default value | Version added | Description |
|---|---|---|---|
| fr.lucee.exception.request.enabled | true | 2026.1.0 | If true, captures Lucee request execution exceptions on transactions |
| fr.lucee.exception.request.extra.enabled | true | 2026.1.0 | If false, forcefully disables capturing Lucee template stack trace on errors |
| fr.lucee.exception.request.extra.max_frames | 10 | 2026.1.0 | The maximum number of Lucee template stack trace frames to capture on errors |
| fr.lucee.debugger.fullfilename.enabled | true | 2026.1.0 | If true, adds file path to Lucee classes for the debugger to match to correct source. |
Need more help?
Contact support in the chat bubble and let us know how we can assist.