New Relic PHP Daemon 镜像文档

镜像概述和主要用途

New Relic PHP Daemon 作为 PHP Agent 与 New Relic 数据收集器（collector）之间的代理，用于减少网络流量并提升被监控应用的响应时间。若 Daemon 未运行，PHP Agent 将无法向 New Relic 报告数据。

该镜像仅包含 Daemon 组件，并非一站式解决方案。如需在同一容器中安装 Agent 和 Daemon，需参考 文档。目前未提供包含 Agent 的镜像，下文将指导如何配置 Agent/应用容器与 Daemon 协同工作。

注意：Agent 与 Daemon 之间传输的数据未加密，建议仅在私有网络中部署两者的连接。

核心功能和特性

• 代理转发：作为 PHP Agent 与 New Relic 数据收集器的中间层，接收 Agent 发送的监控数据并转发至 New Relic
• 性能优化：减少 PHP 应用与 New Relic 之间的直接网络交互，降低应用响应延迟
• 默认端口：默认监听 TCP 端口 31339，用于接收 PHP Agent 数据
• 配置灵活性：支持通过自定义配置文件调整 Daemon 行为
• 日志可访问性：通过 Docker 日志机制提供 Daemon 运行日志

使用场景和适用范围

适用于 Docker 环境中运行的 PHP 应用，需通过 New Relic 监控性能数据，且需采用 Agent 与 Daemon 分离部署架构的场景。典型适用条件：

• PHP 应用容器已安装 New Relic PHP Agent（版本 9.2+）
• 需满足 PHP Agent 兼容性要求
• 追求应用容器轻量化，将监控数据处理逻辑剥离至独立 Daemon 容器

使用方法和配置说明

前提条件

• 已安装 Docker 环境
• 应用容器需满足：
  • 安装 New Relic PHP Agent（版本 9.2+）
  • 符合 PHP Agent 系统要求

启动 New Relic PHP Daemon 容器

Daemon 容器需与安装了 PHP Agent 的应用容器配合使用。PHP Agent 通过 TCP 协议（默认端口 31339）向 Daemon 发送数据，Daemon 汇总后转发至 New Relic。

基本启动命令

拉取镜像后，启动 Daemon 容器的基本命令如下：

bash
docker run --name <容器名称> -d newrelic/php-daemon

• <容器名称> 替换为自定义容器名称（如 newrelic-php-daemon）
• 默认监听端口 31339，无需额外端口映射（应用容器通过容器网络访问）

配置应用容器

应用容器需安装 PHP Agent 并配置指向 Daemon 容器的地址。

配置步骤

1. 安装 PHP Agent：参考 Docker 环境 PHP Agent 安装文档
2. 配置 Agent 连接 Daemon：在 Agent 配置中设置 Daemon 地址（如 newrelic.daemon.address=<daemon-container-ip>:31339）
3. 验证连接：启动应用容器后，通过 Daemon 日志确认数据接收状态

示例参考：PHP Agent 与 Daemon 容器配置示例

访问容器 Shell 和日志

进入容器 Shell

通过 docker exec 命令访问运行中的 Daemon 容器：

bash
docker exec -it <容器名称> sh

查看 Daemon 日志

通过 docker logs 命令查看 Daemon 运行日志：

bash
docker logs <容器名称>

自定义配置文件

如需使用自定义配置文件（如调整日志级别、代理地址等），可通过 -v 参数挂载本地配置文件至容器，并通过 -c 参数指定 Daemon 加载路径。

命令示例

bash
docker run --name <容器名称> \
  -v /本地路径/newrelic.cfg:/etc/newrelic/newrelic.cfg \
  -d newrelic/php-daemon newrelic-daemon -c /etc/newrelic/newrelic.cfg

• /本地路径/newrelic.cfg：本地自定义配置文件的绝对路径
• -c /etc/newrelic/newrelic.cfg：指定 Daemon 加载容器内的配置文件

配置项参考：Daemon 配置文件说明

注意事项

• 启动顺序：Daemon 容器必须先于应用容器启动，否则 PHP Agent 无法连接 Daemon，导致数据丢失
• 网络连通性：确保应用容器与 Daemon 容器在同一网络（如默认 bridge 网络或自定义网络），可通过容器名称或 IP 地址通信
• 版本兼容性：PHP Agent 版本需 ≥ 9.2，否则可能存在协议不兼容问题

Docker Compose 部署示例

以下为包含 Daemon 和应用容器的 docker-compose.yml 示例（假设应用容器已预装 PHP Agent）：

yaml
version: '3'

services:
  newrelic-daemon:
    image: newrelic/php-daemon
    container_name: newrelic-php-daemon
    restart: always
    # 如需自定义配置，添加 volumes 挂载配置文件
    # volumes:
    #   - ./newrelic.cfg:/etc/newrelic/newrelic.cfg
    # command: newrelic-daemon -c /etc/newrelic/newrelic.cfg

  php-app:
    build: ./path/to/app  # 应用容器构建上下文
    container_name: php-app
    restart: always
    depends_on:
      - newrelic-daemon  # 确保 Daemon 先启动
    environment:
      - NEW_RELIC_LICENSE_KEY=<your-license-key>
      - NEW_RELIC_APP_NAME=<your-app-name>
    # 配置 Agent 连接 Daemon（具体方式取决于应用容器的 Agent 配置方式）
    # 例如在 PHP 配置文件中设置：newrelic.daemon.address=newrelic-daemon:31339

附录：相关文档链接

• New Relic Daemon 进程说明
• Docker 环境 PHP Agent 安装指南
• PHP Agent 与 Daemon 容器社区讨论
• PHP Agent 兼容性要求