SNMP (Simple Network Management Protocol) server configuration enables comprehensive network monitoring and management by providing standardized access to device operational data, configuration parameters, and event notifications through Management Information Bases (MIBs). Support also includes host targets with unencrypted and encrypted community strings (traps and informs), as well as VRF-specific SNMP configuration for isolated trap delivery and context management within each VRF’s routing table.
Name Type Constraint Mandatory Default Value configuration Class configuration No
Name Type Constraint Mandatory Default Value configuration Class configuration No
Name Type Constraint Mandatory Default Value configuration Class configuration No
Name Type Constraint Mandatory Default Value snmp_server Class snmp_server No
Name Type Constraint Mandatory Default Value communities List communities No contact String No groups List groups No hosts List hosts No location String No chassis_id String No packetsize Integer min: 484, max: 65500 No trap_timeout Integer min: 1, max: 1000 No queue_length Integer min: 1, max: 5000 No throttle_time Integer min: 50, max: 1000 No overload_ control Integer min: 0, max: 300 No overload_ throttle_ rate Integer min: 0, max: 1000 No trap_source String No trap_ source_ ipv4 String No trap_ source_ ipv6 String No trap_ source_ port Integer min: 1024, max: 65535 No trap_ throttle_ time Integer min: 10, max: 500 No trap_ authentication_ vrf_ disable Boolean true, falseNo trap_ delay_ timer Integer min: 30, max: 240 No ipv4_dscp Any Integer[min: 0, max: 63] or Choice[af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, ef] or String[Regex: ^.*[\$\%]\{.*$] No ipv6_dscp Any Integer[min: 0, max: 63] or Choice[af11, af12, af13, af21, af22, af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7, default, ef] or String[Regex: ^.*[\$\%]\{.*$] No drop_ unknown_ user Boolean true, falseNo drop_ report_ acl_ ipv4 String No drop_ report_ acl_ ipv6 String No engine_ids Class engine_ids No interfaces List interfaces No mibs Class mibs No oid_poll_stats Boolean true, falseNo timeouts_ subagent Integer min: 1, max: 20 No timeouts_ duplicate Integer min: 0, max: 20 No timeouts_ in_ qdrop Integer min: 0, max: 20 No timeouts_ threshold Integer min: 0, max: 100000 No timeouts_ pdu_ stats Integer min: 1, max: 10 No logging_ threshold_ oid_ processing Integer min: 0, max: 20000 No logging_ threshold_ pdu_ processing Integer min: 0, max: 20000 No inform_retries Integer min: 0, max: 100 No inform_timeout Integer min: 1, max: 42949671 No inform_pending Integer min: 1, max: 4294967295 No traps Class traps No users List users No views List views No vrfs List vrfs No
Name Type Constraint Mandatory Default Value name String Yes ipv4_acl String No ipv6_acl String No ro Boolean true, falseNo rw Boolean true, falseNo sdrowner Boolean true, falseNo systemowner Boolean true, falseNo view String No
Name Type Constraint Mandatory Default Value name String Yes version Choice v1, v2c, v3Yes v3_ security_ level Choice priv, auth, noauthNo read_view String No write_view String No notify_view String No context String No ipv4_acl String No ipv6_acl String No
Name Type Constraint Mandatory Default Value address IP Yes informs List informs No traps List traps No
Name Type Constraint Mandatory Default Value local String No remote List remote No
Name Type Constraint Mandatory Default Value name String Yes notification_ linkupdown_ enable Boolean true, falseNo notification_ linkupdown_ disable Boolean true, falseNo index_ persistence Boolean true, falseNo
Name Type Constraint Mandatory Default Value cbqosmib_cache Boolean true, falseNo cbqosmib_ cache_ refresh_ time Integer min: 5, max: 60 No cbqosmib_ cache_ service_ policy_ count Integer min: 1, max: 5000 No cbqosmib_ persist Boolean true, falseNo cbqosmib_ member_ stats Boolean true, falseNo ifindex_persist Boolean true, falseNo trap_link_ietf Boolean true, falseNo ifmib_ ifalias_ long Boolean true, falseNo ifmib_ stats_ cache Boolean true, falseNo ifmib_ ipsubscriber Boolean true, falseNo ifmib_ internal_ cache_ max_ duration Integer min: 0, max: 60 No rfmib_ entphyindex Boolean true, falseNo sensormib_cache Boolean true, falseNo mplstemib_ cache_ timers_ garbage_ collect Integer min: 0, max: 3600 No mplstemib_ cache_ timers_ refresh Integer min: 0, max: 600 No mplsp2mpmib_ cache_ timer Integer min: 0, max: 600 No frrmib_ cache_ timer Integer min: 0, max: 600 No cmplsteextmib_ cache_ timer Integer min: 0, max: 600 No cmplsteextstdmib_ cache_ timer Integer min: 0, max: 600 No mroutemib_ send_ all_ vrf Boolean true, falseNo notification_ log_ mib_ default Boolean true, falseNo notification_ log_ mib_ global_ age_ out Integer min: 1, max: 4294967295 No notification_ log_ mib_ global_ size Integer min: 1, max: 15000 No notification_ log_ mib_ disable Boolean true, falseNo notification_ log_ mib_ size Integer min: 1, max: 15000 No entityindex_ persist Boolean true, falseNo
Name Type Constraint Mandatory Default Value snmp_ authentication Boolean true, falseNo snmp_coldstart Boolean true, falseNo snmp_warmstart Boolean true, falseNo snmp_linkup Boolean true, falseNo snmp_linkdown Boolean true, falseNo snmp_all Boolean true, falseNo l2vpn_all Boolean true, falseNo l2vpn_vc_up Boolean true, falseNo l2vpn_vc_down Boolean true, falseNo l2vpn_cisco Boolean true, falseNo vpls_all Boolean true, falseNo vpls_status Boolean true, falseNo vpls_full_raise Boolean true, falseNo vpls_full_clear Boolean true, falseNo bfd Boolean true, falseNo config Boolean true, falseNo cfm Boolean true, falseNo ethernet_ oam_ events Boolean true, falseNo rf Boolean true, falseNo sensor Boolean true, falseNo mpls_l3vpn_all Boolean true, falseNo mpls_ l3vpn_ vrf_ up Boolean true, falseNo mpls_ l3vpn_ vrf_ down Boolean true, falseNo mpls_ l3vpn_ mid_ threshold_ exceeded Boolean true, falseNo mpls_ l3vpn_ max_ threshold_ exceeded Boolean true, falseNo mpls_ l3vpn_ max_ threshold_ cleared Boolean true, falseNo mpls_ l3vpn_ max_ threshold_ reissue_ notif_ time Integer min: 0, max: 2147483647 No mpls_ traffic_ eng_ cisco Boolean true, falseNo mpls_ traffic_ eng_ cisco_ ext_ bringup_ fail Boolean true, falseNo mpls_ traffic_ eng_ cisco_ ext_ insuff_ bw Boolean true, falseNo mpls_ traffic_ eng_ cisco_ ext_ preempt Boolean true, falseNo mpls_ traffic_ eng_ cisco_ ext_ reroute_ pending Boolean true, falseNo mpls_ traffic_ eng_ cisco_ ext_ reroute_ pending_ clear Boolean true, falseNo mpls_ traffic_ eng_ down Boolean true, falseNo mpls_ traffic_ eng_ p2mp_ down Boolean true, falseNo mpls_ traffic_ eng_ p2mp_ up Boolean true, falseNo mpls_ traffic_ eng_ reoptimize Boolean true, falseNo mpls_ traffic_ eng_ reroute Boolean true, falseNo mpls_ traffic_ eng_ up Boolean true, falseNo ntp Boolean true, falseNo bgp_cbgp_two Choice enable, updownNo bgp_enable Choice bgp4_mib, updownNo hsrp Boolean true, falseNo isis_ database_ overload Boolean true, falseNo isis_ manual_ address_ drops Boolean true, falseNo isis_ corrupted_ lsp_ detected Boolean true, falseNo isis_ attempt_ to_ exceed_ max_ sequence Boolean true, falseNo isis_ id_ len_ mismatch Boolean true, falseNo isis_ max_ area_ addresses_ mismatch Boolean true, falseNo isis_ own_ lsp_ purge Boolean true, falseNo isis_ sequence_ number_ skip Boolean true, falseNo isis_ authentication_ type_ failure Boolean true, falseNo isis_ authentication_ failure Boolean true, falseNo isis_ version_ skew Boolean true, falseNo isis_ area_ mismatch Boolean true, falseNo isis_ rejected_ adjacency Boolean true, falseNo isis_ lsp_ too_ large_ to_ propagate Boolean true, falseNo isis_ orig_ lsp_ buff_ size_ mismatch Boolean true, falseNo isis_ protocols_ supported_ mismatch Boolean true, falseNo isis_ adjacency_ change Boolean true, falseNo isis_ lsp_ error_ detected Boolean true, falseNo isis_all Boolean true, falseNo vrrp_events Boolean true, falseNo alarm Boolean true, falseNo bridgemib Boolean true, falseNo copy_complete Boolean true, falseNo entity Boolean true, falseNo cisco_ entity_ ext Boolean true, falseNo entity_ redundancy_ all Boolean true, falseNo entity_ redundancy_ switchover Boolean true, falseNo entity_ redundancy_ status Boolean true, falseNo entity_ state_ switchover Boolean true, falseNo entity_ state_ operstatus Boolean true, falseNo flash_insertion Boolean true, falseNo flash_removal Boolean true, falseNo fru_ctrl Boolean true, falseNo ipsla Boolean true, falseNo mpls_ldp_down Boolean true, falseNo mpls_ldp_up Boolean true, falseNo mpls_ ldp_ threshold Boolean true, falseNo pim_ neighbor_ change Boolean true, falseNo pim_ interface_ state_ change Boolean true, falseNo pim_ invalid_ message_ received Boolean true, falseNo pim_ rp_ mapping_ change Boolean true, falseNo power Boolean true, falseNo syslog Boolean true, falseNo system Boolean true, falseNo
Name Type Constraint Mandatory Default Value name String Yes group String Yes version Choice v1, v2c, v3Yes ipv4_acl String No ipv6_acl String No systemowner Boolean true, falseNo v3_ authentication Class v3_ authentication No v3_privacy Class v3_privacy No
Name Type Constraint Mandatory Default Value name String Yes mibs List mibs No
Name Type Constraint Mandatory Default Value vrf String Yes hosts List hosts No contexts List contexts No
Name Type Constraint Mandatory Default Value community String Yes encryption_type Choice unencrypted, default, aesYes version Choice v1, v2c, v3Yes udp_port Integer min: 1, max: 65535 No v3_ security_ level Choice auth, noauth, privNo
Name Type Constraint Mandatory Default Value community String Yes encryption_type Choice unencrypted, default, aesYes version Choice v1, v2c, v3Yes udp_port Integer min: 1, max: 65535 No v3_ security_ level Choice auth, noauth, privNo
Name Type Constraint Mandatory Default Value address IP Yes id String Yes udp_port Integer min: 1, max: 65535 Yes
Name Type Constraint Mandatory Default Value algorithm Choice md5, sha, sha-256, sha-512Yes encryption_type Choice default, aesNo password String Yes
Name Type Constraint Mandatory Default Value algorithm Choice aes-128, aes-192, aes-256Yes encryption_type Choice default, aesNo password String Yes
Name Type Constraint Mandatory Default Value id String Yes scope Choice included, excludedYes
Name Type Constraint Mandatory Default Value address IP Yes informs List informs No traps List traps No
Name Type Constraint Mandatory Default Value name String Yes
Name Type Constraint Mandatory Default Value community String Yes encryption_type Choice unencrypted, default, aesYes version Choice v1, v2c, v3Yes udp_port Any Integer[min: 1, max: 65535] or Choice[default] or String[Regex: ^.*[\$\%]\{.*$] No v3_ security_ level Choice auth, noauth, privNo
Name Type Constraint Mandatory Default Value community String Yes encryption_type Choice unencrypted, default, aesYes version Choice v1, v2c, v3Yes udp_port Any Integer[min: 1, max: 65535] or Choice[default] or String[Regex: ^.*[\$\%]\{.*$] No v3_ security_ level Choice auth, noauth, privNo
DSCP Values
SNMP Server DSCP fields accept both numeric and named string values.
ipv4_dscp / ipv6_dscp: integer 0-63 or named value (e.g., ef, af11, cs3)
Both formats can be used interchangeably. The normalization layer automatically converts integer values to their named equivalents before sending to the device, preventing configuration drift.
The following configuration describes how to set up various SNMP parameters on a Cisco IOS-XR device.
snmp-server location "My location"
snmp-server contact "My contact"
snmp-server trap source Loopback10
snmp-server traps bgp cbgp-two enable
snmp-server traps bgp enable cisco-bgp4-mib
snmp-server traps ethernet oam events
snmp-server traps copy-complete
snmp-server traps snmp linkup
snmp-server traps snmp linkdown
snmp-server traps bridgemib
snmp-server traps entity-state operstatus
snmp-server traps entity-redundancy all
snmp-server traps fru-ctrl
snmp-server traps isis database-overload
snmp-server traps isis manual-address-drops
snmp-server traps isis corrupted-lsp-detected
snmp-server traps isis adjacency-change
snmp-server traps l2vpn all
snmp-server traps l2vpn vc-up
snmp-server traps l2vpn vc-down
snmp-server user USER1 GROUP1 v3 auth md5 encrypted 073C05626E2A4841141D priv aes 128 encrypted 073C05626E2A4841141D IPv4 ACL1 systemowner
snmp-server user USER2 GROUP1 v3 auth sha encrypted 080D7A1A10151A190B priv aes 128 encrypted 073C05626E2A4841141D IPv4 ACL2
snmp-server group GROUP1 v3 priv read VIEW1 write VIEW2 context CONTEXT1 notify VIEW3 IPv4 ACL1 IPv6 ACL2
snmp-server community public view VIEW1 RO IPv4 ACL1
snmp-server community private view VIEW2 RW systemowner IPv4 ACL2 IPv6 ACL3
snmp-server view VIEW1 1.3.6.1.2.1.1 included
snmp-server view VIEW2 1.3.6.1.2.1 included
snmp-server view VIEW2 1.3.6.1.2.1.11 excluded
snmp-server vrf VRF1 host 11.11.11.11 traps COMMUNITY1 version 3 auth
Example-1: Basic SNMP Server configuration with location and contact.
location : " Data Center A "
contact : " admin@example.com "
Example-2: SNMP Server with trap configuration.
location : " Data Center B "
ethernet_oam_events : true
entity_state_operstatus : true
entity_redundancy_all : true
isis_database_overload : true
isis_manual_address_drops : true
isis_corrupted_lsp_detected : true
isis_adjacency_change : true
Example-3: SNMP Server with SNMPv3 users and groups.
location : " Data Center C "
contact : " netops@example.com "
password : " encrypted_password "
Example-4: SNMP Server with SNMPv2c communities.
location : " Branch Office "
Example-5: SNMP Server hosts with encrypted communities.
encryption_type : unencrypted
- community : " 15021E0E082328 "
encryption_type : unencrypted
- community : " 06253E2C5A471E1C5E "
Example-6: SNMP Server MIB settings with CBQoSMIB caching and interface configuration.
cbqosmib_cache_refresh_time : 30
cbqosmib_cache_service_policy_count : 100
cbqosmib_member_stats : true
- name : GigabitEthernet0/0/0/1
notification_linkupdown_disable : true
VRF-specific SNMP configuration applies trap destinations and contexts to individual VRFs and is used for isolated SNMP monitoring within each VRF context. These settings define how the router delivers SNMP traps and informs for applications, services, and routing protocols operating within that VRF’s routing table.
Example-1: SNMP Server VRF with hosts, encrypted communities, and contexts.
encryption_type : unencrypted
- community : " 15021E0E082328 "
encryption_type : unencrypted
- community : " 06253E2C5A471E1C5E "