vaporio/openconfig-plugin

Synse OpenConfig gRPC遥测插件镜像

镜像概述

本镜像为Synse生态系统的插件组件，专门用于通过OpenConfig over gRPC协议从支持OpenConfig规范的网络设备、服务器或工业设备中采集遥测数据。作为Synse平台的扩展，它提供了标准化的数据采集接口，可无缝集成到各类监控系统中，实现对目标设备运行状态、性能指标等数据的实时收集。

核心功能与特性

• OpenConfig协议支持：通过gRPC协议与遵循OpenConfig规范的设备通信，获取标准化遥测数据
• Synse平台集成：符合Synse插件接口标准，可直接接入Synse监控系统，实现数据统一管理
• 灵活配置能力：支持自定义gRPC连接参数（地址、端口、认证方式等）及数据采集间隔
• 标准化数据输出：统一遥测数据格式，便于后续存储、分析和可视化
• 轻量级设计：基于精简基础镜像构建，资源占用低，适合边缘计算和容器化部署场景

使用场景与适用范围

• 网络设备监控：采集交换机、路由器等支持OpenConfig的网络设备接口流量、CPU利用率等指标
• 数据中心基础设施：监控服务器、存储设备的硬件状态和性能数据
• 工业物联网：从工业控制设备、传感器获取运行状态和环境数据
• 监控系统集成：作为数据采集层，为Prometheus、Grafana等监控工具提供标准化数据源

使用方法与配置说明

获取镜像

从Docker镜像仓库拉取最新版本：

bash
docker pull docker.xuanyuan.run/synse/openconfig-grpc-plugin:latest

基本运行命令

bash
docker run -d \
  --name synse-openconfig-plugin \
  -e GRPC_SERVER_ADDR=192.168.1.100 \
  -e GRPC_SERVER_PORT=50051 \
  -e COLLECTION_INTERVAL=30s \
  docker.xuanyuan.run/synse/openconfig-grpc-plugin:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'

services:
  synse-openconfig-plugin:
    image: docker.xuanyuan.run/synse/openconfig-grpc-plugin:latest
    container_name: synse-openconfig-plugin
    restart: unless-stopped
    environment:
      - GRPC_SERVER_ADDR=router-prod-01.example.com
      - GRPC_SERVER_PORT=50051
      - COLLECTION_INTERVAL=60s
      - GRPC_TLS_ENABLED=true
      - LOG_LEVEL=debug
    volumes:
      - ./tls:/etc/synse/tls  # 挂载本地TLS证书目录到容器内
    network_mode: host  # 如需直接访问主机网络中的设备可启用

数据输出格式

插件采集的遥测数据遵循Synse标准格式，示例如下：

json
{
  "timestamp": "2023-11-01T08:30:00Z",
  "device": "router-prod-01",
  "type": "interface_metrics",
  "context": {
    "interface": "eth0"
  },
  "readings": [
    {
      "name": "in_bytes",
      "value": 2568900,
      "unit": "bytes"
    },
    {
      "name": "out_bytes",
      "value": ***,
      "unit": "bytes"
    },
    {
      "name": "error_rate",
      "value": 0.002,
      "unit": "ratio"
    }
  ]
}