Grafana（2、snmp交换机仪表盘自定义）

上一篇写了安装如下插件，这里写交换机snmp数据的自定义仪表盘。

通用仪表板（AKA SNMP Network）
安装id:15473
https://grafana.com/grafana/dashboards/15473-aka-snmp-network/

华为交换机
安装id:14634
https://grafana.com/grafana/dashboards/14634-snmp/

华三交换机
我根据上面修改适配的，下载json文件导入就行。  
[【附件】SNMP_H3C交换机.json.zip](/media/attachment/2023/02/SNMP_H3C交换机.json.zip)

## 变量

| 函数                          | 作用                                       |
|-----------------------------|------------------------------------------|
| label_values(label)         | 返回Promthues所有监控指标中，标签名为label的所有可选值       |
| label_values(metric, label) | 返回Promthues所有监控指标metric中，标签名为label的所有可选值 |
| metrics(metric)             | 返回所有指标名称满足metric定义正则表达式的指标名称             |
| query_result(query)         | 返回prometheus查询语句的查询结果                    |

文档：https://yunlzheng.gitbook.io/prometheus-book/part-ii-prometheus-jin-jie/grafana/templating

参考：
[Grafana Dashboard标签筛选配置（Grafana变量查询配置）](https://blog.csdn.net/shuai_wy/article/details/106982160 "Grafana Dashboard标签筛选配置（Grafana变量查询配置）")

[Grafana Query类型模板变量的使用](https://www.jianshu.com/p/8b2630bf501a "Grafana Query类型模板变量的使用")
### 仪表盘自定义

![](/media/202302/Grafana_suoyin_1677135084.png)
最上面一行的筛选项，是可以自定义的，修改方法：点上图的设置 > Variables（变量）

**增加自定义的筛选项**
label_values(up,instance)     #label标签_values值
含义：筛选出处于up状态的服务

**例如，增加名为 IP 的筛选框**
IP   ==    label_values(ifHCInOctets,  instance)
![](/media/202302/Grafana_suoyin2_1677135125.png)

在小仪表盘中使用：
$instance  代表 instance项当前选的值
![](/media/202302/Grafana_suoyin3_1677135137.png)

**增加名为 brand 的筛选框**
1.按 [Prometheus（二、用snmp监控）](/project-10/doc-299/ "Prometheus（二、用snmp监控）") 的结尾 添加标签的方法，为每各交换机定义名如 brand 的值。
```
- labels:
    mib: HZHUAWEI
    brand: Huawei
    hostname: SH-HJ-HW5720STACK
    model: HWS5720EI
  targets:
    - 192.168.100.1
```

添加变量
brand  ==  label_values(up,brand)
![](/media/202302/Grafana_suoyin5_1677154851.png)

效果
![](/media/202302/Grafana_suoyin4_1677154978.png)

#### 变量联动

先选brand值，根据brand值再筛选显示ip
变量设置如下：
```
brand          label_values(up,brand)
ip             label_values(up{brand="$brand"},instance)  #查询表达式，获取变量instance的值
```

## 查找字段含义
在 [Prometheus（二、用snmp监控）](/project-10/doc-299/ "Prometheus（二、用snmp监控）")中讲到的 用generator.yml 生成的 **snmp.yml文件**里面自带oid的含义注释。

例如的其中一段：
```
  - name: sysDescr
    oid: 1.3.6.1.2.1.1.1
    type: DisplayString
    help: A textual description of the entity - 1.3.6.1.2.1.1.1#help：实体的文本描述-1.3.6.1.2.1.1.1
  - name: hh3cEntityExtTemperature
    oid: 1.3.6.1.4.1.25506.2.6.1.1.1.1.12
    type: gauge
    help: The temperature for the entity. - 1.3.6.1.4.1.25506.2.6.1.1.1.1.12#help：实体的温度。-1.3.6.1.4.1.25506.2.6.1.1.1.1.12
```
由 snmp.yml文件 得知，代表温度的字段为：hh3cEntityExtTemperature

点击仪表板中图形上的编辑按钮，
![](/media/202302/Grafana_snmp_1675430149.png)
按下图顺序输入字段和筛选项，
![](/media/202302/Grafana_snmp1_1675430043.png)
再点最下面的Use query使用查询，温度数据就显示出来了

有多个设备时，需添加筛选ip条件
```
# instance="$IP"

hh3cEntityExtMemUsage{hh3cEntityExtPhysicalIndex="212", instance="$IP"}
```
![](/media/202302/Grafana_snmp_h3c_mem_1675825688.png)

**显示oid下所有内容，获取有用的索引号**
```
# 测试机器获取OID信息
snmpwalk -v 2c -c 123456 172.18.48.5 1.3.6.1.4.1.25506.2.6.1.1.1.1.12

```