Skip to main content

QOS-Traffic

Measures Cisco CBQOS pre-policy, post-policy, drop and queue counters polled over SNMP, keyed by QoS class ID and summed across interfaces.

PropertyValue
GUID{1AB9F248-1E49-4245-571A-55BCDA658843}
LayerExternal Data
InputSNMP
Key typeCBQOS class ID (decimal)
ImplementationLua — cg_qos_traffic.lua (group), snmp_qos_walkpoll_key.lua + async_tasks.lua (polling) (apps/analyzers/snmpqospoll)
Trisul Appsnmpqospoll (install from Trisul Apps)
Bucket / Topper60 s / 300 s
Enabled by defaultYes, after the app is installed

What it measures​

  • snmp_qos_walkpoll_key.lua reads SNMP agents from the SNMP agent database (snmp.* key attributes). It polls only agents with snmp.qosenabled set to true or 1, SNMP v2c (with a community) or v3, that hash to this probe engine.
  • Every ResolutionSeconds (default 60) an async task runs snmpbulkwalk (snmpwalk for v1) against the Cisco CBQOS MIB. You need the net-snmp tools on the probe.
  • Class names and index maps (OIDs .166.1.7.1.1.1, .166.1.5.1.1.2, .166.1.5.1.1.4, .166.1.1.1.1.4) are walked on the first poll and then every MapRefreshPolls polls (default 30).
  • Counter values are raw cumulative SNMP counters. The VT_DELTA_RATE_COUNTER meters turn them into a rate: (this value − previous value) ÷ bucket seconds. Zero values are not sent.
  • If the class-name walk returns nothing, the app raises a "SNMP QoS Poll Failed" alert instead of updating counters.
  • You can override ResolutionSeconds, MapRefreshPolls, DebugMode and IsIPEnabled in config/trisulnsm_snmpqospoll.lua under the probe context directory.
  • For each meter, values from every interface and policy that resolve to the same class ID are added together into one key. The key holds no router IP, so the same class ID on two routers lands in one key.
  • Class-map counters (OIDs .166.1.15.1.1.x) map to a class ID through .166.1.5.1.1.2. Queue counters (OIDs .166.1.18.1.1.x) map through .166.1.5.1.1.4 and then .166.1.5.1.1.2. Rows that do not resolve to a class ID are dropped.

Keys​

One key is the CBQOS class ID. The group names QoS-Class as its resolver, so the UI shows the class-map name.

KeyMeaning
1593Class ID 1593, shown with its class-map name, e.g. VOICE
288431494Class ID 288431494, e.g. class-default

Special keys​

KeyMeaning
SYS:GROUP_TOTALSGets every update made to any key. For VT_DELTA_RATE_COUNTER and VT_GAUGE meters the totals item keeps the last raw value written, not a sum, so it is not meaningful here.

Meter list​

IDNameTypeUnitsTopBottomDescription
0Pre PolicyVT_DELTA_RATE_COUNTERBps10000Short name bytes. Fed from OID 1.3.6.1.4.1.9.9.166.1.15.1.1.10.
1Post PolicyVT_DELTA_RATE_COUNTERBps10000Short name bytes. Fed from OID 1.3.6.1.4.1.9.9.166.1.15.1.1.6.
2DropsVT_DELTA_RATE_COUNTERBps10000Short name bytes. Fed from OID 1.3.6.1.4.1.9.9.166.1.15.1.1.16 (class-map drop bytes).
3Queue BufferVT_GAUGEpackets10000Short name pkts. Last value of OID 1.3.6.1.4.1.9.9.166.1.18.1.1.1 in the bucket.
4Queue DropsVT_DELTA_RATE_COUNTERpackets10000Short name pkts. Fed from OID 1.3.6.1.4.1.9.9.166.1.18.1.1.8.
5Queue Drop BytesVT_DELTA_RATE_COUNTERBps10000Short name bytes. Fed from OID 1.3.6.1.4.1.9.9.166.1.18.1.1.4.
6uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.
7uniqsVT_GAUGEUniques2020Reserved cardinality slot. Not populated.
In this page: