PDFs


This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.


On this page:

Works with:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
55 rates

You can register app agent node properties to customize app agent behavior at the application, tier, or node level.

About Node Properties

App agent node properties control the features and preferences for the Java Agent and .NET Agent. Such agent-specific settings include limits on the number of business transactions, minimum number of requests to evaluate before triggering a diagnostic session, and so on. Node properties follow an inheritance model similar to instrumentation detection, so you can set an individual property globally for an application or at the the tier or node levels. 

App agent node properties are not supported for the following agents: PHP, Node.js, Python, Web Server Agent, or the C/C++ SDK.

 

Even though it is possible to configure node properties in the app-agent-config.xml file in the agent home directory, AppDynamics recommends that you use the Controller UI to configure node properties. The Controller UI displays only those node properties that are registered to the agent.

The App Agent Node Properties reference includes additional properties that do not appear in the UI by default. You can register these properties yourself, but unregistered properties are intended for specific application or troubleshooting scenarios and can impact the performance of your deployment. You should register properties or configure properties directly in app-agent-config.xml only under the guidance of AppDynamics Support or as specifically instructed by the documentation.

Edit a Registered Node Property

In the Controller UI, you can access node properties for a particular node or for all nodes from the dashboard of any node in the application, as follows:

  1. Access the node dashboard by going to the App Servers page (see Tiers and Nodes). 
  2. Expand the tier that contains the node on which you want to configure a node property and double-click the node.
  3. In the node dashboard, click Actions > Configure App Server Agent
  4. Select the Use Custom Configuration button, and then find and double click on the property you want to modify. See Hierarchical Configuration Inheritance for more information on how node settings work.

After customizing a configuration, you can copy the configuration to other nodes, to the tier, or apply it to the entire application.

Add a Registered Node Property

You can register and configure unregistered App Agent node properties as instructed by AppDynamics Support or as documented.  

To register a node property, create a custom configuration for the node, as described in Edit Registered Node PropertyAdd properties by clicking the + plus icon at the top of the list of current node properties.

In the Create Agent Property window, use the values from App Agent Node Properties Reference to provide values for the name, description, type, and value of the property.

App Agent Node Properties by Type

App Agent Node Properties Reference describes the agent properties in detail. It lists the properties in alphabetical order. The following table provides an alternate view of the properties. It lists the properties by type, enabling you to browse the properties by functionality and feature area. 

Type

Property

Automatic Leak Detection

minimum-age-for-evaluation-in-minutes

 

minimum-number-of-elements-in-collection-to-deep-size

 

minimum-size-for-evaluation-in-mb

Bytecode injection (BCI)

bci-log-config

 bciengine-disable-retransformation
 enable-interceptors-for-security

 

enable-json-bci-rules

 

enable-xml-bci-rules

Backend Detectionenable-kafka-consumer
 enable-vertx-message-entry
 msmq-correlation-field
 msmq-single-threaded 
 nservicebus-single-threaded 

Object Instance Tracking (OIT )

collection-capture-period-in-minutes

 

enable-instance-monitoring

 

enable-object-size-monitoring

 

leak-diagnostic-interval-in-minutes

JMX Propertyheap-storage-monitor-devmode-disable-trigger-pct
Transaction Monitoringado-new-resolvers

 

aspdotnet-mvc-naming-controlleraction

 

api-thread-activity-timeout-in-seconds

 

api-transaction-timeout-in-seconds

 async-tracking

 

async-transaction-demarcator

 

capture-404-urls

 

capture-error-urls

 

capture-raw-sql

 

capture-set-status

 capture-spring-bean-names

 

disable-custom-exit-points-for

 

disable-exit-call-correlation-for

 

disable-exit-call-metrics-for

 

disable-percentile-metrics

 

downstream-tx-detection-enabled

 

enable-default-http-error-code-reporter

 enable-soap-header-correlation

 

enable-spring-integration-entry-points

 

enable-transaction-correlation

 enable-vertx-http

 

end-to-end-message-latency-threshold-millis

 

find-entry-points

 

jdbc-callable-statements

 

jdbc-connections

 jdbc-dbcam-integration-enabled

 

jdbc-prepared-statements

 jdbc-resultsets

 

jdbc-statements

 

jmx-appserver-mbean-finder-delay-in-seconds

 jmx-operation-timeout-in-milliseconds

 

jmx-rediscover-mbean-servers

 jrmp-enable

 

log-request-payload

 max-async-task-registration-requests-allowed
 max-async-task-registrations-allowed

 

max-business-transactions

 max-service-end-points-per-async-type
 max-service-end-points-per-entry-point-type
 max-service-end-points-per-node 
 max-service-end-points-per-thread 

 

max-urls-per-error-code

 

min-load-per-minute-diagnostic-session-trigger

 rmqsegments

 

percentile-method-option

 rest-num-segments
 rest-transaction-naming 
 rest-uri-segment-scheme

 

slow-request-deviation

 

slow-request-monitor-interval

 socket-collection-bci-enable

 

spring-integration-receive-marker-classes

 thread-correlation

 

thread-correlation-classes

 

thread-correlation-classes-exclude

 max-service-end-points-per-node
 max-service-end-points-per-thread

 

max-urls-per-error-code

 websocket-entry-calls-enabled 

Transaction Snapshots

adaptive-callgraph-granularity

 

callgraph-granularity-in-ms

 dev-mode-suspend-cpm

 

dont-show-packages

 

enable-startup-snapshot-policy

 

max-call-elements-per-snapshot

 

max-concurrent-snapshots

 

max-jdbc-calls-per-callgraph

 

max-jdbc-calls-per-snapshot

 

min-duration-for-jdbc-call-in-ms

 

on-demand-snapshots

 

show-packages

 

slow-request-threshold

 

thread-cpu-capture-overhead-threshold-in-ms

Miscellaneous

collect-user-data-sync

  • No labels