APM Insight Configuration
You can fine-tune your application monitoring by modifying the APM agent configuration profile. The APM agent configuration profile enables you to set threshold values for key parameters for web and background transactions.
Contents:
- Add the APM agent configuration profile
- Edit the APM configuration profile
- Configuration profiles - Parameters and default values
1. Add the APM agent configuration profile
To create APM agent configuration profile:
- Log in to your Site24x7 account.
- Navigate to Admin > Configuration Profile > APM Agent Configuration> Add APM Agent Configuration Profile.
- Enter your Profile Name and choose your agent type.
- Configure other parameters.
- Click Save.
You can also clone configuration profiles with custom parameter values, and apply it to your respective applications.
![apm-clone Clone configuration profile](/help/images/apm-clone.png)
2. Edit the APM agent configuration profile
- Navigate to APM Insight > Your application > Edit.
- Go to Configuration Profile > APM Agent Configuration Profile.
- Click on the drop-down menu to access profiles for the respective agent type.
- Choose the concerned profile and click Save.
3. Configuration profiles - Parameters and default values
The APM agent configuration profile is categorized into three parts—basic configuration profiles, web transaction configurations, and background transaction configurations. The parameters for each profile are explained below.
Basic Configuration Profile
Basic configuration Profiles
Logging level- The log level at which the APM Insight agent should record information.
- Supported levels are SEVERE,WARNING, INFO and FINE.
Configuration | Description | Default Value |
Capture database SQL queries |
|
True |
Obfuscate SQL Parameters |
|
True |
Stacktrace threshold for SQLs in transaction trace |
|
3 (seconds) |
Agent Auto-upgrade |
|
False |
Display Instance Port number |
|
True |
Enable Down ALerts |
|
Disabled |
Suppress Instance Alerts |
|
False |
List of URL extensions to be skipped from tracking |
|
*.css, *.js, *.gif, *.jpg, *.jpeg, *.bmp, *.png, *.ico |
List of exceptions to be skipped from tracking |
|
None |
Skip Transactions |
|
None |
Web Transaction Configurations
Web Transactions Configurations
Configuration | Description | Default Value |
Apdex Threshold |
|
0.5 (seconds) |
Sampling factor |
|
1 (request) |
Enable transaction tracing |
|
True |
Transaction tracing threshold |
|
2 (seconds) |
Capture trace if external calls exceeds |
|
30 (Count) |
Capture CPU time per transaction? |
|
True |
Capture Memory allocation per transaction? |
|
2 (seconds) |
Capture HTTP parameters? |
|
False |
List of HTTP parameters to ignore |
|
password, authKey |
List of HTTP error codes to be ignored from tracking |
|
None |
Capture HTTP Bytes |
|
True |
Background Transaction Configurations
Background Transactions Configurations
Configuration | Description | Default Value |
Track background transactions |
|
True |
Capture traces |
|
True |
Transaction trace threshold |
|
5 (seconds) |
Capture trace, if external calls exceed |
|
40 (Count) |
Capture CPU time per transaction |
|
False |
Capture memory allocation per transaction |
|
False |
Sampling factor |
|
1 (Request) |
Configurations available only in apminsight.conf
Certain configuration files cannot be modified from the client. These settings can be configured in apminsight.conf file.
Configuration | Description | Default Value |
application.name |
|
My Application |
license.key* |
|
|
behind.proxy |
|
FALSE |
agent.server.port* |
|
80 |
* - Mandatory values. If any of these entries are not provided or invalid, the Agent cannot be initialized/started. However the Application Server (where the Agent is deployed) will start normally