App Agent Node Properties (A)

This reference page contains information about app agent node properties. The properties are listed in alphabetical order.

adaptive-callgraph-granularity

This property enables adaptive snapshots. The call graph granularity for adaptive snapshots is based on the average response time for the business transaction during the last one minute and is thus adaptive. The following distribution is used:
  • Granularity of 10 ms for average response time of <= 10 seconds

  • 50 ms for 10 to 60 seconds

  • 100 ms for 60 to 600 seconds

  • 200 ms for > 600 seconds

Type Default value Platform(s)
Boolean false Java, .NET

ado-new-resolvers

Enable database detection and naming for ODP.NET backends labeled Unknown0.
Type Default value Platform(s)
Boolean true .NET

add-match-config-to-backend-identity

Property Name Description Default Value Type
add-match-config-to-backend-identity When set to true, backends that are consolidated into a single entity due to identical naming are split into separate entities if their configurations differ. This provides greater visibility and granularity for backends that share the same name but operate under different configurations. False Boolean

This property is useful in environments where multiple backend instances share the same name but are distinguished by specific configuration parameters. For example, you have two backend services named PaymentService, but one is configured with error policy and the other one is configured with a different retry policy. By default, Java Agent will consolidate these into a single PaymentService node. To distinguish these backends, add the add-match-config-to-backend-identity property to your node configuration and set it to True.

When enabled, the Java Agent evaluates the matched configurations. If the configurations differ, the agent reports them as distinct backends in the Controller UI, allowing it for independent monitoring and alerting for each specific configuration profile.

agentless-analytics-disabled

Disable agentless Transaction Analytics on a particular node or tier.
Type Default value Platform(s)
Boolean false Java,.NET

allow-delayed-log-metadata-enrichment

Property Name Description Default Value Type
allow-delayed-log-metadata-enrichment When set to true, the Java Agent injects log metadata across multiple classloaders, rather than restricting it solely to the classloader that initiated the transaction. This is particularly useful in complex environments where logging frameworks or application components are managed by different classloaders.. False Boolean

This property resolves issues where log correlation metadata is missing or incomplete in applications that utilize multiple classloaders. By default, the Java Agent only instruments the classloader that initiates the transaction. If the logging framework is loaded by a different classloader, the agent may fail to inject correlation IDs. To enable cross-classloader log metadata injection, add the allow-delayed-log-metadata-enrichment property to your node configuration and set it to True.

When enabled, the Java Agent extends its metadata injection logic to identify and instrument the appropriate classloaders. This ensures that log correlation IDs are correctly propagated and visible in your logging backend, regardless of which classloader initialized the transaction.

always-add-eum-metadata-in-http-headers

By default, the Java Agent, .NET Agent, and Node.js Agent set business transaction correlation data in a cookie for HTTP responses, except when the JavaScript Agent has already set an isAjax:true header in the request. When it finds the isAjax:true header, the agent sets the correlation metadata in the XHR header.

For cross-origin AJAX requests, the JavaScript Agent does not set isAjax:true so that the app agent doesn't write correlation data to the header of those responses.

Set always-add-eum-metadata-in-http-headers to true to configure the app agent to write business transaction metadata to the XHR header and in a cookie even if the request is considered cross-origin.

Type Default value Platform(s)
Boolean false Java, .NET, Node.js

analytics-sql-cpm-limit

This property specifies the per minute upper limit on the number of SQL queries that collect parameter data for analytics. The number is a cumulative total. It is not the number of distinct SQL queries, but the overall number of invocations of the SQL queries that have been configured to collect analytics data.
Type Default value Platform(s)
Boolean 10000 Java, .NET

api-thread-activity-timeout-in-seconds

This property provides a time-out value that comes into play when you have added global transactions to your application using APIs from the Splunk AppDynamics SDK. In the event that the added transaction spawns additional threads that do not return or complete, this property provides a safety valve time-out value. The value is in seconds. The removeCurrentThread method is invoked after the specified timeout period.
Type Default value Range Platform(s)
Integer 300 (seconds) Minimum =1; Maximum=3600 Java

api-transaction-timeout-in-seconds

This property provides a time-out value that comes into play when you have added global transactions to your application using APIs from the Splunk AppDynamics SDK. In the event that the added transaction does not return or complete, this property provides a safety valve time-out value. The time-out value is in seconds. The endTransaction method is invoked after the specified time-out period.
Type Default value Range Platform(s)
Integer 300 (seconds) Minimum =1; Maximum=3600 Java

appagent-export-packages

Use this property to provide the comma-separated list of packages available in the agent module that can be exported to other modules.
Type Default value Platform(s)
String none Java

appdynamics-agent-metricLimits

This property increases the metric limit for the .NET Agent for Linux.
Type Default value Platform(s)
Integer 5000 .NET Agent for Linux

apply-reactive-rules

This property provides a switch to flip the entire reactor instrumentation. If you set it to false, all rules pertaining to reactor thread correlation are unapplied.
Type Default value Platform(s)
Boolean true Java

apply-additional-reactive-rules

This property provides a switch to apply in process correlation rules for prospective thread hand-offs. By default these rules are disabled. These rules can only be applied if 'apply-reactive-rules' node property is set to true. If 'apply-reactive-rules' property is set to false, setting this property to 'true' will not apply any rules.
Type Default value Platform(s)
Boolean false Java

aspdotnet-core-legacy-instrumentation

When you set this property, ASP.NET Core entry instrumentation is restored to RequestServicesContainerMiddleware.Invoke for .NET Core 2.1 and 2.2 apps. You can use this when Business Transactions are missing from .NET Core apps after you upgrade an agent.
Type Default value Platform(s)
Boolean false ASP.NET Core

aspdotnet-core-naming-controlleraction

If true, causes the agent to identify ASP.NET Core on the full framework business transactions as Controller/Action.
Type Default value Platform(s)
Boolean true ASP.NET Core

aspdotnet-core-naming-controllerarea

If true, causes the agent to identify ASP.NET Core on the full framework business transactions as Area/Controller/Action.
Type Default value Platform(s)
Boolean true ASP.NET Core

async-transaction-demarcator

This class name and method name combination marks the end of an asynchronous distributed transaction. Use the format ClassName/MethodName. For example, foo/bar where foo is the class name and bar is the method name.
Type Default value Platform(s)
String none Java