newrelic/nrdot-collector

New Relic OpenTelemetry Collector (NRDOT) 镜像文档

镜像概述

New Relic OpenTelemetry Collector（简称NRDOT）是由New Relic支持的OpenTelemetry Collector预构建发行版。该镜像提供了开箱即用的遥测数据收集能力，无需手动构建Collector，可直接部署并集成到监控体系中。

更多信息请参考：

• 官方文档
• https://github.com/newrelic/nrdot-collector-releases/blob/main/README.md

核心功能与特性

• 预构建发行版：基于OpenTelemetry Collector官方规范构建，无需手动编译，直接部署使用
• New Relic官方支持：由New Relic提供技术支持和维护，确保与New Relic平台的兼容性
• 完整遥测支持：支持收集指标（Metrics）、日志（Logs）和分布式追踪（Traces）数据
• 配置灵活性：支持通过配置文件自定义数据收集规则、处理逻辑和导出目标

使用场景与适用范围

• 需要将应用或基础设施的遥测数据发送至New Relic平台的监控场景
• 希望标准化遥测数据收集流程，统一使用OpenTelemetry规范的企业环境
• 需快速部署遥测收集能力，减少手动配置和维护成本的场景

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name nrdot-collector \
  -e NEW_RELIC_LICENSE_KEY=<YOUR_NEW_RELIC_LICENSE_KEY> \
  -v /path/to/your/config.yaml:/etc/otelcol-nr/config.yaml \
  newrelic/nrdot-collector:latest

Docker Compose配置示例

yaml
version: '3'
services:
  nrdot-collector:
    image: newrelic/nrdot-collector:latest
    container_name: nrdot-collector
    environment:
      - NEW_RELIC_LICENSE_KEY=<YOUR_NEW_RELIC_LICENSE_KEY>
    volumes:
      - ./config.yaml:/etc/otelcol-nr/config.yaml
    restart: unless-stopped

核心配置说明

环境变量

• NEW_RELIC_LICENSE_KEY（必填）：New Relic账户的许可证密钥，用于将数据发送至New Relic平台
• OTEL_EXPORTER_OTLP_ENDPOINT（可选）：自定义OTLP导出端点，默认为New Relic OTLP端点

配置文件

需通过挂载配置文件（通常为config.yaml）定义数据收集规则。配置文件应包含以下核心组件：

• receivers：定义数据接收方式（如OTLP、Prometheus、Jaeger等）
• processors：定义数据处理逻辑（如批处理、过滤、转换等）
• exporters：定义数据导出目标（默认配置已包含New Relic导出器）
• service：指定启用的接收器、处理器和导出器

详细配置示例可参考官方配置文档。