On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
0 rates

This reference page contains information about app agent node properties. The properties are listed in alphabetical order.

disable-agent

This property enables/disables the agent. When this property is set to true, TransactionEntryPoints will not be monitored. No new BTs or metrics will be registered, metrics, and snapshots will not be reported.  Agent background threads will not be stopped. When set to false, the agent becomes active immediately. It does not need a restart.

Type:Boolean
Default value:False
Platform(s):Java

disable-agent-api

This property disables all calls to the agent-api library.  The calls function as no-ops when disabled.

Type:Boolean
Default value:False
Platform(s):Java

disable-custom-exit-points-for

Disables certain types of automatically detected exit points: SAP, Mail, LDAP, and so on. Type names are case sensitive. Use commas to separate multiple types.

Type:String
Default value:none
Supported values:CASSANDRA, Coherence, DangaMemcache, EHCache, LDAP, Memcache, MongoDB, RABBIT_MQ, REDIS, RMI, SAP, THRIFT
Platform(s):Java

disable-exit-call-correlation-for

Disable exit call correlation for a specific type of call. For example, KAFKA, WCF, WEB_SERVICE, HTTP, JMS, and RMI. By default, all exit call correlations are enabled.

Type:String
Default value:none
Platform(s):Java, .NET

disable-exit-call-metrics-for

Disables exit call monitoring for a specific type of exit call; for example, HTTP, JMS, WEB_SERVICE. If this property is set, the average data—calls/min, avg response time— for the specific exit call type is not collected. However, for a snapshot, all details are collected. Set this property if the application makes a large number of exit calls per transaction and the avg metrics are not important.

Type:String
Default value:By default, all exit call metrics are enabled.
Platform(s):Java, .NET

disable-percentile-metrics

App agents that support percentile metrics enable collection by default. Disable percentile metrics on the Configuration > Slow Transaction Thresholds window or set this node property manually to true to disable percentiles. 

Changes to this property do not require an agent restart.

Type:Boolean
Default value:false
Platform(s):Java, .NET

disable-service-monitoring-metrics

This property stops the BT-to-BT incoming cross-application metrics to be reported (but normal cross-application metrics continue to be reported, as expected).

Type:Boolean
Default value:True
Platform(s):Java

disable-soap-header-correlation-non-http

This property controls correlation with web service transactions. When enabled, it prevents injection of the correlation header into a SOAP message if the WCF transport is not over HTTP or HTTPS.

Type:Boolean
Default value:false
Platform(s):Java, .NET

For more information, see WCF Entry Points

disabled-features

Specifies types of data for which agent reporting to suppress. Use this property provides to disable data collection mechanisms at the agent to limit data reported by the agent for security or privacy reasons. This agent configuration overrides any Controller configuration that affects the data. 

You can disable 

  • LOG_PAYLOAD: Log payload, such as the node property log-request-payload
  • RAW_SQL: Raw SQL statements
  • CUSTOM_EXIT_SNAP_DATA: Snapshot data in custom exits
  • METHOD_INV_DATA_COLLECTOR: Diagnostic data collectors, method invocation
  • HTTP_DATA_COLLECTOR: Diagnostic data collectors, HTTP requests
  • INFO_POINT: Information points
  • ALL: All of the above
  • NONE: None of the above. This is equivalent to the default agent behavior. 
Type:String
Default value:none
Platform(s):Java

Examples

Configure disabled features in the app-agent-config.xml in the versioned conf directory for the agent. Specify the data category as the value attribute of the disabled-features property. You can have multiple data categories excluded by listing each separated by commas. For example:

With capture-raw-sql enabled, AppDynamics captures the SQL call in the following form: 

<app-agent-configuration>
  <configuration-properties>
        ....
        <property name="disabled-features" value="RAW_SQL,LOG_PAYLOAD"/>
  </configuration-properties>
  .....
</app-agent-configuration>

disable-ibmbpm-data-collectors

Sets whether data-collectors for IBM-BPM task business transactions should be disabled (value=true) or enabled (value=false).

Type:Boolean
Default value:false
Platform(s):Java

disable-ibmbpm-usertask-bt-in-process-correlation

Sets whether business transactions in-process correlation for IBM-BPM UserTask business transactions should be disabled (value=true) or enabled (value=false).

Type:Boolean
Default value:false
Platform(s):Java

disable-ibmbpm-usertask-bt-naming

Sets whether business transactions naming scheme for IBM-BPM UserTask Business Transactions should be disabled (value=true) or enabled (value=false).
When it is set to true, the Business Transactions would be named as per the default URL and not the meaningful names.

Type:Boolean
Default value:false
Platform(s):Java

dev-mode-suspend-cpm

The maximum number of transactions monitored per minute during development mode before the system switches out of development mode into normal operation mode.

Type:Integer
Default value:500
Range:Minimum=0; Maximum=N/A
Platform(s):Java

dont-show-packages

Do not show these packages / class names in addition to the ones configured in the global call graph configuration, for the call graphs captured on this node. Does not need a restart.

Type:String
Default value:none
Platform(s):Java, .NET

downstream-tx-detection-enabled

If the agent cannot reach the controller for a prolonged period, it turns off most services and notifies the continuing tiers that upstream transaction was detected and is not being monitored. Set this property to true to enable the continuing tiers to detect their own transactions in the event of network failure on the upstream tiers.

Type:Boolean
Default value:false
Platform(s):Java, .NET

