Help APM APM for PHP PHP Agent Configuration

PHP Agent Configuration

PHP Agent Configuration file helps you fine tune the configuration for tracking web based transactions.


Editing the configuration settings

These settings can be configured using the edit option available in the web client.agent configuration


Description and default values for configuration options

Configuration Description Default Value
Apdex Threshold (T)
  • Application Performance Index (simply called Apdex) is measurement of an Application's Performance ranging from 0 to 1.
  • Detailed information about Apdex can be found at
  • If any transaction response time scores values below the apdex.threshold value, the transaction is labeled as Satisfied.
  • If any transaction response time scores above four times the apdex.threshold, the transaction is labeled as Frustrated.
  • If it is exactly equal to apdex.threshold or in between satisfied and frustrated threshold value it is labeled as Tolerating.
0.5 (seconds)
Capture database SQL queries
  • Enabling this option will listen to all SQL Queries which gets executed.
  • If this option is disabled, no Database Metrics will be collected.


Enable transaction tracing
  • Enabling this option will construct Trace for Slow Transactions.
  • You can view the traces collected in Site24x7 APM Insight Edition Page by selecting Traces tab.
Transaction tracing threshold
  • Trace of any transaction whose response time scoring above the specified threshold value will be collected, provided if transaction.trace.enabled is set to true.
  • The trace can be used to analyze, troubleshoot the transaction working.
2 (seconds)
Parametrize SQLs in transaction trace
  • Enabling this option will quantitatively describe all the SQL Queries in Slow Transaction Traces. (if sql.capture.enabled set to true & transaction.trace.enabled set to true)
  • Disabling this option will give you the real query (with parameters).
  • It is recommended to enable this option if there are queries getting executed using confidential parameters like credit card number, passwords, etc.
Stacktrace threshold for SQLs in transaction trace
  • Enabling this option will collect the stacktrace whenever any SQL query is executed above this threshold time value.
Sampling factor
  • Sampling factor helps in tracking sampled transactions.
  • If set to 5, APMInsight tracks only 1 in 5 requests of the same kind.
1 (request)


Configurations available only in apminsight.conf

Certain configuration files cannot be modified from the client. These settings can be configured only in apminsight.conf file.

Configuration Description Default Value
  • Specify the desired Application's Name to show in Site24x7.
  • If there are multiple instances of your application and you would like to group them, then specify the same application name in all installed APM Insight Agent Configuration files.
license.key *
  • The API Key for the corresponding user
  • This will be available in the APM Insight home page, after login.
  • Copy and Paste the Key as value for this parameter.
  • This key is user specific. Do not share with anyone else.
agent.server.port *
  • Specify the HTTP listening port of the Application Server.
  • It will be useful to distinguish Instances when more than one Application Server runs in same host.

  • Specify whether the Agent installed Application Server is under a proxy network.
  • If set True, Proxy credential information should be given in order to send the metric data from the agent to Site24x7.
  • If behind.proxy is set to true, specify values for the following keys:

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

Was this document helpful?
Thanks for taking the time to share your feedback. We’ll use your feedback to improve our online help resources.

Help APM APM for PHP PHP Agent Configuration