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. Splunk 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 Default value Platform(s)
Integer 10 Java

max-analytics-collectors-allowed

This property sets an upper limit for Analytics collectors in the agent.
Type Default value Platform(s)
Integer 2000 Java, .NET

max-async-task-registration-requests-allowed

Adjust this property to increase or decrease the number of asynchronous task registration requests allowed.
Type Default value Platform(s)
Integer 500 Java

max-async-task-registrations-allowed

Adjust this property to increase or decrease the number of asynchronous task registrations allowed.
Type Default value Platform(s)
Integer 500 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 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

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. Splunk AppDynamics does not recommend dramatically increasing this number as it may have overhead implications.
Type Default value Platform(s)
Integer 5000 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 Default value Range Platform(s)
Integer 20 Values must be positive integers. No other constraints. Java, .NET

max-correlation-header-size

The maximum size of the correlation header.
Type Default value Range Platform(s)
Integer 4096 Values must be positive integers. No other constraints. Java

max-discovered-backends

This property changes the default limit of 300 unresolved backends per application, regardless of the type. See Backend Registration Limits.
Type Default value Platform(s)
Integer 300 Java, .NET

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 Default value Platform(s)
Integer 5 Java, .NET

max-event-size-per-timeslice

This property determines the number of events that are reported to Controller. By default, the size is set to 100. To increase this limit, use this property.

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

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 Default value Range Platform(s)
Integer 100 Minimum=1; Maximum=1000 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 Default value Range Platform(s)
Integer 500 Minimum=1; Maximum=5000 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 Default value Platform(s)
Integer 5000 or as set with –Dappdynamics.agent.maxMetrics= 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 Default value Range Platform(s)
Integer 500 Minimum=0; Maximum=1000 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 Default value Range Platform(s)
Integer 40 Minimum=0; Maximum=N/A 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 Default value Range Platform(s)
Integer 25 Minimum=0; Maximum=N/A 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 Default value Range Platform(s)
Integer 100 Minimum=0; Maximum=N/A 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 Default value Range Platform(s)
Integer 1 Minimum=0; Maximum=N/A 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 Default value Platform(s)
Integer 50 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 Default value Range Platform(s)
Integer 10 Minimum=0; Maximum=N/A 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 Default value Range Platform(s)
Integer 10 Minimum=0; Maximum=N/A 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 Default value Range Platform(s)
Integer 30 Minimum=5; Maximum=N/A 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 Default value Platform(s)
Integer 1000 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 Default value Range Platform(s)
Integer 5 Minimum=1; Maximum=N/A Java

min-transaction-stall-threshold-in-seconds

The minimum threshold for stalling or abandoning the transaction requests (in seconds).
Type Default value Platform(s)
Integer 1800 (seconds) 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 Supported values Default value Platform(s)
String
  • None: Disable downstream correlation for MSMQ
  • Label: Store correlation information in the label field
  • Extension: Store correlation information in the extension field
None .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 Default value Platform(s)
Boolean false .NET

multi-tenant-agent-enabled

This disables the 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

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

Accepted values:

  • apm - This default value stores the mtagent and argentoDynamicService log files in the default APM logging directory along with APM logs.
  • 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 Default value Platform(s)
String apm Java