enable-all-rsd-error-propagation

This property enables the agent to recognize errors that occur in calls outside of or tangential to business transactions.

false: All business transaction errors are reported, but errors outside of the business transaction are not reported.

true: All business transaction errors are reported. In addition, errors outside of the business transaction are reported. For example, errors generated from tracking analytics for a business transaction are reported.

full-disable: No asynchronous errors are recognized.

Type:Boolean
Default value:false
Platform(s):Java

enable-async-service-endpoints

By default the Java Agent automatically detects service endpoints for worker threads. Set this property to "false" to disable service endpoint detection for worker threads. This has the same effect as the Automatic Service Endpoint Detection checkbox for other types of service endpoints on Configuration > Instrumentation > Service Endpoints.

Type:Boolean
Default value:true
Platform(s):Java

enable-axon-entry

This node property is used to disable axon entry. By default, it is enabled.

Type:Boolean
Default value:true (By default, axon entry is enabled.)
Platform(s):Java

enable-axon-exit

This node property is used to disable axon exit. By default, it is enabled.

Type:Boolean
Default value:true (By default, axon entry is enabled.)
Platform(s):Java

enable-bt-block-wait-time-monitoring

This property controls capture of per BT block and wait time metrics. It is disabled by default.

Type:Boolean
Default value:false - (Disabled by default)
Platform(s):Java

enable-bt-cpu-time-monitoring

This property controls whether the agent captures the CPU time taken by a business transaction.

Type:Boolean
Default value:true
Platform(s):Java
 

 

enable-default-http-error-code-reporter

This property disables or enables automatic HTTP error code reporting for error codes between 400 to 505.

Type:Boolean
Default value:true
Platform(s):Java, .NET

enable-info-point-data-in-snapshots

This property disables or enables the capture of information point calls in snapshots. When this property is set to true, information point calls appear in the User Data section of the snapshot.

Type:Boolean
Default value:false
Platform(s):Java, .NET

enable-instance-monitoring

This property enables or disables Instance tracking on this node. Does not need a JVM restart.

Type:Boolean
Default value:false
Platform(s):Java

enable-interceptors-for-security

This property enables or disables security interceptors on this node. Set this property to true in environments where the Java 2 Security Manager is enabled.  If the Java 2 Security Manager is enabled, and this property is not set to true, then the agent will encounter SecurityExceptions, and will not be able to collect the data that it should.  Does not need a JVM restart.

Type:Boolean
Default value:false
Platform(s):Java

enable-json-bci-rules

Set this property to true to enable JSON bytecode instrumentation rules. AppDynamics instruments the get and getString methods within the package/class org.json.JSONObject when you set this value to true. Needs a JVM restart.

Type:Boolean
Default value:true (This only affects new applications; applications created with a 3.7.x controller will still have this property set by default to false.)
Platform(s):Java

enable-kafka-consumer

Set the enable-kafka-consumer to true to enable Apache Kafka consumer entry points. For more information see 'Apache Kafka Backends' on Java Backend Detection.

Type:Boolean
Default value:false
Platform(s):Java

enable-object-size-monitoring

This property is related to Automatic Leak Detection (ALD) and enables or disables Object Size monitoring on this node. Changing this property does not need a JVM restart. ALD is supported for JVM version 1.6 and up.

Type:Boolean
Default value:false
Platform(s):Java

enable-soap-header-correlation

This property controls correlation with web service transactions. When enabled, a node which receives a web service transaction may correlate that transaction with any downstream transactions. The ability to correlate depends on the particular web services framework. Currently, correlation is supported only by Apache Synapse and CXF frameworks. When disabled, the agent will not perform correlation through any web service tiers.

Type:Boolean
Default value:false
Platform(s):Java, .NET

enable-spring-integration-entry-points

This property disables or enables the default detection of Spring Integration entry points. Set to false to disable.

Default detection of Spring Integration entry points is based on MessageHandler. In cases where a lot of application flow happens before the first MessageHandler is executed:

See also Spring Integration Support.

Type:Boolean
Default value:true
Platform(s):Java

enable-startup-snapshot-policy

This property disables or enables the policy for start-up transaction snapshot. This means snapshots are collected for all BTs for all invocations for the first 15 minutes of application server startup.

Type:Boolean
Default value:false
Platform(s):Java, .NET

enable-transaction-correlation

This property disables or enables transaction correlation. It does not require a restart.

Type:Boolean
Default value:true
Platform(s):Java, .NET

enable-vertx-http

Enable or disable servlet HTTP entry points and exit points for Vert.x.

Type:Boolean
Default value:true
Platform(s):Java

enable-vertx-message-entry

Enable or disable Vert.x verticle message entry points for continuing transactions.

Type:Boolean
Default value:true
Platform(s):Java

enable-xml-bci-rules

This property enables Java XML Binding and DOM Parser bytecode instrumentation rules. Set to true to enable. The change takes effect after a JVM restart.

Type:Boolean
Default value:true (This only affects new applications; applications created with a 3.7.x Controller will still have this property set by default to false.)
Platform(s):Java

end-to-end-message-latency-threshold-millis

Enables end-to-end message latency monitoring for distributed asynchronous systems by setting up a threshold. Any message taking more time than the threshold is viewable through the Event Viewer.

Type:Integer
Default value:0
Range:Minimum=0; Maximum=36000
Platform(s):Java

  • No labels