修改 PHP Agent 配置
- 此内容仅适用于 4.1 及以上版本的代理。
- 如果您想为每个 PHP 应用程序分别修改配置,请参阅此帮助页面。
PHP Agent 的配置(如应用程序名称、数据端口和状态端口)可以为应用服务器上的所有应用程序统一修改。
Linux
Windows
Linux
使用命令行参数设置选项
执行 configure 命令,并附上指令及其对应值:
sudo sh /opt/zpa/bin/agent_php.sh configure -<directive> <value>
示例
执行以下命令以更改默认应用程序名称并禁用 MySQL 捕获:
sudo sh /opt/zpa/bin/agent_php.sh configure -zpa.application_name "appname" -zpa.capture_mysql 0
使用环境变量设置选项
- 导出指令及其对应值:
export <directive>=<value>
- 执行 configure 命令:
sudo -E sh /opt/zpa/bin/agent_php.sh configure
示例
执行以下命令以更改默认应用程序名称并禁用 MySQL 捕获:
步骤 1
export ZPA_APPLICATION_NAME="appname"
export ZPA_CAPTURE_MYSQL=0
步骤 2
sudo -E sh /opt/zpa/bin/agent_php.sh configure
通过修改 configuration.json 文件设置选项
- 修改 configuration.json 文件。
- 执行 configure 命令:
sudo sh /opt/zpa/bin/agent_php.sh configure
示例
执行以下命令以更改默认应用程序名称并禁用 MySQL 捕获:
步骤 1
{
"php.install_path": "",
"agent_configuration": {
"extension": "php_zpa.dll",
"zpa.application_name" : "appname",
"zpa.capture_mysql" : 0
}
}步骤 2
sudo sh /opt/zpa/bin/agent_php.sh configure
Windows
通过修改 configuration.json 文件设置选项
- 修改 configuration.json 文件。
示例
要更改默认应用程序名称并禁用 MySQL 捕获,请执行以下命令:{
"php.install_path": "",
"agent_configuration": {
"extension": "php_zpa.dll",
"zpa.application_name" : "appname",
"zpa.capture_mysql" : 0
}
} - 双击 MSI 文件,选择修复 APM Insight PHP Agent,然后点击完成。

其他可用选项
| INI 指令 | 环境变量 | 描述 |
|---|---|---|
|
zpa.application_name |
ZPA_APPLICATION_NAME |
|
|
zpa.data_port |
ZPA_DATA_PORT |
|
|
zpa.status_port |
ZPA_STATUS_PORT |
|
|
zpa.hostlicense_apply |
ZPA_HOSTLICENSE_APPLY |
|
|
zpa.method_threshold |
ZPA_METHOD_THRESHOLD |
|
|
zpa.remote_exporter_hostname |
ZPA_REMOTE_EXPORTER_HOSTNAME |
|
|
zpa.stack_depth |
ZPA_STACK_DEPTH |
|
|
zpa.capture_casssandra |
ZPA_CAPTURE_CASSANDRA |
|
|
zpa.capture_clirequest |
ZPA_CAPTURE_CLIREQUEST |
|
|
zpa.capture_distributed_trace |
ZPA_CAPTURE_DISTRIBUTED_TRACE |
|
|
zpa.capture_http |
ZPA_CAPTURE_HTTP |
|
|
zpa.capture_memcached |
ZPA_CAPTURE_MEMCACHED |
|
|
zpa.capture_mssql |
ZPA_CAPTURE_MSSQL |
|
|
zpa.capture_mysql |
ZPA_CAPTURE_MYSQL |
|
|
zpa.capture_oracle |
ZPA_CAPTURE_ORACLE |
|
|
zpa.capture_pdo |
ZPA_CAPTURE_PDO |
|
|
zpa.capture_postgres |
ZPA_CAPTURE_POSTGRES |
|
|
zpa.capture_redis |
ZPA_CAPTURE_REDIS |
|
|
zpa.track_errors |
ZPA_TRACK_ERRORS |
|
|
zpa.track_exceptions |
ZPA_TRACK_EXCEPTIONS |
|
|
zpa.track_zend_execute_internal |
ZPA_TRACK_ZEND_EXECUTE_INTERNAL |
|
|
zpa.track_zend_execute |
ZPA_TRACK_ZEND_EXECUTE |
|
|
zpa.span_limit |
ZPA_SPAN_LIMIT |
每个事务中要追踪的最大 span 数量。默认值为 10000。 |
