Go to Qiita Advent Calendar 2024 Top
LoginSignup
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@hshimomu(Hideaki Shimomura)

Catalyst 9800 シリーズ ワイヤレスLANコントローラ用 Zabbix テンプレートをつくりました

Posted at

Catalyst 9800 シリーズ ワイヤレスLANコントローラ用 Zabbix テンプレート

これは何ですか？

これは、Cisco Catalyst 9800シリーズ ワイヤレスLANコントローラ用のZabbixテンプレートです。SNMPを使用して、無線クライアント数、AP数、ラジオ利用率、モビリティトンネルの状態、ハイアベイラビリティの状態などの無線監視を可能にします。CPU使用率、メモリ使用量、インターフェース状態などの一般的なIOS-XEデバイスのステータスはCisco IOS by SNMP」テンプレートやその他のテンプレートを使用して取得してください。

要件

  • Cisco Catalyst 9800シリーズ ワイヤレスLANコントローラと
    サポートされているアクセスポイント
  • IOS-XE 17.11以降のソフトウェアイメージ
    (AIRESPACE-WIRELESS-MIB::bsnDot11EssNumberOfMobileStations などの
    無線SNMP OIDを取得のため)
  • Catalyst 9800 WLCでのSNMPおよびSNMPトラップの設定
  • Zabbix 6.0以降（6.0.29でテスト済み）

SNMPのサンプル設定は以下の通りです。

snmp-server community [SNMP COMMUNITY] RO
snmp-server location ["YOUR PHYSICAL ADDRESS"]
snmp-server enable traps wireless bsnAutoRF
snmp-server enable traps rf
snmp-server host [ZABBIX IP ADDRESS] version 2c [SNMP COMMUNITY]

使用方法

  1. zabbix-cisco-9800テンプレートをダウンロードします。
  2. ダウンロードしたテンプレートをインポートします。
  3. テンプレートの最新バージョンを使用して、すべてのテンプレートアイテムが正しいことを確認してください。

使用しているSNMP MIB

Monitoring Item SNMP MIBs
AP Name AIRESPACE-WIRELESS-MIB::bsnAPName
AP Channel Number (2.4GHz) AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber
AP Channel Number (5GHz) AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber
CISCO-LWAPP-AP-MIB::cLApExtensionChannels
AP Channel Bandwidth (5GHz) CISCO-LWAPP-AP-MIB::cLAp11ChannelBandwidth
AP Channel Utilization (2.4GHz/5GHz) AIRESPACE-WIRELESS-MIB::bsnAPIfLoadChannelUtilization
AP Operation Status AIRESPACE-WIRELESS-MIB::bsnAPOperationStatus
AP Serial Number AIRESPACE-WIRELESS-MIB::bsnAPSerialNumber
AP Software Version AIRESPACE-WIRELESS-MIB::bsnAPSoftwareVersion
AP Tx Power Level (2.4GHz/5GHz) AIRESPACE-WIRELESS-MIB::bsnAPIfPhyTxPowerLevel
Current Number of AP CISCO-LWAPP-AP-MIB::cLApGlobalAPConnectCount.0
Number of APs Supported CISCO-LWAPP-AP-MIB::cLApGlobalMaxApsSupported.0
HA SSO status CISCO-LWAPP-HA-MIB::cLHaPeerHotStandbyEvent
Mobility Member Status (Control) CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperControlPathStatus
Mobility Member Status (Data) CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperControlPathStatus
Rouge AP Count AIRESPACE-WIRELESS-MIB::bsnRogueAPDot11MacAddress
Rogue Client Count AIRESPACE-WIRELESS-MIB::bsnRogueClientDot11MacAddress
SSID Administrative Status AIRESPACE-WIRELESS-MIB::bsnDot11EssAdminStatus
SSID Number of Clients AIRESPACE-WIRELESS-MIB::bsnDot11EssNumberOfMobileStations
AP disassociation AIRESPACE-WIRELESS-MIB::bsnAPDisassociated
CISCO-LWAPP-AP-MIB::ciscoLwappApAssociated
Channel Changed AIRESPACE-WIRELESS-MIB::bsnAPCurrentChannelChanged
DFS Radar Detection AIRESPACE-WIRELESS-MIB::bsnRadarChannelDetected

本テンプレートでは標準MIBおよびOIDで実装をしているためベンダーMIBのインストールは不要です。詳細は下記からMIBをダウンロードし確認ください。

  • AIRESPACE-REF-MIB.my
  • AIRESPACE-WIRELESS-CAPABILITY.my
  • AIRESPACE-WIRELESS-MIB.my
  • CISCO-LWAPP-AP-MIB.my
  • CISCO-LWAPP-DOT11-MIB.my
  • CISCO-LWAPP-RF-MIB.my
  • CISCO-LWAPP-TC-MIB.my
  • CISCO-LWAPP-WLAN-MIB.my
  • CISCO-SMI.my
  • CISCO-TC.my
  • ENTITY-MIB.my

