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 容器的基本命令如下：

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 容器：

docker exec -it <容器名称> sh

查看 Daemon 日志

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

docker logs <容器名称>

自定义配置文件

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

命令示例

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）：

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 兼容性要求