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

In general, be cautious when modifying the agent default settings. After increasing limits specified for an agent, you need to assess and monitor memory consumption by the agent after the change. 

maximum-activity-trace-stack-depth

This property determines the depth of the stack trace to capture as part of an activity trace session. By default, the size of the code paths for OIT (Object Instance Tracking), ALD (Automatic Leak Detection) and MIDS (Memory Intensive Data Structures) are set to 10. To increase this limit, use this property.

Warning: A larger depth has higher overhead on the system. AppDynamics recommends that you increase the default value of this property only temporarily, and remove it or set it back to 10 once you get the desired output.

Type:Integer
Default value:10
Platform(s):Java

max-analytics-collectors-allowed

This property sets an upper limit for Analytics collectors in the agent.

Type:Integer
Default value:2000
Platform(s):Java, .NET

max-async-task-registration-requests-allowed

Adjust this property to increase or decrease the number of asynchronous task registration requests allowed.

Type:Integer
Default value:500
Platform(s):Java

max-async-task-registrations-allowed

Adjust this property to increase or decrease the number of asynchronous task registrations allowed.

Type:Integer
Default value:500
Platform(s):Java, .NET

max-business-transactions

Sets a limit on the number of business transactions discovered once an agent is started. The limit helps to ensure that the Controller I/O processing capability and agent memory requirements are appropriate for a production environment. See ビジネストランザクション.

Warning: Changing this setting can affect the resource consumption of your deployment. Before you change this setting, verify that your application environment and Controller can handle any increased resource requirements.

Type:Integer
Default value:50
Range:Minimum=N/A; Maximum=300
Platform(s):Java, .NET, Node.js, SAP/ABAP, C++ SDK (any non-proxied Dynamic Language Agent)

max-call-elements-per-snapshot

This property represents the maximum number of elements that are collected for any call graph for a snapshot. When the limit is reached, the agent stops collecting more data for this call graph, reports what has been collected to that point, and marks the call graph with a warning that the limit was reached. AppDynamics does not recommend dramatically increasing this number as it may have overhead implications.

Type:Integer
Default value:5000
Platform(s):Java, .NET

max-concurrent-snapshots

The maximum number of total snapshots that are allowed, including continuing transactions. When the queue goes over the value set, additional snapshots are dropped. This property is ignored in Development mode. 

Type:Integer
Default value:20
Range:Values must be positive integers. No other constraints.
Platform(s):Java, .NET

max-correlation-header-size

 The maximum size of the correlation header.

Type:Integer
Default value:4096
Range:Values must be positive integers. No other constraints.
Platform(s):Java

max-error-snapshots-per-minute

A limit for the number of snapshots per minute due to errors. For example, if too many error snapshots are being seen, then tweak this value to reduce noise in the snapshots.

Type:Integer
Default value:5
Platform(s):Java, .NET

max-jdbc-calls-per-callgraph

The maximum number of JDBC/ADO.NET exit-call stack samples per call graph. Only queries taking more time than the value of min-duration-for-jdbc-call-in-ms are reported. Changing the value does not require a restart.

Type:Integer
Default value:100
Range:Minimum=1; Maximum=1000
Platform(s):Java, .NET

max-jdbc-calls-per-snapshot

The maximum number of JDBC/ADO.NET exit calls allowed in a snapshot. Calls after the limit are not recorded. Changing the value does not require a restart.

Type:Integer
Default value:500
Range:Minimum=1; Maximum=5000
Platform(s):Java, .NET

max-metrics-allowed

This property sets the upper limit to the number of metrics that can be registered by the agent.

Note: If the number of metrics—registered + unregistered—is greater than the new node property value, then the new metrics will not be created.

Type:Integer
Default value:5000 or as set with –Dappdynamics.agent.maxMetrics=
Platform(s):Java

max-prepared-statement-sql-length

Maximum length of the SQL statement for SQL prepared statements. The length of the SQL statement is truncated if it exceeds the value set by this property. 

Type:Integer
Default value:500
Range:Minimum=0; Maximum=1000
Platform(s):Java, .NET

max-service-end-points-per-async-type

Maximum total number of service endpoints that can be registered for each asynchronous entry point type, such as worker thread. Because a single transaction may spawn many threads, you may expect more asynchronous service endpoint types than for synchronous service endpoint types.

Type:Integer
Default value:40
Range:Minimum=0; Maximum=N/A
Platform(s):Java

max-service-end-points-per-entry-point-type

Maximum total number of service endpoints that can be registered for each entry point type, such as servlet, struts action, web service, and so on.

Type:Integer
Default value:25
Range:Minimum=0; Maximum=N/A
Platform(s):Java, .NET

max-service-end-points-per-node

Maximum total number of service endpoints that can be detected on a single node. Increasing the value of this property enables more service endpoints to be detected on a particular node.