https://github.com/cisco/cisco-mibs

スクリーンショット

Screenshot 2024-05-16 at 18.58.51.png

Screenshot 2024-05-16 at 18.59.27.png

テスト環境

  • Cisco IOS Software [Dublin], C9800 Software (C9800_IOSXE-K9), Version 17.12.3, RELEASE SOFTWARE (fc7)
    • C9800-L-F-K9
    • C9800-CL-K9
  • Zabbix 6.0.29

テストは小規模なラボ環境で実施しています。大規模な環境ではSNMPでワイヤレスコントローラのCPUに負荷がかかっていないか確認を行ってください。

ディスカバリルール

Name Description Type Key and additional info
bsnAPTable Enumerate Access Point and create prototype for each SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPName
Update: 1h
cLMobilityGroupMembersOperEntry Enumurate Mobility Group Member and createprotoype for each SNMP Agent CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperNodeAddress
Update: 1h
cLWlanSsid Enumerate SSID and create prototype for each SNMP Agent CISCO-LWAPP-WLAN-MIB::cLWlanSsid
Update: 1h

アイテム

Name Description Type Key and additional info
AP Name - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPName
Update: 1h
AP Channel Number (2.4GHz) - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber
Update: 15min
AP Channel Number (5GHz) Chennel bonding is supported SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber
+ CISCO-LWAPP-AP-MIB::cLApExtensionChannels
Update: 15min
AP Channel Bandwidth (5GHz) - SNMP Agent CISCO-LWAPP-AP-MIB::cLAp11ChannelBandwidth
Update: 15min
AP Channel Utilization (2.4GHz/5GHz) - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPIfLoadChannelUtilization
Update: 15min
AP Operation Status - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPOperationStatus
Update: 15min
AP Serial Number - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPSerialNumber
Update: 24h
AP Software Version - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPSoftwareVersion
Update 1h
AP Tx Power Level (2.4GHz/5GHz) - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnAPIfPhyTxPowerLevel
Update: 15min
Current Number of AP - SNMP Agent CISCO-LWAPP-AP-MIB::cLApGlobalAPConnectCount.0
Update: 1min
Number of APs Supported - SNMP Agent CISCO-LWAPP-AP-MIB::cLApGlobalMaxApsSupported.0
Update: 15min
HA SSO status - SNMP Agent CISCO-LWAPP-HA-MIB::cLHaPeerHotStandbyEvent
Update: 15min
Mobility Member Status (Control) - SNMP Agent CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperControlPathStatus
Update: 1min
Mobility Member Status (Data) - SNMP Agent CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperControlPathStatus
Update: 1min
Rouge AP Count - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnRogueAPDot11MacAddress
Update: 15min
Rogue Client Count - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnRogueClientDot11MacAddress
Update: 15min
SSID Administrative Status - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnDot11EssAdminStatus
Update: 1min
SSID Number of Clients - SNMP Agent AIRESPACE-WIRELESS-MIB::bsnDot11EssNumberOfMobileStations
Update: 1min
AP diassociation - SNMP Trap AIRESPACE-WIRELESS-MIB::bsnAPDisassociated
CISCO-LWAPP-AP-MIB::ciscoLwappApAssociated
Channel Changed - SNMP Trap AIRESPACE-WIRELESS-MIB::bsnAPCurrentChannelChanged
DFS Radar Detection - SNMP Trap AIRESPACE-WIRELESS-MIB::bsnRadarChannelDetected

トリガー

Name Description Expression Priority
AP Name: {{ITEM.VALUE}.regsub("SNMPv2-SMI::enterprises.14179.2.2.1.1.3..=\s(.)",\1)} Disjoined Problem trigger TrapOID
AIRESPACE-WIRELESS-MIB::bsnAPDisassociated

Recovery trigger TrapOID
CISCO-LWAPP-AP-MIB::ciscoLwappApAssociated

Tag "APNAME" from
AIRESPACE-WIRELESS-MIB::bsnAPName (problem)
CISCO-LWAPP-AP-MIB::cLApName (recovery)		 Problem expression
find(/Cisco Catalyst 9800 by SNMP/snmptrap[SNMPv2-SMI::enterprises.14179.2.6.3.8$|SNMPv2-SMI::enterprises.9.9.513.0.4$],,"regexp","14179.2.6.3.8")=1

Recovery expression
find(/Cisco Catalyst 9800 by SNMP/snmptrap[SNMPv2-SMI::enterprises.14179.2.6.3.8$|SNMPv2-SMI::enterprises.9.9.513.0.4$],,"regexp","9.9.513.0.4")=1		 Warning
Channel Updated Trap on {{ITEM.VALUE}.regsub("SNMPv2-SMI::enterprises.14179.2.2.1.1.3..=\s(.)",\1)} Primaly Channel: {{ITEM.VALUE}.regsub("SNMPv2-SMI::enterprises.14179.2.6.2.23..=\s(.)",\1)} 2 AIRESPACE-WIRELESS-MIB::bsnAPCurrentChannelChanged

