APM（替代PHP监视器）技术文档

1. 安装指南

从 PECL 安装

1. 执行以下命令安装 APM 扩展：

   $ sudo pecl install apm
   

从源代码安装

1. 克隆 APM 代码仓库：

   $ git clone https://github.com/patrickallaert/php-apm.git
   

2. 切换到 APM 目录：

   $ cd php-apm
   

3. 为 APM 扩展准备编译环境：

   $ phpize
   

4. 配置扩展（默认启用 sqlite3、MariaDB/MySQL、StatsD 和 Socket 支持）：

   $ ./configure [--with-sqlite3[=DIR]] [--with-mysql[=DIR]] [--enable-statsd] [--enable-socket] [--with-debugfile[=FILE]]
   

   若要禁用某项支持，可以使用 --without-* 参数。

5. 编译扩展：

   $ make [-j]
   

   使用 -j 参数可以启用并行编译。

6. 安装扩展：

   $ sudo make install
   

2. 项目使用说明

请根据以下步骤配置和使用 APM：

• 在 PHP 配置文件中激活 APM 扩展：

  extension=apm.so
  

  注意：APM 依赖于 JSON，因此 apm.so 扩展必须在 JSON 之后加载。

• 根据需要配置数据库驱动（MariaDB/MySQL、SQLite 等）。

• 使用 Web 前端可视化数据，Web 前端项目地址为：https://github.com/patrickallaert/php-apm-web。

3. 项目API使用文档

APM 项目为用户提供了一系列配置选项，以下是一些常用配置：

• apm.application_id：应用标识符，用于区分被监控的应用。
• apm.event_enabled：是否启用事件捕获，如错误、通知、警告等。
• apm.stats_duration_threshold：请求最长持续时间阈值（毫秒），超过该阈值则记录。
• apm.stats_user_cpu_threshold：用户 CPU 时间阈值（毫秒），超过该阈值则记录。
• apm.stats_sys_cpu_threshold：系统 CPU 时间阈值（毫秒），超过该阈值则记录。
• apm.store_stacktrace：是否存储堆栈跟踪信息。
• apm.store_ip：是否存储 IP 地址。
• apm.store_cookies：是否存储 Cookie 信息。
• apm.store_post：是否存储 POST 变量。

更多配置选项请参考 apm.ini 文件。

4. 项目安装方式

请参考上文“1. 安装指南”部分，提供了从 PECL 和源代码两种安装方式。