SNMP 协议

基础配置信息

• agents 列表(snmp_agents)：snmp 代理地址, 当有多个 agents 时, 地址使用 ',' 分割。

• tebles 配置(snmp_tables)：程序将会使用 Walk 请求来获取字段数据, 需要填入一个符合 json 数组格式的字符串, 数组中的每一项有以下字段：

  • table_name: 选填项，表格变量的名称，当该项为空时，会根据 table_oid 字段解析出来的内容填充
  • table_oid: 必填项 表格变量的 对象标识符
  • table_fields: 选填项，除了从 `table_oid 中解析出来的字段外，还可以根据此配置项将简单变量放入其中

• fields 配置(snmp_fields)：程序将会使用 Get 请求来获取字段数据, 需要填入一个符合 json数组 格式的字符串, 数组中的每一项有以下字段：

  • field_name: 选填项，字段名称, 当该项为空时，会根据 field_oid 字段解析出来的内容为空
  • field_oid: 必填项 字段的 对象标识符
  • field_oid_index_suffix: 选填项，填写后会剥离 field_oid 的子标示符便于将其与其他字段匹配。

高级选项

• 名称(snmp_reader_name)：默认 system, 对于简单变量(snmp_fields中的字段), 将把该字段放入收集的数据中, 所谓标识, 类似于 table_name。

• 连接超时时间(snmp_time_out): 默认 5s, 超时时间。【如果snmp_tables数据项比较多，5s返回时间太短，建议调整为100s】

• 收集频率(snmp_interval): 默认 30s, 采集频率。

• 重试次数(snmp_retries):默认 3, 重试次数。

• 最大迭代次数(snmp_max_repetitions): 默认为 50, 变量检索次数的最大值, 用来指示 getBulk 命令, 尝试 snmp_max_repetitions 次 getNext 操作。

• 安全等级(snmp_sec_level)：默认为 noAuthNoPriv1, snmp 安全等级, 支持 "noAuthNoPriv", "authNoPriv", "authPriv" 三种。

• 认证协议(snmp_auth_protocol)：认证协议, 支持 "", "md5", "sha" 三种。

• 认证密码(snmp_auth_password)：为了不在配置中明文存储，我们在 1.0.4 版本及以后支持使用环境变量的方式填写该字段，填写方式为：${YOUR_ENV}，其中 YOUR_ENV 为环境变量，需要在机器上将该环境变量设置为原先要填写的值，YOUR_ENV 可以根据您的实际使用需求进行修改。

• 隐私协议(snmp_priv_protocol)：加密协议, 支持 "", "des", "aes" 三种。

!>注意: snmp_fields 和 snmp_tables 这两项配置需要填入符合 json 数组格式的字符串, 字符串内的双引号需要转义

验证Agent到SNMP数据源网络通畅方案

（1）由于snmp是UDP的协议，故无法直接使用telnet来测试agent到设备的端口是否通，需要在logkit-pro所在的机器，安装nmap工具来探测对方snmp端口是否通畅。
nmap -n -sU -p161 +设备ip
这样可以测试udp端口是否通，通的状态是state open并且需要确认这个open是否被拦截了，如果样式是open|filtered 则表示snmp是filtered拦截状态，表示网络不通被拦截了，需要找客户运维团队开通防火墙限制

（2）测试网络通畅之后，可以使用snmpwalk做测试数据采集。
snmpwalk -v <版本号,一般是1、2c、3> 设备ip -c 客户给的community 1.3.6.1.2.1.1.5
1.3.6.1.2.1.1.5 是通用的通过snmp抓取机器名的命令

做好以上的测试之后，恭喜你，表示网络通畅并且可以采集到snmp数据了

安装配置 SNMP Agent 教程

首先要区分清楚的概念是 logkit-pro agent 与 SNMP Agent 不是一个东西， SNMP Agent存在于各个机器(或网络设备)之上，接收SNMP请求，返回对应的监控内容。

一般情况下，这两个 agent 不会运行在同一个机器（如某些网络设备logkit-pro无法直接安装在其之上，但是厂商默认支持SNMP协议，即该网络设备已经安装了SNMP Agent），因此这里的步骤做分开介绍。如果恰巧 logkit-pro 和 SNMP 的 agent 都运行在同一台机器上，则只需要合并两份步骤，略过重复的部分即可。

运行 logkit-pro agent 的机器

• 防火墙打开 TCP 3000 端口（根据 logkit-pro 实际监听端口决定）
• 安装 SNMP 相关软件包

# Ubuntu 环境
$ sudo apt update
$ sudo apt install snmp
$ sudo apt install snmp-mibs-downloader

# CentOS 7 环境
$ sudo yum install net-snmp-utils

• 修改 /etc/snmp/snmp.conf 以便加载所有支持的 MIB 库（注释掉所有行，CentOS 7 无需此步骤）

#mibs :

• 从安装的 snmp-mibs-downloader 样例文件中复制 Cisco 相关的 MIB 文件列表到指定位置（CentOS 7 无需此步骤）

$ sudo cp /usr/share/doc/snmp-mibs-downloader/examples/cisco* /etc/snmp-mibs-downloader/
$ cd /etc/snmp-mibs-downloader && sudo gzip -d ciscolist.gz

• 修改 /etc/snmp-mibs-downloader/snmp-mibs-downloader.conf 为以下内容（CentOS 7 无需此步骤）

BASEDIR=/var/lib/mibs
AUTOLOAD="rfc ianarfc iana cisco"

• 修改 /etc/snmp-mibs-downloader/cisco.conf 为以下内容（CentOS 7 无需此步骤）

HOST=ftp://ftp.cisco.com
ARCHIVE=v2.tar.gz
ARCHTYPE=tgz
DIR=pub/mibs/v2/
ARCHDIR=auto/mibs/v2
CONF=ciscolist
DEST=cisco

• 执行如下命令，根据之前复制的样例文件实际下载 Cisco 相关的 MIB 文件（CentOS 7 无需此步骤）

$ sudo download-mibs

• 配置 logkit（以及常用配置的 JSON）

• 常用的 tables配置 可以参考该链接：http://pandora-dl.qiniu.com/snmp_reader_sample_table_fields.json
• 提交配置后等待数秒（根据网络状况）即可创建成功

运行 SNMP Agent 的机器

指被收集的机器为了支持SNMP协议需要安装SNMP Agent，一般情况下被收集的目标已经支持SNMP协议收集就无需再安装

• 防火墙打开 UDP 161 端口
• 安装 SNMP 相关软件包

# Ubuntu 环境
$ sudo apt update
$ sudo apt install snmpd
$ sudo apt install snmp-mibs-downloader

# CentOS 7 环境
$ sudo yum install net-snmp net-snmp-utils
$ sudo yum install polkit

• 修改 /etc/snmp/snmpd.conf 以便外部访问

# Ubuntu 环境，注释行 2、5、6，添加行 4、7
1. # Listen for connections from the local system only
2. #agentAddress udp:127.0.0.1:161 
3. # Listen for connections on all interfaces (both IPv4 *and* IPv6)
4. agentAddress udp:161,udp6:[::1]:161
...
5. #view systemonly included .1.3.6.1.2.1.1
6. #view systemonly included .1.3.6.1.2.1.25.1
7. view systemonly included .1


# CentOS 7 环境，注释行 1、2，添加行 3、4
1. #view systemview included .1.3.6.1.2.1.1
2. #view systemview included .1.3.6.1.2.1.25.1.1
3. view systemview included .1
4. agentAddress udp:161,udp6:[::1]:161

• 重启 snmpd 服务

# Ubuntu 环境
$ sudo /etc/init.d/snmpd restart

# CentOS 7 环境
$ sudo systemctl restart snmpd

常用的 SNMP 字段节点

以下为常用的 SNMP 字段节点，可以放置在 tebles 配置(snmp_tables) 的 table_fields 中或 fields 配置(snmp_fields)。

• 系统参数（1.3.6.1.2.1.1）

• 网络接口（1.3.6.1.2.1.2）

• CPU及负载

• 内存及磁盘（1.3.6.1.2.1.25）

• System Group

• Process Group

• System Group

• Storage Group

• Disk Group

• Diskio Group

• Mem Group

• Interfaces Group

• IP Group

• ICMP Group

• TCP Group

• UDP Group

• SNMP Group

其他 OID 的查询请参考:

http://www.oid-info.com/index.htm

http://cric.grenoble.cnrs.fr/Administrateurs/Outils/MIBS/?oid=1

http://www.alvestrand.no/objectid/top.html