newrelic-agent-control-cli Docker镜像文档

概述

newrelic-agent-control-cli是一个包含New Relic Agent控制命令行工具的Docker镜像，旨在简化New Relic Agent的部署与管理流程。该镜像封装了用于配置、启动、停止、监控New Relic Agent的核心命令，适用于各类需要集成New Relic应用性能监控(APM)的环境，帮助用户快速实现代理生命周期管理与监控数据采集。

核心功能与特性

• 配置管理：支持通过命令行或环境变量配置New Relic Agent关键参数（如许可证密钥、应用名称、日志级别等）
• 生命周期控制：提供start/stop/restart命令，管理Agent进程的启动与停止
• 状态监控：通过status命令实时查看Agent运行状态、连接状态及数据上报情况
• 日志集成：支持查看Agent运行日志，快速定位配置或连接问题
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景与适用范围

• 开发环境调试：本地开发时快速部署并调试New Relic Agent配置
• 生产环境管理：在容器化生产环境中统一管理Agent生命周期
• CI/CD流程集成：作为部署流程的一部分，自动配置并启动Agent
• 多环境一致性：确保开发、测试、生产环境使用相同的Agent管理工具链

使用方法与配置说明

获取镜像

bash
docker pull newrelic/newrelic-agent-control-cli:latest

基本运行命令

bash
docker run -it --rm \
  -e NEW_RELIC_LICENSE_KEY="your_license_key" \
  -e NEW_RELIC_APP_NAME="your_application_name" \
  newrelic/newrelic-agent-control-cli:latest \
  [command]

环境变量配置

持久化配置

如需自定义配置文件，可通过挂载卷的方式加载本地配置：

bash
docker run -it --rm \
  -v /path/to/local/newrelic.yml:/etc/newrelic/newrelic.yml \
  newrelic/newrelic-agent-control-cli:latest \
  start

常用命令示例

1. 启动Agent

bash
docker run -it --rm \
  -e NEW_RELIC_LICENSE_KEY="your_key" \
  -e NEW_RELIC_APP_NAME="my-app" \
  newrelic/newrelic-agent-control-cli:latest \
  start

2. 查看Agent状态

bash
docker run -it --rm \
  -e NEW_RELIC_LICENSE_KEY="your_key" \
  newrelic/newrelic-agent-control-cli:latest \
  status

3. 停止Agent

bash
docker run -it --rm \
  -e NEW_RELIC_LICENSE_KEY="your_key" \
  newrelic/newrelic-agent-control-cli:latest \
  stop

4. 查看Agent日志

bash
docker run -it --rm \
  -e NEW_RELIC_LICENSE_KEY="your_key" \
  newrelic/newrelic-agent-control-cli:latest \
  logs

与Docker Compose集成示例

yaml
version: '3'
services:
  newrelic-agent:
    image: newrelic/newrelic-agent-control-cli:latest
    environment:
      - NEW_RELIC_LICENSE_KEY=your_license_key
      - NEW_RELIC_APP_NAME=my-node-app
      - NEW_RELIC_LOG_LEVEL=debug
    volumes:
      - ./newrelic.yml:/etc/newrelic/newrelic.yml
    command: start