Access Point Registration Table: различия между версиями

Материал из noname.com.ua
Перейти к навигацииПерейти к поиску
 
(не показано 18 промежуточных версий этого же участника)
Строка 3: Строка 3:
 
[[Категория:SNMP]]
  
[[Категория:SNMP]]
 
[[Категория:Zabbix]]
  
[[Категория:Zabbix]]
  +
  +
 
=Таблица уровней клиентов для точек доступа Cisco=
  
=Таблица уровней клиентов для точек доступа Cisco=
 
==Задача==
  
==Задача==
Строка 91: Строка 93:
 
==Разбор OID==
  
==Разбор OID==
 
Как можно видеть, сам OID состоит из нескольких частей
  
Как можно видеть, сам OID состоит из нескольких частей
  +
<BR>
 
Для определенности рассмотрим уровни сигнала:
  
Для определенности рассмотрим уровни сигнала:
 
<PRE>
  
<PRE>
Строка 101: Строка 104:
 
</PRE>
  
</PRE>
 
Часть .1.3.6.1.4.1.9.9.273.1.3.1.1.3 это и есть OID CISCO-DOT11-ASSOCIATION и она общая
 
Часть .1.3.6.1.4.1.9.9.273.1.3.1.1.3 это и есть OID CISCO-DOT11-ASSOCIATION и она общая
  +
<BR>
 
Далее в самом OID закодировано значение "кому принадлежит сигнал", т е какому клиенту
  
Далее в самом OID закодировано значение "кому принадлежит сигнал", т е какому клиенту
   
Строка 113: Строка 117:
 
Есть дока но мне она не нравится =)
  
Есть дока но мне она не нравится =)
 
* https://www.zabbix.com/documentation/5.2/ru/manual/discovery/low_level_discovery/snmp_oids
  
* https://www.zabbix.com/documentation/5.2/ru/manual/discovery/low_level_discovery/snmp_oids
  +
  +
В моем случае правило автообнаружения выглядит так:
  +
<BR>
  +
[[Изображение:Zabbix Discovery.png|600px]]
  +
</BR>
   
 
В целом идея такая:
  
В целом идея такая:
Строка 214: Строка 223:
 
который уже содержит статическую информацию о клиенте и который можно использовать для создания элеметов данных
  
который уже содержит статическую информацию о клиенте и который можно использовать для создания элеметов данных
   
−
==Прототпипы жлементов данных==
 +
==Прототпипы элементов данных==
 
Формируем имя и ключ на основе данных из Json, например
 
Формируем имя и ключ на основе данных из Json, например
 
<PRE>
  
<PRE>
 