Type:Integer
Default value:100
Range:Minimum=0; Maximum=N/A
Platform(s):Java, .NET

max-service-end-points-per-thread

Maximum number of service endpoints detected on a single thread of transaction execution.

If this property is set to the default value of one and two service endpoints are detected that impact one specific transaction, only one service endpoint will be evaluated at any time. If a second service endpoint is detected in the context of the first one, the second is ignored. But, if the second service endpoint starts after the first one ends, the second service endpoint will be evaluated.

Increase this property to monitor additional service endpoints on a thread. This number ensures a maximum limit on overhead and number of metrics due to service endpoints on each thread execution. 

Type:Integer
Default value:1
Range:Minimum=0; Maximum=N/A
Platform(s):Java, .NET

max-urls-per-error-code

This property increases the number of URLs the agent can track that produced a certain error. Once the maximum has been reached, all remaining errors are classified as unknown.

Type:Integer
Default value:50
Platform(s):Java

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

A JDBC/ADO.NET call taking more time than the specified time (in milliseconds) is captured in the call graph. The query continues to show up in a transaction snapshot. Setting this value too low (< 10ms) may affect application response times. Changing the value does not require a restart.

Type:Integer
Default value:10
Range:Minimum=0; Maximum=N/A
Platform(s):Java, .NET

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

This property indicates the number of requests per Business Transaction to evaluate before triggering a diagnostic session. This property is useful to prevent diagnostic sessions when there is not enough load.

Type:Integer
Default value:10
Range:Minimum=0; Maximum=N/A
Platform(s):Java, .NET

minimum-age-for-evaluation-in-minutes

Automatic Leak Detection (ALD) tracks all frequently used Collections. For a Collection object to be identified and monitored, it must meet the conditions defined by the ALD properties. This property is the first criteria that needs to be met. The value is the minimum age of the Collection in minutes. This property takes effect after the node restarts.

From the point the collection is captured, it is monitored if it is still available for the specified period without collecting garbage. If it survives, then it is evaluated for size checks. If it meets the criteria, then it is monitored for long term growth in size.

Warning: If you reduce the default, there may be a performance hit on the CPU and memory because ALD needs to process more collections.

Type:Integer
Default value:30
Range:Minimum=5; Maximum=N/A
Platform(s):Java

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

Automatic Leak Detection (ALD) tracks all frequently used Collections. For a Collection object to be identified and monitored for it must meet the conditions defined by the ALD properties. This property sets the number of elements threshold.

Warning: If you reduce the default there may be a performance hit on the CPU and memory because AD is processing more collections.

Type:Integer
Default value:1000
Platform(s):Java

minimum-size-for-evaluation-in-mb

Automatic Leak Detection (ALD) tracks all frequently used Collections. For a Collection object to be identified and monitored it must meet the conditions defined by the ALD properties. This property sets the minimum initial size in megabytes for a collection to qualify for monitoring. The collection must also survive for the period specified in the minimum-age-for-evaluation-in-minutes property.

Warning: If you reduce the default there may be a performance hit on the CPU and memory because AD is processing more collections.

Type:Integer
Default value:5
Range:Minimum=1; Maximum=N/A
Platform(s):Java

min-transaction-stall-threshold-in-seconds

For Executor mode only, the asynchronous transactions do not get checked for stall unless they run at least the specified number of seconds.

Type:Integer
Default value:60
Platform(s):Java

msmq-correlation-field

By default, the .NET agent disables downstream correlation for MSMQ message queues. Register this node property on both the publishing and receiving tiers to enable downstream correlation for MSMQ and to specify the field where the agent writes correlation data.

The agent supports Extension or Label fields. By default, the agent writes correlation data to the Extension field, however, some frameworks built on MSMQ write data to the Extension field. Only use Label when the Extension field is not available because it is already in use by the framework. The NServiceBus implementation of MSMQ uses the Extension field, so for NServiceBus, use Label. See .NETのMSMQバックエンド.

Type:String
Supported values:
  • None: Disable downstream correlation for MSMQ
  • Label: Store correlation information in the label field
  • Extension: Store correlation information in the extension field
Default value:None
Platform(s):.NET

msmq-single-threaded

Specify the threading architecture for the MSMQ message queue. The default value is false. For multithreaded queue implementations, change the value to false. See .NETのMSMQバックエンド.

Type:Boolean
Default value:false
Platform(s):.NET

multi.tenant.agent.logs.dir

Use this property to set the default log location of mtagent and argentoDynamicService logs.

Accepted values:

  1. apm - This default value stores the mtagent and argentoDynamicService log files in the default APM logging directory along with APM logs.
  2. non-apm - Use this value to store the mtagent and argentoDynamicService log files in the argentoDynamicService directory in external-services.

You can edit the property in app-agent-config.xml.

Type:String
Default value:apm
Platform(s):Java