IBM Netcool Operations Insight Event Integrations Operator 镜像文档

镜像概述和主要用途

IBM Netcool Operations Insight Event Integrations Operator（以下简称“事件集成操作器”）是基于Kubernetes Operator模式构建的容器化组件，作为IBM Netcool Operations Insight产品套件的一部分，用于在Kubernetes集群中管理事件集成资源。其核心用途是实现运维事件的标准化集成、转换与流转，支持与多类监控系统（如Prometheus、Zabbix、ELK Stack等）的事件互通，简化企业级运维事件的全生命周期管理流程。

核心功能和特性

1. Operator模式管理

• 基于Kubernetes Operator框架，通过自定义资源（CR）声明式管理事件集成配置，支持资源的创建、更新、删除全生命周期自动化。
• 内置健康检查与自愈能力，确保事件集成资源稳定运行。

2. 事件集成与转换

• 支持事件格式标准化转换，可将不同监控系统的原生事件（如Prometheus Alert、Zabbix Event）转换为Netcool标准事件格式。
• 提供可配置的事件过滤、 enrichment（补充字段）、路由规则，满足复杂业务场景需求。

3. 多系统兼容性

• 预置与主流监控工具的集成适配器，包括但不限于：Prometheus、Grafana、Zabbix、Nagios、ELK Stack等。
• 支持自定义事件源/目标适配器开发，扩展集成能力。

4. 自动化与运维增强

• 事件处理流程自动化，减少人工干预，支持事件优先级动态调整、自动升级与闭环处理。
• 集成Netcool Operations Insight的监控告警能力，提供事件状态可视化与告警通知。

使用场景和适用范围

适用场景

• 企业级运维监控环境：统一管理多团队、多区域的运维事件，实现事件标准化。
• 多监控系统集成：需将不同监控工具（如云监控、APM、日志系统）的事件集中处理与分析。
• Kubernetes集群事件管理：在容器化环境中，整合集群内（如kubelet、容器日志）与外部系统事件。
• 事件流程自动化：需自定义事件路由、转换规则，实现故障自动响应或工单联动。

适用范围

• 部署了Kubernetes集群（v1.19+）的企业数据中心或云环境。
• 已部署IBM Netcool Operations Insight核心组件的运维体系。
• 需要标准化、自动化运维事件处理流程的中大型企业。

使用方法和配置说明

前提条件

• Kubernetes集群（v1.19+），已配置kubectl命令行工具。
• IBM Netcool Operations Insight核心实例已部署（版本需与Operator兼容，具体参见IBM***兼容性矩阵）。
• 集群内已配置适当的RBAC权限（如cluster-admin或事件集成相关资源管理权限）。

部署步骤

1. 获取Operator镜像

从IBM容器镜像仓库拉取镜像（需IBM Entitled Registry访问权限）：

docker pull cp.icr.io/cp/netcool/noi-event-integrations-operator:${VERSION}

注：${VERSION}需替换为实际版本号，如1.1.0。

2. 部署Operator资源

通过Kubernetes manifests部署Operator：

kubectl apply -f [***]{VERSION}/deploy/operator.yaml

或通过Helm Chart部署（推荐生产环境）：

helm repo add ibm-netcool [***]
helm install noi-event-integrations-operator ibm-netcool/noi-event-integrations-operator \
  --namespace netcool \
  --create-namespace \
  --set image.tag=${VERSION}

配置事件集成规则

通过创建自定义资源（CR）EventIntegration配置事件集成规则，示例如下：

apiVersion: eventintegrations.noi.ibm.com/v1
kind: EventIntegration
metadata:
  name: prometheus-to-netcool
  namespace: netcool
spec:
  source:
    type: prometheus
    config:
      serviceUrl: "[***]"
      alertLabels: ["severity", "alertname"]
  target:
    type: netcool
    config:
      noiInstance: "noi-primary"
      severityMapping:
        critical: 5
        warning: 3
  transform:
    keepFields: ["alertname", "severity", "startsAt", "description"]
    addFields:
      eventSource: "prometheus"
      environment: "production"
  filter:
    severity: ["critical", "warning"]
    labels:
      env: "prod"

核心配置参数说明

环境变量配置

Operator部署时可通过环境变量调整运行参数：

验证部署

部署完成后，检查Operator Pod状态及事件集成资源：

# 检查Operator Pod
kubectl get pods -n netcool -l app=noi-event-integrations-operator

# 检查EventIntegration资源
kubectl get eventintegrations -n netcool

注意事项

• Operator版本需与Netcool Operations Insight核心实例版本匹配，具体参见IBM***文档。
• 事件源/目标系统的网络连通性需提前确保（如防火墙规则、Service暴露）。
• 大规模事件处理场景下，建议调整Operator资源限制（CPU/内存）以优化性能。