View Source

<style>
.panel {
  max-width: 85%;
  min-width: 40%;
  margin: 5px;
  margin-left: 0px;
  margin-right: 5px;
}
.panelContent { 
  padding:0px;
margin: 1px;
}
.panelContent h2 {
  font-size: 36px;
}
.table-wrap {
  margin:0px;
}
.sectionColumnWrapper {
  margin: 0px;
  padding: 0px;
}
.sectionMacroWithBorder {
  padding:0px;
  margin: 0px;
}
</style>

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.

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. 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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>10</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>2000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>500</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>500</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>50</td>
    </tr>
    <tr>
        <td><strong>Range:</strong></td><td>Minimum=N/A; Maximum=300</td>      
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET, Node.js, SAP/ABAP, C++ SDK (any non-proxied Dynamic Language Agent)</td>
    </tr>
   </tbody>
</table>

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. does not recommend dramatically increasing this number as it may have overhead implications.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>5000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>20</td>
    </tr>
     <tr>
      <td><strong>Range:</strong></td><td>Values must be positive integers. No other constraints.</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

The maximum size of the correlation header.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>4096</td>
    </tr>
     <tr>
      <td><strong>Range:</strong></td><td>Values must be positive integers. No other constraints.</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

This property changes the default limit of 300 unresolved backends per application, regardless of the type. See Backend Registration Limits.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>300</td>
    </tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>5</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>100</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>100</td>
    </tr>
     <tr>
      <td><strong>Range:</strong></td><td>Minimum=1; Maximum=1000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>500</td>
    </tr>
     <tr>
      <td><strong>Range:</strong></td><td>Minimum=1; Maximum=5000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>5000 or as set with <code>–Dappdynamics.agent.maxMetrics=<metricValue></code></td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>500</td>
    </tr>
 <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=1000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>40</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>25</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>100</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>1</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>50</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>10</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>10</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=0; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>30</td>
    </tr>
         <tr>
      <td><strong>Range:</strong></td><td>Minimum=5; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>1000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>5</td>
    </tr>
    <tr>
      <td><strong>Range:</strong></td><td>Minimum=1; Maximum=N/A</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Integer</td>
    </tr>
    <tr>
      <td><strong>Default value:</strong></td><td>60</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>String</td>
    </tr>
    <tr>
      <td><strong>Supported values:</strong></td>
      <td>
          <ul>
            <li><code>None:</code> Disable downstream correlation for MSMQ</li>
            <li><code>Label:</code> Store correlation information in the label field</li>
            <li><code>Extension:</code> Store correlation information in the extension field</li>
          </ul>
      </td>
    </tr>
        <tr>
      <td><strong>Default value:</strong></td><td>None</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>.NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Boolean</td>
    </tr>
        <tr>
      <td><strong>Default value:</strong></td><td>false</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>.NET</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>String</td>
    </tr>
        <tr>
      <td><strong>Default value:</strong></td><td>none</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

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.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>String</td>
    </tr>
        <tr>
      <td><strong>Default value:</strong></td><td>apm</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>