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.

This property enables adaptive snapshots. The call graph granularity for adaptive snapshots is based on the average response time for the business transaction during the last one minute and is thus adaptive. The following distribution is used:

Granularity of 10 ms for average response time of <= 10 seconds
50 ms for 10 to 60 seconds
100 ms for 60 to 600 seconds
200 ms for > 600 seconds

<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>Java, .NET</td>
    </tr>
   </tbody>
</table>

Enable database detection and naming for ODP.NET backends labeled Unknown0.

<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>true</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>.NET</td>
    </tr>
   </tbody>
</table>

Disable agentless Transaction Analytics on a particular node or tier.

<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>Java, .NET</td>
    </tr>
   </tbody>
</table>

By default, the Java Agent, .NET Agent, and Node.js Agent set business transaction correlation data in a cookie for HTTP responses, except when the JavaScript Agent has already set an isAjax:true header in the request. When it finds the isAjax:true header, the agent sets the correlation metadata in the XHR header.

For cross-origin AJAX requests, the JavaScript Agent does not set isAjax:true so that the app agent doesn't write correlation data to the header of those responses.

Set always-add-eum-metadata-in-http-headers to true to configure the app agent to write business transaction metadata to the XHR header and in a cookie even if the request is considered cross-origin.

<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>Java, .NET, Node.js</td>
    </tr>
   </tbody>
</table>

This property specifies the per minute upper limit on the number of SQL queries that collect parameter data for analytics. The number is a cumulative total. It is not the number of distinct SQL queries, but the overall number of invocations of the SQL queries that have been configured to collect analytics data.

<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>10000</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

This property provides a time-out value that comes into play when you have added global transactions to your application using APIs from the SDK. In the event that the added transaction spawns additional threads that do not return or complete, this property provides a safety valve time-out value. The value is in seconds. The removeCurrentThread method is invoked after the specified timeout period.

<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 (seconds)</td>
    </tr>
  <tr>
      <td><strong>Range:</strong></td><td>Minimum =1; Maximum=3600</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

This property provides a time-out value that comes into play when you have added global transactions to your application using APIs from the SDK. In the event that the added transaction does not return or complete, this property provides a safety valve time-out value. The time-out value is in seconds. The endTransaction method is invoked after the specified time-out period.

<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 (seconds)</td>
    </tr>
  <tr>
      <td><strong>Range:</strong></td><td>Minimum =1; Maximum=3600</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

Use this property to provide the comma-separated list of packages available in the agent module that can be exported to other modules.

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

This property increases the metric limit for the .NET Agent for Linux.

<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>.NET Agent for Linux</td>
    </tr>
   </tbody>
</table>

This property provides a switch to flip the entire reactor instrumentation. If you set it to false, all rules pertaining to reactor thread correlation are unapplied.

<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>true</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java</td>
    </tr>
   </tbody>
</table>

This property provides a switch to apply in process correlation rules for prospective thread hand-offs. By default these rules are disabled. These rules can only be applied if 'apply-reactive-rules' node property is set to true. If 'apply-reactive-rules' property is set to false, setting this property to 'true' will not apply any rules.

<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>Java</td>
    </tr>
   </tbody>
</table>

When you set this property, ASP.NET Core entry instrumentation is restored to RequestServicesContainerMiddleware.Invoke for .NET Core 2.1 and 2.2 apps. You can use this when Business Transactions are missing from .NET Core apps after you upgrade an agent.

<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>ASP.NET Core</td>
    </tr>
   </tbody>
</table>

If true, causes the agent to identify ASP.NET Core on the full framework business transactions as Controller/Action.

<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>true</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>ASP.NET Core</td>
    </tr>
   </tbody>
</table>

If true, causes the agent to identify ASP.NET Core on the full framework business transactions as Area/Controller/Action.

<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>true</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>ASP.NET Core</td>
    </tr>
   </tbody>
</table>

If true, causes the agent to identify ASP.NET MVC business transactions as Controller/Action. See Name MVC Transactions by Area, Controller, and Action.

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

If true, causes the agent to identify ASP.NET MVC business transactions as Area/Controller. See Name MVC Transactions by Area, Controller, and Action.

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

Enable or disable detection of asynchronous exit points. See Asynchronous Exit Points 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>true</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>.NET</td>
    </tr>
   </tbody>
</table>

This class name and method name combination marks the end of an asynchronous distributed transaction. Use the format ClassName/MethodName. For example, foo/bar where foo is the class name and bar is the method name.

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