The APM Insight .NET agent provides configuration options to control transaction tracking, trace collection, data capture, and other monitoring settings. You can modify these settings either through the Web Client or directly in the apminsight.conf file. This page describes the available settings, their configuration keys, and their default values.
To modify the agent configuration settings through the Web Client, navigate to the required APM Insight agent configuration profile and click the Edit option. You can then update the available settings for the selected profile.

The .NET agent configuration settings are organized into the following profiles:
The DOTNET configuration profile contains the following categories of settings:
Note: The red asterisk (*) indicates that the corresponding default value applies to Applications Manager versions later than v16470.
| Name | Key | Description | Default value |
|---|---|---|---|
| Capture database SQL Queries | sql.capture.enabled |
| True |
| Obfuscate SQL Parameters | transaction.trace.sql.parametrize |
Note: Enable this option if queries contain confidential values, such as credit card numbers or passwords. | True |
| Stacktrace threshold for SQLs in transaction trace | transaction.trace.sql.stacktrace.threshold |
| 3 seconds |
| Display Instance Port Number | show.instance.port.number |
| True |
| Logging level | apminsight.log.level |
| CRITICAL |
| List of URL extensions to be skipped from tracking | transaction.skip.listening |
Example: | *.css, *.js, *.gif, *.jpg, *.jpeg, *.bmp, *.png, *.ico |
| List of exceptions to be skipped from tracking | exceptions.ignore |
| None |
| Skip Transactions | transaction.skip.patterns |
| None |
| Normalize DB Operation Names |
| False |
| Name | Key | Description | Default value |
|---|---|---|---|
| Apdex Threshold | apdex.threshold |
| 0.5 seconds |
| Sampling factor | transaction.tracking.request.interval |
| 5 requests or 10 requests* |
| Enable transaction tracing | transaction.trace.enabled |
| True |
| Transaction tracing threshold | transaction.trace.threshold |
| 2 seconds or 5 seconds* |
| Capture trace if external calls exceed | component.trace.threshold |
| 30 |
| Capture HTTP parameters? | webtransaction.trace.input.params.record |
| False |
| List of HTTP parameters to ignore | webtransaction.trace.input.params.ignore |
| password, authKey |
| Capture HTTP headers? | webtransaction.trace.request.headers.record |
| False |
| List of Request headers to ignore | webtransaction.trace.request.headers.ignore |
| None |
| Capture Custom Parameters? | custom.parameters.record |
| False |
| Capture CPU Time? | cputime.capture.enabled |
| False |
| CPU Time threshold | cputime.threshold |
| 60% |
| Capture HTTP Response Headers | webtransaction.trace.response.headers.record |
| FALSE |
| List of HTTP Response Headers to be ignored | webtransaction.trace.response.headers.ignore |
| password, pswd, pass, authKey, parentId, parentID, resourceId, resourceID, id, ID |
| Capture External Call Request Headers | webtransaction.trace.ext.request.headers.record |
| FALSE |
| List of External Request Headers to be ignored | webtransaction.trace.ext.request.headers.ignore |
| password, pswd, pass, authKey, parentId, parentID, resourceId, resourceID, id, ID |
| Capture External Call Response Headers | webtransaction.trace.ext.response.headers.record |
| FALSE |
| List of External Response Headers to be ignored | webtransaction.trace.ext.response.headers.ignore |
| password, pswd, pass, authKey, parentId, parentID, resourceId, resourceID, id, ID |
| Capture Traces for Unique Executions? | transaction.trace.unique.execution |
| FALSE |
| Name | Key | Description | Default value |
|---|---|---|---|
| Track background transactions | bgtransaction.tracking.enabled |
| True |
| Capture traces | bgtransaction.trace.enabled |
| True |
| Transaction trace threshold | bgtransaction.trace.threshold |
| 2 seconds |
| Sampling factor | bgtransaction.tracking.request.interval |
| 5 requests |
| Track Web Services as background | bgtransaction.enable.web.services |
| False |
| Name | Key | Description | Default value |
|---|---|---|---|
| Capture database SQL Queries | sql.capture.enabled |
| True |
| Obfuscate SQL Parameters | transaction.trace.sql.parametrize |
Note: Enable this option if queries contain confidential values, such as credit card numbers or passwords. | True |
| Stacktrace threshold for SQLs in transaction trace | transaction.trace.sql.stacktrace.threshold |
| 3 seconds |
| Display Instance Port Number | show.instance.port.number |
| True |
| Logging level | apminsight.log.level |
| CRITICAL |
| List of exceptions to be skipped from tracking | exceptions.ignore |
| None |
| Skip Transactions | transaction.skip.patterns |
| None |
| Sampling factor | transaction.tracking.request.interval |
| 5 requests or 10 requests* |
| Enable transaction tracing | transaction.trace.enabled |
| True |
| Transaction tracing threshold | transaction.trace.threshold |
| 2 seconds or 5 seconds* |
| Capture trace if external calls exceed | component.trace.threshold |
| 30 |
| Capture CPU Time? | cputime.capture.enabled |
| False |
| CPU Time Threshold | cputime.threshold |
| 60% |
| Name | Key | Description | Default value |
|---|---|---|---|
| Capture database SQL Queries | sql.capture.enabled |
| True |
| Obfuscate SQL Parameters | transaction.trace.sql.parametrize |
Note: Enable this option if queries contain confidential values, such as credit card numbers or passwords. | True |
| Stacktrace threshold for SQLs in transaction trace | transaction.trace.sql.stacktrace.threshold |
| 3 seconds |
| Display Instance Port Number | show.instance.port.number |
| True |
| Logging level | apminsight.log.level |
| CRITICAL |
| List of exceptions to be skipped from tracking | exceptions.ignore |
| None |
| Skip Transactions | transaction.skip.patterns |
| None |
| Sampling factor | transaction.tracking.request.interval |
| 5 requests or 10 requests* |
| Enable transaction tracing | transaction.trace.enabled |
| True |
| Transaction tracing threshold | transaction.trace.threshold |
| 2 seconds or 5 seconds* |
| Capture trace if external calls exceed | component.trace.threshold |
| 30 |
| Capture CPU Time? | cputime.capture.enabled |
| False |
| CPU Time Threshold | cputime.threshold |
| 60% |
Note: This is only applicable to agent versions below 4.0.
Certain configuration files cannot be modified from the client. These settings can be configured in apminsight.conf file.
| Name | Key | Description | Default value |
|---|---|---|---|
| Application Name | application.name |
| True |
| Capture traces | license.key |
| none |
| Configure Proxy | behind.proxy |
| False |
It allows us to track crucial metrics such as response times, resource utilization, error rates, and transaction performance. The real-time monitoring alerts promptly notify us of any issues or anomalies, enabling us to take immediate action.
Reviewer Role: Research and Development