Name cDot11ClientSignalStrength [ {#MAC}@{#DOT1RADIO_IFNAME}:{#SSID} ]
  
Name cDot11ClientSignalStrength [ {#MAC}@{#DOT1RADIO_IFNAME}:{#SSID} ]
 
</PRE>
  
</PRE>
−
где для кажого клиента будет создан отдельный элемент данных, при этом используются три уникальных значения, клиент с тем же маком но подключившись в другом диапазоне (другой интерфейс) рассматривается как другой клиент даже если используется один SSID для разных частот)
 +
где для кажого клиента будет создан отдельный элемент данных, <BR>
  +
при этом используются три уникальных значения. <BR>
  +
<BR>
  +
Другими словами ключ (SNMP OID) составляется из префикса который статичен для каждого типа данных и суффкса который SNMPINDEX и зависит от клиента (мака, SSID и интерфейса)
  +
<BR>
  +
Клиент с тем же маком но подключившись в другом диапазоне (другой интерфейс) рассматривается как другой клиент даже если используется один SSID для разных частот)
  +
<BR>
  +
[[Изображение:Item Prototype.png|600px]]
  +
<BR>
  +
Все элементы данных в целом полностью аналогичны
  +
  +
==Готовый Темплейт==
  +
{{#spoiler:show=zabbix template|
   
−
==Темплейт==
  
 
<PRE>
  
<PRE>
 
<?xml version="1.0" encoding="UTF-8"?>
  
<?xml version="1.0" encoding="UTF-8"?>
 
<zabbix_export>
  
<zabbix_export>
 
<version>5.0</version>
  
<version>5.0</version>
−
<date>2022-08-20T17:54:46Z</date>
 +
<date>2022-08-21T13:15:45Z</date>
 
<groups>
  
<groups>
 
<group>
  
<group>
Строка 259: Строка 279:
 
</applications>
  
</applications>
 
<discovery_rules>
  
<discovery_rules>
  +
<discovery_rule>
  +
<name>cDot11ActiveWirelessClientsCount</name>
  +
<type>SNMP_AGENT</type>
  +
<snmp_oid>discovery[{#CLIENTSCOUNT},1.3.6.1.4.1.9.9.273.1.1.2.1.1]</snmp_oid>
  +
<key>cDot11ActiveWirelessClientsCount</key>
  +
<lifetime>300d</lifetime>
  +
<item_prototypes>
  +
<item_prototype>
  +
<name>cDot11ActiveWirelessClientsCount [ {#DOT1RADIO_IFNAME} ]</name>
  +
<type>SNMP_AGENT</type>
  +
<snmp_oid>1.3.6.1.4.1.9.9.273.1.1.2.1.1.{#SNMPINDEX}</snmp_oid>
  +
<key>cDot11ActiveWirelessClientsCount[{#DOT1RADIO_IFNAME}]</key>
  +
<units>Devices</units>
  +
<applications>
  +
<application>
  +
<name>cDot11Clients</name>
  +
</application>
  +
</applications>
  +
</item_prototype>
  +
</item_prototypes>
  +
<graph_prototypes>
  +
<graph_prototype>
  +
<name>cDot11ActiveWirelessClientsCoun [ {#DOT1RADIO_IFNAME} ]</name>
  +
<graph_items>
  +
<graph_item>
  +
<sortorder>1</sortorder>
  +
<color>1A7C11</color>
  +
<item>
  +
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
  +
<key>cDot11ActiveWirelessClientsCount[{#DOT1RADIO_IFNAME}]</key>
  +
</item>
  +
</graph_item>
  +
</graph_items>
  +
</graph_prototype>
  +
</graph_prototypes>
  +
<preprocessing>
  +
<step>
  +
<type>JAVASCRIPT</type>
  +
<params>Zabbix.Log(3, value)
  +
  +
var records = JSON.parse(value);
  +
  +
for (i = 0; i &lt; records.length; i++) {
  +
var dot1RadioIfIndex = records[i][&quot;{#SNMPINDEX}&quot;]
  +
records[i]['{#DOT1RADIO_IFINDEX}'] = dot1RadioIfIndex
  +
records[i]['{#DOT1RADIO_IFNAME}'] = &quot;Dot11Radio&quot; + (parseInt(dot1RadioIfIndex) - 1).toString()
  +
}
  +
Zabbix.Log(3, JSON.stringify(records))
  +
return JSON.stringify(records);</params>
  +
</step>
  +
</preprocessing>
  +
</discovery_rule>
 
<discovery_rule>
  
<discovery_rule>
 
<name>CISCO-DOT11-ASSOCIATION-MIB</name>
  
<name>CISCO-DOT11-ASSOCIATION-MIB</name>
Строка 703: Строка 775:
 
<step>
  
<step>
 
<type>JAVASCRIPT</type>
  
<type>JAVASCRIPT</type>
−
<params>debugPrefix = &quot;TESTING\n&quot;
 +
<params>//debugPrefix = &quot;TESTING\n&quot;
−
Zabbix.Log(3, &quot;------------------------&quot;)
 +
//Zabbix.Log(3, &quot;------------------------&quot;)
−
Zabbix.Log(3, debugPrefix + &quot;this is a log entry written with 'Warning' log level&quot;)
 +
//Zabbix.Log(3, debugPrefix + &quot;this is a log entry written with 'Warning' log level&quot;)
−
Zabbix.Log(3, debugPrefix + value)
 +
//Zabbix.Log(3, debugPrefix + value)
−
Zabbix.Log(3, &quot;------------------------&quot;)
 +
//Zabbix.Log(3, &quot;------------------------&quot;)
   
   
Строка 740: Строка 812:
 
records[i]['{#SSID}'] = SSID
  
records[i]['{#SSID}'] = SSID
 
}
  
}
−
Zabbix.Log(3, &quot;------------------------&quot;)
 +
//Zabbix.Log(3, &quot;------------------------&quot;)
 
Zabbix.Log(3, JSON.stringify(records))
  
Zabbix.Log(3, JSON.stringify(records))
 
return JSON.stringify(records);
  
return JSON.stringify(records);
Строка 754: Строка 826:
 
<screens>
  
<screens>
 
<screen>
  
<screen>
−
<name>Clients</name>
 +
<name>cDot11ActiveWirelessClientsBytesRxTx</name>
 
<hsize>1</hsize>
  
<hsize>1</hsize>
−
<vsize>5</vsize>
 +
<vsize>1</vsize>
 
<screen_items>
  
<screen_items>
 
<screen_item>
  
<screen_item>
Строка 765: Строка 837:
 
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
  
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
 
</resource>
  
</resource>
−
<width>1500</width>
 +
<width>500</width>
 
<height>200</height>
  
<height>200</height>
 
<x>0</x>
  
<x>0</x>
Строка 780: Строка 852:
 
<max_columns>3</max_columns>
  
<max_columns>3</max_columns>
 
</screen_item>
  
</screen_item>
  +
</screen_items>
  +
</screen>
  +
<screen>
  +
<name>cDot11ActiveWirelessClientsCount</name>
  +
<hsize>1</hsize>
  +
<vsize>1</vsize>
  +
<screen_items>
  +
<screen_item>
  +
<resourcetype>20</resourcetype>
  +
<style>0</style>
  +
<resource>
  +
<name>cDot11ActiveWirelessClientsCoun [ {#DOT1RADIO_IFNAME} ]</name>
  +
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
  +
</resource>
  +
<width>800</width>
  +
<height>300</height>
  +
<x>0</x>
  +
<y>0</y>
  +
<colspan>1</colspan>
  +
<rowspan>1</rowspan>
  +
<elements>0</elements>
  +
<valign>0</valign>
  +
<halign>0</halign>
  +
<dynamic>0</dynamic>
  +
<sort_triggers>0</sort_triggers>
  +
<url/>
  +
<application/>
  +
<max_columns>3</max_columns>
  +
</screen_item>
  +
</screen_items>
  +
</screen>
  +
<screen>
  +
<name>cDot11ActiveWirelessClientsSignalLevels</name>
  +
<hsize>1</hsize>
  +
<vsize>1</vsize>
  +
<screen_items>
 
<screen_item>
  
<screen_item>
 
<resourcetype>20</resourcetype>
  
<resourcetype>20</resourcetype>
Строка 787: Строка 895:
 
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
  
<host>Template Module Cisco CISCO-DOT11-ASSOCIATION-MIB</host>
 
</resource>
  
</resource>
−
<width>1500</width>
 +
<width>500</width>
 
<height>200</height>
  
<height>200</height>
 
<x>0</x>
  
<x>0</x>
−
<y>1</y>
 +
<y>0</y>
 
<colspan>1</colspan>
  
<colspan>1</colspan>
 
<rowspan>1</rowspan>
  
<rowspan>1</rowspan>
Строка 808: Строка 916:
 
</templates>
  
</templates>
 
</zabbix_export>
  
</zabbix_export>
−  
 
</PRE>
  
</PRE>
  +
}}

Текущая версия на 10:17, 25 сентября 2022


Таблица уровней клиентов для точек доступа Cisco

Задача

Собирать данные о траффике и уровне сигнала с точек доступа

  • Клиенты динамические, их мак-адреса заранее не известны
  • SSID добавляются и удаляются по мере необходимости
  • Точки могут иметь как один интерфейс так и два


Для того что бы получить информацию по SNMP о клиентах подключенных к точке доступа, существует специальный MIB CISCO-DOT11-ASSOCIATION-MIB
Он доступен достаточно давно, как минимум он работает на точках 1200 и 1100 серий, ну и на более современных тоже.


Просмотр OID

Пример с использованием display-hint 

# snmpwalk -v2c -c MON 192.168.77.2  .1.3.6.1.4.1.9.9.273.1.3.1   -OX

CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientCurrentTxRateSet[1]["450"][STRING: da:20:60:64:36:95] = Hex-STRING: 07
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientCurrentTxRateSet[2]["450"][STRING: a4:45:19:5a:ef:48] = Hex-STRING: 01
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientUpTime[1]["450"][STRING: da:20:60:64:36:95] = Gauge32: 15898 second
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientUpTime[2]["450"][STRING: a4:45:19:5a:ef:48] = Gauge32: 425 second
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[1]["450"][STRING: da:20:60:64:36:95] = INTEGER: -64 dBm
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[2]["450"][STRING: a4:45:19:5a:ef:48] = INTEGER: -89 dBm
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSigQuality[1]["450"][STRING: da:20:60:64:36:95] = Gauge32: 24 percentage
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSigQuality[2]["450"][STRING: a4:45:19:5a:ef:48] = Gauge32: 9 percentage
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientAgingLeft[1]["450"][STRING: da:20:60:64:36:95] = Gauge32: 58 second
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientAgingLeft[2]["450"][STRING: a4:45:19:5a:ef:48] = Gauge32: 34 second
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientPacketsReceived[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 149529 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientPacketsReceived[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 346 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientBytesReceived[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 23101125 byte
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientBytesReceived[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 113287 byte
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientPacketsSent[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 617733 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientPacketsSent[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 251 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientBytesSent[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 745190393 byte
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientBytesSent[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 47693 byte
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientDuplicates[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 2389 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientDuplicates[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 12 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMsduRetries[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 159859 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMsduRetries[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 331 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMsduFails[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 0 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMsduFails[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 0 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientWepErrors[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 0 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientWepErrors[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 0 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMicErrors[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 0 error
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMicErrors[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 0 error
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMicMissingFrames[1]["450"][STRING: da:20:60:64:36:95] = Counter32: 0 packet
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientMicMissingFrames[2]["450"][STRING: a4:45:19:5a:ef:48] = Counter32: 0 packet

Или без использования 

# snmpwalk -v2c -c MON 192.168.77.2  .1.3.6.1.4.1.9.9.273.1.3.1   -On

.1.3.6.1.4.1.9.9.273.1.3.1.1.1.1.3.52.53.48.218.32.96.100.54.149 = Hex-STRING: 05
.1.3.6.1.4.1.9.9.273.1.3.1.1.1.2.3.52.53.48.164.69.25.90.239.72 = Hex-STRING: 01
.1.3.6.1.4.1.9.9.273.1.3.1.1.2.1.3.52.53.48.218.32.96.100.54.149 = Gauge32: 15911 second
.1.3.6.1.4.1.9.9.273.1.3.1.1.2.2.3.52.53.48.164.69.25.90.239.72 = Gauge32: 439 second
.1.3.6.1.4.1.9.9.273.1.3.1.1.3.1.3.52.53.48.218.32.96.100.54.149 = INTEGER: -63 dBm
.1.3.6.1.4.1.9.9.273.1.3.1.1.3.2.3.52.53.48.164.69.25.90.239.72 = INTEGER: -89 dBm
.1.3.6.1.4.1.9.9.273.1.3.1.1.4.1.3.52.53.48.218.32.96.100.54.149 = Gauge32: 31 percentage
.1.3.6.1.4.1.9.9.273.1.3.1.1.4.2.3.52.53.48.164.69.25.90.239.72 = Gauge32: 10 percentage
.1.3.6.1.4.1.9.9.273.1.3.1.1.5.1.3.52.53.48.218.32.96.100.54.149 = Gauge32: 58 second
.1.3.6.1.4.1.9.9.273.1.3.1.1.5.2.3.52.53.48.164.69.25.90.239.72 = Gauge32: 51 second
.1.3.6.1.4.1.9.9.273.1.3.1.1.6.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 149587 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.6.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 347 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.7.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 23109939 byte
.1.3.6.1.4.1.9.9.273.1.3.1.1.7.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 113333 byte
.1.3.6.1.4.1.9.9.273.1.3.1.1.8.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 618046 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.8.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 251 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.9.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 745583754 byte
.1.3.6.1.4.1.9.9.273.1.3.1.1.9.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 47693 byte
.1.3.6.1.4.1.9.9.273.1.3.1.1.10.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 2392 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.10.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 12 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.11.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 159964 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.11.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 331 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.12.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 0 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.12.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 0 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.13.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 0 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.13.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 0 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.14.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 0 error
.1.3.6.1.4.1.9.9.273.1.3.1.1.14.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 0 error
.1.3.6.1.4.1.9.9.273.1.3.1.1.15.1.3.52.53.48.218.32.96.100.54.149 = Counter32: 0 packet
.1.3.6.1.4.1.9.9.273.1.3.1.1.15.2.3.52.53.48.164.69.25.90.239.72 = Counter32: 0 packet

Разбор OID

Как можно видеть, сам OID состоит из нескольких частей
Для определенности рассмотрим уровни сигнала: 

.1.3.6.1.4.1.9.9.273.1.3.1.1.3.1.3.52.53.48.218.32.96.100.54.149 = INTEGER: -63 dBm
.1.3.6.1.4.1.9.9.273.1.3.1.1.3.2.3.52.53.48.164.69.25.90.239.72 = INTEGER: -89 dBm

CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[1]["450"][STRING: da:20:60:64:36:95] = INTEGER: -64 dBm
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[2]["450"][STRING: a4:45:19:5a:ef:48] = INTEGER: -89 dBm

Часть .1.3.6.1.4.1.9.9.273.1.3.1.1.3 это и есть OID CISCO-DOT11-ASSOCIATION и она общая
Далее в самом OID закодировано значение "кому принадлежит сигнал", т е какому клиенту


Выделенное значение и его описание:

  • 2.3.52.53.48.164.69.25.90.239.72 - номер интерфейса, он же ifIndex, dot11Radio0 (1), или dot11Radio1 (2), в примере клиент подключен к 5Ghz интерфейсу (dot11Radio1)
  • 2.3.52.53.48.164.69.25.90.239.72 - Длинна SSID в байтах, в пример 3 символа (SSID в примере "450")
  • 2.3.52.53.48.164.69.25.90.239.72 - коды ASCII символов SSID, их три - "450"
  • 2.3.52.53.48.164.69.25.90.239.72 - мак-адрес, 6 байт, записаны в деятичной форме, "a4:45:19:5a:ef:48", например 164(десятичное) = a4(hex), 69(десятичное) = 45 (hex) и так далее.

Интеграция с Zabbix

SNMP autodiscovery

Есть дока но мне она не нравится =)

В моем случае правило автообнаружения выглядит так:
Zabbix Discovery.png

В целом идея такая:

  • В поле SNMP OID указываю discovery[{#S},1.3.6.1.4.1.9.9.273.1.3.1.1.3]
  • Заббикс сам делает snmpwalk 1.3.6.1.4.1.9.9.273.1.3.1.1.3 и в результате получает список клиентов и их сигналы
snmpwalk -v2c -c MON 192.168.77.2   1.3.6.1.4.1.9.9.273.1.3.1.1.3   -OX
Bad operator (INTEGER): At line 73 in /usr/share/snmp/mibs/ietf/SNMPv2-PDU
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[1]["450"][STRING: 0:8:ca:2b:1:24] = INTEGER: -65 dBm
CISCO-DOT11-ASSOCIATION-MIB::cDot11ClientSignalStrength[2]["450"][STRING: a4:45:19:5a:ef:48] = INTEGER: -67 dBm

и на выходе формирует JSON в котором есть поля "{#SNMPINDEX}" - это часть которую нужно дописать к OID указанному в discovery что бы получить значение 

[
  {
    "{#SNMPINDEX}": "1.3.52.53.48.0.8.202.43.1.36",
    "{#S}": "-66"
  },
  {
    "{#SNMPINDEX}": "2.3.52.53.48.164.69.25.90.239.72",
    "{#S}": "-66"
  }
] 

Это выглядит странновато, но суть этого - получить список суффиксов, которые потом можно использовать для получения других значений
В поле "{#S}" записан сигнал и его значение я нигде не использую, но в общем случае (для других MIB/OID) тут может быть что-то что можно использовать (в оригинальной документации это имена интерфейсов)
В общем случае можно указать несколько OID которые нужно обходить snmpwalk-ом, но при этом нужно держать в голове что SNMPINDEX должен совпадать - так работает для таблицы интерфейсов где по разным префиксам но с одним и тем же ifIndex можно получить данные с интерфейса - имя, дескрипшен, байты и т.п.

Если же указать 2 OID с разной структурой (например интерфейсы и таблицу регистрации клиентов) то ничего хорошего не получится - данные будут перемешаны (подробно я не смотрел код как именно и почему )


Далее при создании прототипов элементов данных можно использовать "{#SNMPINDEX}" и тогда все остальные переменны в JSON полученном при discovery будут доступны

Например, если при создании прототипа данныхь указать OID=.1.3.6.1.4.1.9.9.273.1.3.1.1.2.{#SNMPINDEX} то (для моего примера будет автоматически создано 2 элемента данных, в именах которых можно использовать например значение макроса "{$S}". Это хорошо ложиться на пример с интерфейсом, но в моем случае этот макрос как и остальные совершенно бесполезен так как вся статическая информация закодирована в OID который собственно доступен через макрос "{SNMPINDEX}"

Processing

Для того что бы получить нужные данные в удобном виде полученный при discovery JSON можно редактировать с помошью встроенного JavaScript

В моем случае на скорую руку вышел вот такой скрипт: 

var records = JSON.parse(value);

for (i = 0; i < records.length; i++) {
    var OID = records[i]["{#SNMPINDEX}"].split('.')
    // IFINDEX AND IFNAME
    var dot1RadioIfIndex = OID.shift();
    records[i]['{#DOT1RADIO_IFINDEX}'] = dot1RadioIfIndex
    records[i]['{#DOT1RADIO_IFNAME}'] = "Dot11Radio" + (parseInt(dot1RadioIfIndex) - 1).toString()

    // get mac as 6 last digits converted dec -> hex and joined with ':'
    var MAC = ""
    var MACDigitHex
    for (j = 0; j < 6; j++) {
        MACDigitDec = OID.pop();

        MACDigitHex = parseInt(MACDigitDec).toString(16);
        MAC = MACDigitHex + " " + MAC
    }
    records[i]['{#MAC}'] = MAC.trim().split(" ").join(":")

    // SSID. The first octet is length, others are ASCII characters 
    SSID = ""
    ssidLength = OID.shift();
    
    for (j = 0; j < ssidLength; j++) {
      SSID += String.fromCharCode(parseInt(OID[j]));

    }
    records[i]['{#SSID}'] = SSID
}
return JSON.stringify(records);

Идея в том что бы добавить поля построенные на основе SNMPINDEX в Json, и в дальнейшем они будут доступны при создании элементов данных


В результате из исходного JSON получаю такой 

[
  {
    "{#SNMPINDEX}": "1.3.52.53.48.0.8.202.43.1.36",
    "{#S}": "-62",
    "{#DOT1RADIO_IFINDEX}": "1",
    "{#DOT1RADIO_IFNAME}": "Dot11Radio0",
    "{#MAC}": "0:8:ca:2b:1:24",
    "{#SSID}": "450"
  },
  {
    "{#SNMPINDEX}": "2.3.52.53.48.164.69.25.90.239.72",
    "{#S}": "-79",
    "{#DOT1RADIO_IFINDEX}": "2",
    "{#DOT1RADIO_IFNAME}": "Dot11Radio1",
    "{#MAC}": "a4:45:19:5a:ef:48",
    "{#SSID}": "450"
  }
]

который уже содержит статическую информацию о клиенте и который можно использовать для создания элеметов данных

Прототпипы элементов данных

Формируем имя и ключ на основе данных из Json, например 

Name cDot11ClientSignalStrength [ {#MAC}@{#DOT1RADIO_IFNAME}:{#SSID} ]

где для кажого клиента будет создан отдельный элемент данных,
при этом используются три уникальных значения.

Другими словами ключ (SNMP OID) составляется из префикса который статичен для каждого типа данных и суффкса который SNMPINDEX и зависит от клиента (мака, SSID и интерфейса)
Клиент с тем же маком но подключившись в другом диапазоне (другой интерфейс) рассматривается как другой клиент даже если используется один SSID для разных частот)
Item Prototype.png
Все элементы данных в целом полностью аналогичны

Готовый Темплейт

Источник — https://noname.com.ua/mediawiki/index.php?title=Access_Point_Registration_Table&oldid=9996