帮助手册

修改 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
注意

请查阅此表格以获取其他可用选项列表。

使用环境变量设置选项

  1. 导出指令及其对应值:
    export <directive>=<value>
  2. 执行 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 文件设置选项

  1. 修改 configuration.json 文件。
  2. 执行 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 文件设置选项

  1. 修改 configuration.json 文件。

    示例

    要更改默认应用程序名称并禁用 MySQL 捕获,请执行以下命令:
    {
     "php.install_path": "",
     "agent_configuration": {
          "extension": "php_zpa.dll",
          "zpa.application_name" : "appname",
          "zpa.capture_mysql" : 0
       }
    }
  2. 双击 MSI 文件,选择修复 APM Insight PHP Agent,然后点击完成

其他可用选项

INI 指令 环境变量 描述

zpa.application_name

ZPA_APPLICATION_NAME

  • 这是您的新应用程序名称。
  • 默认值为 PHP-Application。

zpa.data_port

ZPA_DATA_PORT

  • 这是进程间通信(IPC)数据端口号。
  • 默认值为 20022。

zpa.status_port

ZPA_STATUS_PORT

  • 这是 IPC 状态端口号。
  • 默认值为 20021。

zpa.hostlicense_apply

ZPA_HOSTLICENSE_APPLY

zpa.method_threshold

ZPA_METHOD_THRESHOLD

  • 这是需要追踪方法的阈值(毫秒)。 
  • 默认值为 10。

zpa.remote_exporter_hostname

ZPA_REMOTE_EXPORTER_HOSTNAME

  • 这是运行导出器的设备主机名。如果导出器和代理运行在同一台设备上,也可以留空。
  • 默认值为空。

zpa.stack_depth

ZPA_STACK_DEPTH

  • 这是要捕获的堆栈跟踪深度。 
  • 默认值为 15。

zpa.capture_casssandra

ZPA_CAPTURE_CASSANDRA

  • 1 表示捕获,0 表示禁用。 
  • 默认值为 1。

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。

本文档对您有帮助吗?

您愿意帮助我们改进文档吗?请告诉我们哪些方面可以做得更好。


很抱歉本文档未能让您满意。我们希望了解可以从哪些方面改进您的体验。


感谢您抽出时间分享反馈。我们将利用您的反馈来改进在线帮助资源。

短链接已复制!