bgernert/docker-telegraf

包含Python3和pysnmp4的Telegraf Docker容器

镜像概述和主要用途

本镜像基于官方Telegraf Docker镜像构建，扩展集成了Python3环境和pysnmp4模块。主要用途是允许在Telegraf容器内直接运行Python3脚本，并通过pysnmp4实现与其他设备的SNMP协议通信，适用于需要通过Python处理SNMP数据的监控场景。

更多关于基础Telegraf镜像的信息可参考https://registry.hub.docker.com/_/telegraf/%E3%80%82

核心功能和特性

• 基础功能继承：保留官方Telegraf镜像的全部功能，支持各类指标采集和输出
• Python3环境：预装Python3运行环境，可直接执行Python3脚本
• SNMP支持：集成pysnmp4模块，提供SNMP协议通信能力，支持SNMPv1/v2c/v3
• 兼容性：与官方Telegraf配置方式完全兼容，可无缝迁移现有Telegraf配置

使用场景和适用范围

• 网络设备监控：通过Python脚本采集网络设备的SNMP指标
• 自定义数据处理：对SNMP采集的数据进行Python自定义处理后再由Telegraf输出
• 复杂监控逻辑：实现Telegraf原生插件无法满足的复杂SNMP数据采集逻辑
• 边缘计算场景：在资源受限环境中整合SNMP采集与Python数据处理能力

使用方法和配置说明

拉取镜像

bash
docker pull [镜像名称]  # 请替换为实际镜像名称

基本运行命令

bash
docker run -d \
  --name telegraf-python-snmp \
  -v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf \
  -v /path/to/python/scripts:/scripts \
  [镜像名称]

配置说明

1. Telegraf配置文件：需挂载自定义telegraf.conf，配置示例（通过exec插件运行Python脚本）：

toml
[[inputs.exec]]
  commands = ["python3 /scripts/snmp_collector.py"]
  interval = "10s"
  timeout = "5s"
  data_format = "influx"

2. Python脚本放置：将SNMP采集脚本（如snmp_collector.py）挂载到容器内指定路径（如/scripts）

3. SNMP脚本示例：使用pysnmp4的基础SNMP采集脚本

python
from pysnmp.hlapi import *

def snmp_get():
    errorIndication, errorStatus, errorIndex, varBinds = next(
        getCmd(SnmpEngine(),
               CommunityData('public', mpModel=0),
               UdpTransportTarget(('192.168.1.1', 161)),
               ContextData(),
               ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0')))  # 系统描述OID
    )
    
    if errorIndication:
        print(errorIndication)
    elif errorStatus:
        print('%s at %s' % (errorStatus.prettyPrint(),
                            errorIndex and varBinds[int(errorIndex)-1][0] or '?'))
    else:
        for varBind in varBinds:
            print(' = '.join([x.prettyPrint() for x in varBind]))

if __name__ == "__main__":
    snmp_get()

Docker Compose配置示例

yaml
version: '3'
services:
  telegraf:
    image: [镜像名称]
    container_name: telegraf-python-snmp
    volumes:
      - ./telegraf.conf:/etc/telegraf/telegraf.conf
      - ./scripts:/scripts
    restart: always
    network_mode: host  # 如需访问本地网络设备，建议使用host网络模式