APNAME
AIRESPACE-WIRELESS-MIB::bsnAPName

find(/Cisco Catalyst 9800 by SNMP/snmptrap["SNMPv2-SMI::enterprises.14179.2.6.3.16"],86400)=1		 Expression
find(/Cisco Catalyst 9800 by SNMP/snmptrap["SNMPv2-SMI::enterprises.14179.2.6.3.16"],,"like","SNMPv2-SMI::enterprises.14179.2.6.3.16")=1		 Information
DFS Detected on {{ITEM.VALUE}.regsub("SNMPv2-SMI::enterprises.14179.2.2.1.1.3..=\s(.)",\1)} Channel: {{ITEM.VALUE}.regsub("SNMPv2-SMI::enterprises.14179.2.2.2.1.4..=\s(.)",\1)} Trigger SNMP OID
AIRESPACE-WIRELESS-MIB::bsnRadarChannelDetected

APNAME
AIRESPACE-WIRELESS-MIB::bsnAPName

CHANNEL
AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber

find(/Cisco Catalyst 9800 by SNMP/snmptrap["SNMPv2-SMI::enterprises.14179.2.6.3.81"],86400)=1		 Expression
find(/Cisco Catalyst 9800 by SNMP/snmptrap["SNMPv2-SMI::enterprises.14179.2.6.3.81"],,"like","SNMPv2-SMI::enterprises.14179.2.6.3.81")=1		 Information
HA Peer Hotstandby status changed Track CISCO-LWAPP-HA-MIB::cLHaPeerHotStandbyEvent Expression
change(/Cisco Catalyst 9800 by SNMP/cLHaPeerHotStandbyEvent)<>0		 Warning
Maxmimum AP join limit has reached Trigger
CISCO-LWAPP-AP-MIB::cLApGlobalAPConnectCount.0
= CISCO-LWAPP-AP-MIB::cLApGlobalMaxApsSupported.0		 Expression
last(/Cisco Catalyst 9800 by SNMP/cLApGlobalAPConnectCount)=last(/Cisco Catalyst 9800 by SNMP/cLApGlobalMaxApsSupported)		 Average
AP Operation Status changed {#APNAME} This is tracking AIRESPACE-WIRELESS-MIB::bsnAPOperationStatus.
It will be useful when SNMP trap is not used.		 Problem expression
last(/Cisco Catalyst 9800 by SNMP/bsnAPOperationStatus[{#APNAME}])=2 and last(/Cisco Catalyst 9800 by SNMP/bsnAPOperationStatus[{#APNAME}],#1)<>last(/Cisco Catalyst 9800 by SNMP/bsnAPOperationStatus[{#APNAME}],#2)

Recovery expression
find(/Cisco Catalyst 9800 by SNMP/bsnAPOperationStatus[{#APNAME}],3,,"1")=1		 Warning
Channel Updated on {#APNAME} This is tracking AIRESPACE-WIRELESS-MIB::bsnAPIfPhyChannelNumber.
This trigger can catch channel update of both manual channel assignment and auto assignment.		 Problem expression
(nodata(/Cisco Catalyst 9800 by SNMP/bsnAPIfPhyChannelNumber-24ghz-[{#APNAME}],900)=0
or
nodata(/Cisco Catalyst 9800 by SNMP/bsnAPIfPhyChannelNumber-cLApExtensionChannels-5ghz-[{#APNAME}],900)=0)

and

(change(/Cisco Catalyst 9800 by SNMP/bsnAPIfPhyChannelNumber-24ghz-[{#APNAME}])<>0
or
change(/Cisco Catalyst 9800 by SNMP/bsnAPIfPhyChannelNumber-cLApExtensionChannels-5ghz-[{#APNAME}])<>0)		 Information
Mobility Peer status down [{#MOBILITYPEER}] Tracking CISCO-LWAPP-MOBILITY-MIB::cLMobilityGroupMembersOperControlPathStatus Problem expression
last(/Cisco Catalyst 9800 by SNMP/cLMobilityGroupMembersOperControlPathStatus[{#MOBILITYPEER}])=2
and
(last(/Cisco Catalyst 9800 by SNMP/cLMobilityGroupMembersOperControlPathStatus[{#MOBILITYPEER}],#1)<>last(/Cisco Catalyst 9800 by SNMP/cLMobilityGroupMembersOperControlPathStatus[{#MOBILITYPEER}],#2))

Recovery expression
find(/Cisco Catalyst 9800 by SNMP/cLMobilityGroupMembersOperControlPathStatus[{#MOBILITYPEER}],600,,"1")=1		 Warning

  1. Cisco Embedded Wireless Controller on Catalyst Access Points（EWC）はSNMP MIBを実装していません(一部のオブジェクト識別子（OID）に応答することがあります)。 詳細はConfiguration guideを参照ください。 ↩

  2. こちらのトリガーはデフォルトで無効です ↩

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?