elastiflow/snmp-collector

概述

ElastiFlow Unified SNMP Collector 是一款超越简单SNMP轮询器的高级数据采集工具，专为满足最严苛的生产环境要求而设计。用户可通过 https://github.com/elastiflow/snmp 获取最新SNMP定义文件。

特性

• 生产级稳定性：针对高负载环境优化，确保持续可靠运行
• 灵活配置能力：支持通过目录结构管理SNMP设备、对象及组定义
• 丰富数据处理：提供IP地址解析、ASN查找、字段过滤等数据加工功能
• 多目标输出：兼容Elasticsearch、OpenSearch、Kafka、Splunk HEC等多种数据平台
• 持久化存储：支持采集状态持久化，提升服务重启后的恢复效率

使用场景

• 企业级网络设备监控（交换机、路由器、防火墙等SNMP-enabled设备）
• 数据中心基础设施性能指标采集与分析
• 网络运维自动化中的SNMP数据集中处理
• 与日志分析平台集成构建完整可观测性方案

Docker部署方案

以下是基于Docker Compose的部署示例：

yaml
services:
  snmp-collector:
    image: elastiflow/snmp-collector:7.17.0
    container_name: snmp-collector
    restart: 'unless-stopped'
    network_mode: 'host'  # 采用主机网络模式确保SNMP通信正常
    volumes:
      - /etc/elastiflow:/etc/elastiflow  # 挂载SNMP配置目录（设备定义、对象定义等）
      - /usr/share/elastiflow/snmpcoll:/usr/share/elastiflow/snmpcoll  # 挂载持久化存储目录
    environment:
      # 许可证配置
      EF_LICENSE_ACCEPTED: "false"  # 生产环境需设置为"true"以接受许可证协议
      # 输入配置
      EF_INPUT_SNMP_ENABLE: "true"  # 启用SNMP采集功能
      EF_INPUT_SNMP_PERSIST_ENABLE: "true"  # 启用持久化存储
      # 处理器配置
      EF_PROCESSOR_ENRICH_IPADDR_DNS_ENABLE: "false"  # 禁用DNS解析（根据需求调整）
      # 输出配置（示例：Elasticsearch）
      EF_OUTPUT_ELASTICSEARCH_ENABLE: "false"  # 启用需设置为"true"
      EF_OUTPUT_ELASTICSEARCH_ADDRESSES: 127.0.0.1:9200  # Elasticsearch服务地址
      EF_OUTPUT_ELASTICSEARCH_USERNAME: elastic
      EF_OUTPUT_ELASTICSEARCH_PASSWORD: changeme
      # 其他输出目标（Kafka/Splunk等）通过对应EF_OUTPUT_*变量配置

配置说明

系统通过环境变量实现全面配置，核心配置类别包括：

• 输入管理：控制SNMP轮询行为（EF_INPUT_SNMP_*），如设备定义路径、工作池大小、错误处理策略等
• 数据处理：配置数据加工规则（EF_PROCESSOR_*），支持字段过滤、IP地理信息补充、SNMP枚举转换等
• 输出目标：定义数据分发方向（EF_OUTPUT_*），可同时配置多个输出端（如Kafka消息队列、Splunk HEC接口等）
• 系统参数：调整日志级别（EF_LOGGER_*）、API服务（EF_API_*）及实例标识（EF_INSTANCE_NAME）等基础设置

完整配置项可参考容器内置文档或官方GitHub仓库说明。