measurementlab/disco

DISCOv2 镜像文档

概述

DISCOv2是https://github.com/m-lab/collectd-mlab%E4%B8%ADDISCO%E7%BB%84%E4%BB%B6%E7%9A%84Go%E8%AF%AD%E8%A8%80%E9%87%8D%E5%AE%9E%E7%8E%B0%E7%89%88%E6%9C%AC%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E6%98%AF%E6%AF%8F10%E7%A7%92%E6%8E%A2%E6%B5%8B%E4%BA%A4%E6%8D%A2%E6%9C%BA%E7%9A%84%E5%90%84%E7%B1%BB%E6%B5%81%E9%87%8F%E6%8C%87%E6%A0%87%EF%BC%8C%E5%AE%9A%E6%9C%9F%E5%B0%86%E7%BB%93%E6%9E%9C%E4%BB%A5JSON%E6%A0%BC%E5%BC%8F%E5%86%99%E5%85%A5%E6%96%87%E4%BB%B6%EF%BC%8C%E8%BF%99%E4%BA%9B%E6%96%87%E4%BB%B6%E5%8F%AF%E7%94%B1Pusher%E4%B8%8A%E4%BC%A0%E8%87%B3GCS%EF%BC%8C%E8%BF%9B%E8%80%8C%E5%A4%84%E7%90%86%E8%A7%A3%E6%9E%90%E8%87%B3BigQuery%E3%80%82%E4%B8%8E%E5%8E%9FDISCO%E7%9B%B8%E6%AF%94%EF%BC%8CDISCOv2%E6%96%B0%E5%A2%9E%E4%BA%86Prometheus%E6%8C%87%E6%A0%87%E5%AF%BC%E5%87%BA%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%8F%AF%E6%9A%B4%E9%9C%B2%E5%B7%B2%E6%94%B6%E9%9B%86%E7%9A%84%E6%8C%87%E6%A0%87%E3%80%82

核心功能与特性

• 定期指标采集：每10秒探测目标交换机，获取流量相关指标
• JSON文件输出：按配置间隔将收集的指标转换为JSON格式写入磁盘
• Prometheus集成：内置Prometheus exporter，可通过指定地址暴露指标
• 自定义指标配置：支持通过YAML文件定义需采集的指标
• SNMP协议支持：通过SNMP协议与交换机通信，需配置社区字符串

使用场景

适用于需要监控交换机流量指标的环境，尤其适合需要将指标持久化存储（如GCS/BigQuery）并通过Prometheus进行实时监控的场景，典型应用如M-Lab Kubernetes集群的网络监控。

使用方法与配置说明

环境变量

命令行参数

配置文件

需提供YAML格式的指标配置文件，定义需要采集的指标。示例配置可参考项目中的metrics.yaml.sample，实际生产环境配置可参考https://github.com/m-lab/k8s-support/blob/master/config/disco/metrics.yaml%E3%80%82

部署示例

Docker Run命令

bash
docker run -d \
  -e DISCO_COMMUNITY=your_snmp_community \
  -v /path/to/metrics.yaml:/config/metrics.yaml \
  --name discov2 \
  m-lab/discov2:latest \
  --prometheusx.listen-address=:9090 \
  --metrics-file=/config/metrics.yaml \
  --write-interval=5m \
  --target=switch.example.com

Docker Compose配置

yaml
version: '3'
services:
  discov2:
    image: m-lab/discov2:latest
    environment:
      - DISCO_COMMUNITY=your_snmp_community
    volumes:
      - ./metrics.yaml:/config/metrics.yaml
    command: >
      --prometheusx.listen-address=:9090
      --metrics-file=/config/metrics.yaml
      --write-interval=5m
      --target=switch.example.com
    ports:
      - "9090:9090"