newrelic/infrastructure

New Relic Infrastructure 镜像文档

镜像概述与主要用途

本Docker镜像包含https://newrelic.com/infrastructure代理，用于监控底层Docker主机。作为New Relic Infrastructure Agent的公共镜像，其核心用途是在容器化环境中部署Infrastructure代理，实现对Docker主机及其容器的全面监控。

核心功能与特性

• 主机监控：收集主机的系统资源（CPU、内存、磁盘、网络）、进程活动及存储指标。
• 容器监控：通过Docker守护进程套接字获取容器生命周期、资源使用情况等数据。
• 系统调用跟踪：支持进程级系统调用跟踪，提供详细的进程行为数据。
• 配置灵活性：支持通过环境变量或自定义配置文件（newrelic-infra.yml）配置代理参数。
• 轻量级基础：基于Alpine Linux构建（最新版本），体积小且资源占用低。

使用场景与适用范围

适用于以下场景：

• 无原生包管理器的操作系统（如CoreOS），需通过容器部署监控工具。
• 容器化部署环境，需监控底层Docker主机及运行中的容器。
• 需要统一管理监控配置，通过自定义镜像扩展默认代理功能的场景。

使用方法与配置说明

前提条件

• 拥有New Relichttps://docs.newrelic.com/docs/accounts-partnerships/accounts/account-setup/license-key。
• Docker引擎已安装并运行。

拉取镜像

bash
docker pull docker.xuanyuan.run/newrelic/infrastructure:latest

简单部署（快速启动）

通过以下命令直接运行容器，需替换YOUR_LICENSE_KEY为实际许可证密钥：

bash
docker run \
    -d \
    --name newrelic-infra \
    --network=host \
    --cap-add=SYS_PTRACE \
    -v "/:/host:ro" \
    -v "/var/run/docker.sock:/var/run/docker.sock" \
    -e NRIA_LICENSE_KEY="YOUR_LICENSE_KEY" \
    docker.xuanyuan.run/newrelic/infrastructure:latest

自定义部署（推荐）

推荐通过扩展基础镜像并提供自定义newrelic-infra.yml配置文件，实现更灵活的代理配置。

步骤1：创建配置文件

创建newrelic-infra.yml文件，至少包含许可证密钥：

yaml
license_key: YOUR_LICENSE_KEY

更多配置参数详见https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/configuration/configure-infrastructure-agent。

步骤2：构建自定义镜像

创建Dockerfile，将自定义配置文件添加到镜像中：

dockerfile
FROM docker.xuanyuan.run/newrelic/infrastructure:latest
ADD newrelic-infra.yml /etc/newrelic-infra.yml

构建并标记镜像：

bash
docker build -t your-custom-infra-agent .

步骤3：运行自定义镜像

bash
docker run \
    -d \
    --name newrelic-infra \
    --net=host \
    --cap-add=SYS_PTRACE \
    -v "/:/host:ro" \
    -v "/var/run/docker.sock:/var/run/docker.sock" \
    docker.xuanyuan.run/your-custom-infra-agent

必需运行参数说明

基础镜像说明

• Alpine基础镜像：版本0.0.55及以上使用Alpine，对应latest标签，轻量级且资源占用低。
• CentOS 7基础镜像：历史版本使用CentOS 7，如需继续使用，可指定latest-centos标签拉取最新CentOS 7版本。

常见问题与参考文档

更多配置细节及问题排查，请参考官方文档：
https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/data-instrumentation/monitor-containers-underlying-hosts-coreos