newrelic/nr-otel-collector

nr-otel-collector 镜像文档

1. 镜像概述和主要用途

nr-otel-collector 是 New Relic 推出的 OpenTelemetry Collector 分发版镜像。该镜像曾用于提供 OpenTelemetry 数据收集、处理及导出至 New Relic 平台的功能。请注意：此镜像已被官方正式弃用，不再提供维护和更新。官方推荐使用更专业化的替代镜像：

• https://hub.docker.com/r/newrelic/nrdot-collector-host%EF%BC%88%E9%80%82%E7%94%A8%E4%BA%8E%E4%B8%BB%E6%9C%BA%E7%8E%AF%E5%A2%83%EF%BC%89
• https://hub.docker.com/r/newrelic/nrdot-collector-k8s%EF%BC%88%E9%80%82%E7%94%A8%E4%BA%8E Kubernetes 环境）

更多信息请参考 https://github.com/newrelic/nrdot-collector-releases/blob/main/README.md GitHub 仓库。

2. 核心功能和特性（已弃用说明）

原 nr-otel-collector 镜像的核心功能（如遥测数据采集、协议转换、数据过滤、导出至 New Relic 等）已由上述替代镜像继承并优化。原镜像不再接收功能更新、安全补丁及 bug 修复，继续使用可能导致兼容性问题、数据采集异常或安全风险。

3. 使用场景和适用范围

nr-otel-collector 原适用于需要通过 OpenTelemetry 标准收集主机、容器或应用遥测数据（如指标、日志、追踪）并发送至 New Relic 的场景。目前，这些场景已分别由专用镜像替代：

• 主机环境监控：使用 nrdot-collector-host
• Kubernetes 集群监控：使用 nrdot-collector-k8s

4. 使用方法和配置说明（迁移指南）

由于 nr-otel-collector 已被弃用，建议立即迁移至替代镜像。迁移步骤如下：

4.1 停止并移除原容器

若当前正在运行 nr-otel-collector 容器，需先停止并移除：

bash
# 停止容器（假设容器名为 nr-otel-collector）
docker stop nr-otel-collector

# 移除容器
docker rm nr-otel-collector

4.2 拉取替代镜像

根据部署环境选择对应镜像：

bash
# 主机环境
docker pull docker.xuanyuan.run/newrelic/nrdot-collector-host:latest

# Kubernetes 环境
docker pull docker.xuanyuan.run/newrelic/nrdot-collector-k8s:latest

4.3 运行新镜像容器

替代镜像的运行命令需参考官方文档配置必要参数（如 New Relic 许可证密钥、采集配置等）。以下为基本示例：

4.3.1 主机环境（nrdot-collector-host）

bash
docker run -d \
  --name nrdot-collector-host \
  -e NEW_RELIC_LICENSE_KEY=<YOUR_NEW_RELIC_LICENSE_KEY> \
  -v /path/to/your/config.yaml:/etc/otelcol/nr/config.yaml \  # 挂载自定义配置文件（可选）
  -p 4317:4317  # gRPC 接收端口（根据需求调整）
  newrelic/nrdot-collector-host:latest

4.3.2 Kubernetes 环境（nrdot-collector-k8s）

Kubernetes 环境建议通过 Helm Chart 部署，或使用容器命令配合 ConfigMap 管理配置：

bash
docker run -d \
  --name nrdot-collector-k8s \
  -e NEW_RELIC_LICENSE_KEY=<YOUR_NEW_RELIC_LICENSE_KEY> \
  -e KUBERNETES_SERVICE_HOST=<K8S_SERVICE_HOST> \  # Kubernetes API 地址（自动注入或手动指定）
  -v /path/to/k8s/config.yaml:/etc/otelcol/nr/config.yaml \  # 挂载 K8s 专用配置
  newrelic/nrdot-collector-k8s:latest

4.4 配置参考

详细配置说明（如数据接收端口、处理器配置、导出器参数等）请查阅：

• https://github.com/newrelic/nrdot-collector-releases/blob/main/README.md
• 替代镜像的 Docker Hub 文档（https://hub.docker.com/r/newrelic/nrdot-collector-host%E3%80%81https://hub.docker.com/r/newrelic/nrdot-collector-k8s%EF%BC%89

5. 注意事项

• 安全风险：继续使用 nr-otel-collector 可能面临未修复的安全漏洞，建议优先完成迁移。
• 配置兼容性：替代镜像的配置格式可能与原镜像存在差异，需参考官方文档调整配置文件。
• 版本跟踪：定期更新替代镜像至最新版本，以获取功能优化和安全修复。

6. 参考链接

• 替代镜像 Docker Hub：
  • https://hub.docker.com/r/newrelic/nrdot-collector-host
  • https://hub.docker.com/r/newrelic/nrdot-collector-k8s
• 官方文档：https://github.com/newrelic/nrdot-collector-releases/blob/main/README.md