Download PDF
Download page App Agent Node Properties (M).
App Agent Node Properties (M)
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 Business Transactions.
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 MSMQ Backends for .NET.
Type: | String |
Supported values: |
|
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 MSMQ Backends for .NET.
Type: | Boolean |
Default value: | false |
Platform(s): | .NET |
multi.tenant.agent.enabled
Use this property to start or stop the Cisco Secure Application service.
Accepted values:
true
- Starts the Cisco Secure Application service.false
- Stops the Cisco Secure Application service.
You can edit the property in app-agent-config.xml
.
Type: | String |
Default value: | none |
Platform(s): | Java |
multi.tenant.agent.logs.dir
Use this property to set the default log location of mtagent
and argentoDynamicService
logs.
Accepted values:
apm
- This default value stores themtagent
andargentoDynamicService
log files in the default APM logging directory along with APM logs.non-apm
- Use this value to store themtagent
andargentoDynamicService
log files in theargentoDynamicService
directory inexternal-services
.
You can edit the property in app-agent-config.xml
.
Type: | String |
Default value: | apm |
Platform(s): | Java |