newrelic/k8s-operator

镜像概述

New Relic配置Operator是一个Kubernetes Operator，旨在简化Kubernetes集群中New Relic监控配置的创建、管理与维护流程。通过声明式方式定义New Relic配置资源（如仪表盘、告警规则、集成设置等），由Operator自动处理配置的生命周期管理，实现与Kubernetes环境的无缝集成。

核心功能和特性

• 声明式配置管理：基于Kubernetes Custom Resource Definitions (CRDs) 定义New Relic配置，符合Kubernetes原生管理模式
• 自动化配置同步：自动将Kubernetes配置资源同步至New Relic平台，确保配置状态一致性
• 全生命周期支持：覆盖配置的创建、更新、删除等完整生命周期操作，简化运维流程
• Kubernetes生态集成：与RBAC、命名空间等Kubernetes机制深度集成，支持多租户配置隔离
• 状态监控与反馈：提供配置部署状态跟踪和错误反馈，便于问题排查与调试

使用场景和适用范围

• Kubernetes监控配置管理：在Kubernetes环境中统一管理New Relic APM、基础设施监控等配置
• 多环境配置差异化：适用于开发、测试、生产等多环境下的New Relic配置差异化部署
• 大规模集群自动化：在多集群或多应用场景下，实现New Relic配置的批量管理与自动化运维

使用方法和配置说明

前提条件

• Kubernetes集群版本1.19+
• New Relic账户及有效API密钥
• 已安装kubectl命令行工具

部署步骤

1. 安装CRDs

部署Operator所需的Custom Resource Definitions：

bash
kubectl apply -f https://raw.githubusercontent.com/newrelic/newrelic-kubernetes-operator/main/config/crd/bases/newrelic.com_newrelicconfigs.yaml

2. 部署Operator

推荐使用Helm部署：

bash
helm repo add newrelic https://helm-charts.newrelic.com
helm repo update
helm install newrelic-operator newrelic/newrelic-operator \
  --namespace newrelic --create-namespace \
  --set newRelic.apiKey=<YOUR_NEW_RELIC_API_KEY>

或使用kubectl直接部署：

bash
# 创建命名空间
kubectl create namespace newrelic

# 部署Operator
kubectl apply -f https://raw.githubusercontent.com/newrelic/newrelic-kubernetes-operator/main/config/manager/manager.yaml -n newrelic

# 创建包含API密钥的Secret
kubectl create secret generic newrelic-api-key -n newrelic \
  --from-literal=new-relic-api-key=<YOUR_NEW_RELIC_API_KEY>

3. 创建New Relic配置资源

创建自定义资源文件（例如example-dashboard.yaml）：

yaml
apiVersion: newrelic.com/v1alpha1
kind: NewRelicConfig
metadata:
  name: k8s-cluster-dashboard
  namespace: newrelic
spec:
  type: dashboard
  content: |
    {
      "name": "Kubernetes Cluster Monitoring",
      "widgets": [
        {
          "title": "Pod CPU Usage",
          "type": "line",
          "data": {
            "query": "FROM Metric SELECT average(kube_pod_container_cpu_usage_seconds_total) WHERE clusterName = 'production-cluster'"
          }
        },
        {
          "title": "Pod Memory Usage",
          "type": "area",
          "data": {
            "query": "FROM Metric SELECT average(kube_pod_container_memory_usage_bytes) WHERE clusterName = 'production-cluster'"
          }
        }
      ]
    }

应用配置：

bash
kubectl apply -f example-dashboard.yaml -n newrelic

配置参数说明

环境变量

Operator部署时可配置的关键环境变量：

Custom Resource (CR) 字段

NewRelicConfig CR的核心字段：

验证部署

检查Operator运行状态：

bash
kubectl get pods -n newrelic

检查配置资源状态：

bash
kubectl get newrelicconfigs -n newrelic
kubectl describe newrelicconfig k8s-cluster-dashboard -n newrelic

验证配置已同步至New Relic：登录New Relic控制台，在对应账户下查看配置是否创建成功。