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.

Set this property to true to hide the sensitive runtime data in the transaction snapshots. Add the filters in the XML format specified in app-agent-config.xml. This node property does not override sensitive filter configuration from 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>

Example

<sensitive-data-filters>
        <sensitive-data-filter applies-to="environment-variables,system-properties,jmx-mbeans"
                               match-type="CONTAINS"
                               match-pattern="password"/>
    </sensitive-data-filters>

Set this property to true to hide the runtime messages containing sensitive data in the transaction snapshots. Add the filters in the XML format specified in app-agent-config.xml. This node property does not override other node properties.

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

Example

<sensitive-message-filters>
        <sensitive-message-filter message-type="throwable,logger-message,all"
                                  match-type="EQUALS|CONTAINS|STARTSWITH|ENDSWITH|REGEX"
                                  match-pattern="CASESENSITIVE_PATTERN"
                                  redaction-regex="SENSITIVE_INFO_REGEX_GROUP"/>
     </sensitive-message-filters>

Set this property to true to hide the sensitive URLs in the transaction snapshots. Add the filters in the XML format specified in app-agent-config.xml. This node property does not override sensitive filter configuration from 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>

Example

<sensitive-url-filters>
        <sensitive-url-filter delimiter="/"
                                  segment="2,3"
                                  match-filter="EQUALS|INLIST|STARTSWITH|ENDSWITH|CONTAINS|REGEX|NOT_EMPTY"
                                  match-pattern="pattern"
                                  param-pattern=""/>
    </sensitive-url-filters>

For the call graphs captured on this node, show the specified packages or class names in addition to the ones configured in the global call graph configuration. Does not need 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>String</td>
    </tr>
        <tr>
      <td><strong>Default value:</strong></td><td>none</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

The value in milliseconds for the deviation from the current average response time. This setting is used for evaluation of slow in-flight transactions. Also, see the slow-request-threshold property for more details.

<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>200</td>
    </tr>
	<tr>
      <td><strong>Range:</strong></td><td>Minimum=10; Maximum=3600</td>
    </tr>
    <tr>
      <td><strong>Platform(s):</strong></td><td>Java, .NET</td>
    </tr>
   </tbody>
</table>

In-flight requests are checked for slowness in the interval specified by this property. The value is specified in milliseconds.

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

In-flight requests taking more time than this threshold (in ms) with a deviation greater than the slow-request-deviation property from the current average response time are monitored to capture hot spots.

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

Use this property to enable NetViz monitoring of .NET and Java applications.

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

Use this property to change the default port which Java Agent queries to get the application metrics.

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

Use this property to enable or disable OOTB BT Detection for Spring Batch.

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

Use this property to specify the class and method you have identified as suitable POJO entry points for Spring Integration.

Based on the MessageHandler interface, the App Agent for Java by default automatically discovers exits for all channels except DirectChannel. In cases where a lot of application flow happens before the first MessageHandler is executed,

Set enable-spring-integration-entry-points=false
Configure suitable POJO entry points,
Declare each suitable POJO entry point class/method in this property spring-integration-receive-marker-classes

If the application code polls for messages in a loop, the span of each loop iteration is tracked as a transaction. Tracking begins when the loop begins and end it when the iteration ends. To safeguard against cases where pollableChannel.receive() is not called inside a loop, specify this property for each class/method combination that polls messages in a loop.

After setting this property, restart the application server for changes to this property to take effect.

<table style="cellpadding: 5px; font-size: 24px" class="conf-macro output-block confluenceTable" frame="below">
  <tbody>
    <tr>
      <td><strong>Type:</strong></td><td>Comma-separated string of fully-qualified class /method name, such as spring-integration-receive-marker-classes = <fully qualified name of class/method>,<> ....</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>

Examples

For example, to enable tracking for the following:

class MessageProcessor
{
void process()
{
   while(true)
   {
          Message message = pollableChannel.receive()
   }
}
}

set this property as follows:

spring-integration-receive-marker-classes = MessageProcesser/process