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
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 10 | Java |
max-analytics-collectors-allowed
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 2000 | Java, .NET |
max-async-task-registration-requests-allowed
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 500 | Java |
max-async-task-registrations-allowed
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 500 | Java, .NET |
max-business-transactions
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 50 | Minimum=N/A; Maximum=300 | Java, .NET, Node.js, SAP/ABAP, C++ SDK (any non-proxied Dynamic Language Agent) |
max-call-elements-per-snapshot
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 5000 | Java, .NET |
max-concurrent-snapshots
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 20 | Values must be positive integers. No other constraints. | Java, .NET |
max-correlation-header-size
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 4096 | Values must be positive integers. No other constraints. | Java |
max-discovered-backends
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 300 | Java, .NET |
max-error-snapshots-per-minute
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 5 | Java, .NET |
max-event-size-per-timeslice
A larger event size may flood the Controller with events resulting in performance issues.
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 100 | Java |
max-jdbc-calls-per-callgraph
min-duration-for-jdbc-call-in-ms are reported. Changing the value does not require a restart.
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 100 | Minimum=1; Maximum=1000 | Java, .NET |
max-jdbc-calls-per-snapshot
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 500 | Minimum=1; Maximum=5000 | Java, .NET |
max-metrics-allowed
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 5000 or as set with –Dappdynamics.agent.maxMetrics= | Java |
max-prepared-statement-sql-length
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 500 | Minimum=0; Maximum=1000 | Java, .NET |
max-service-end-points-per-async-type
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 40 | Minimum=0; Maximum=N/A | Java |
max-service-end-points-per-entry-point-type
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 25 | Minimum=0; Maximum=N/A | Java, .NET |
max-service-end-points-per-node
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 100 | Minimum=0; Maximum=N/A | Java, .NET |
max-service-end-points-per-thread
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 | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 1 | Minimum=0; Maximum=N/A | Java, .NET |
max-urls-per-error-code
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 50 | Java |
min-duration-for-jdbc-call-in-ms
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 10 | Minimum=0; Maximum=N/A | Java, .NET |
min-load-per-minute-diagnostic-session-trigger
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 10 | Minimum=0; Maximum=N/A | Java, .NET |
minimum-age-for-evaluation-in-minutes
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 30 | Minimum=5; Maximum=N/A | Java |
minimum-number-of-elements-in-collection-to-deep-size
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 1000 | Java |
minimum-size-for-evaluation-in-mb
| Type | Default value | Range | Platform(s) |
|---|---|---|---|
| Integer | 5 | Minimum=1; Maximum=N/A | Java |
min-transaction-stall-threshold-in-seconds
| Type | Default value | Platform(s) |
|---|---|---|
| Integer | 1800 (seconds) | Java |
msmq-correlation-field
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 | Supported values | Default value | Platform(s) |
|---|---|---|---|
| String |
|
None | .NET |
msmq-single-threaded
false. For multithreaded queue implementations, change the value to false. See MSMQ Backends for .NET.
| Type | Default value | Platform(s) |
|---|---|---|
| Boolean | false | .NET |
multi-tenant-agent-enabled
multi-tenant agent, which will disables all services that rely on it, including Cisco Secure Application.
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 | Default value | Platform(s) |
|---|---|---|
| String | none | Java |
multi.tenant.agent.logs.dir
mtagent and argentoDynamicService logs.
Accepted values:
apm- This default value stores themtagentandargentoDynamicServicelog files in the default APM logging directory along with APM logs.non-apm- Use this value to store themtagentandargentoDynamicServicelog files in theargentoDynamicServicedirectory inexternal-services.
You can edit the property in app-agent-config.xml.
| Type | Default value | Platform(s) |
|---|---|---|
| String | apm | Java |