Skip to main content

Perf-Stats

Counts the probe's own health (flush time, CPU, memory, capture drops, PCAP write rate), keyed by engine or capture input.

PropertyValue
GUID{0D39F2A7-2627-49D5-9DCF-707E6F1C0571}
LayerSystem
InputInternal
Key typeComponent name (engine-N, inputfilter-N)
ImplementationLua — perf-stats.lua (trisul_probe/src/sysplugs/counters) defines the group; values come from stengine/XTrafDB.cpp, the capture filters in pcappipe (FilterAFPacket, FilterNetPcap, FilterPFRing, FilterRXRing, FilterRingQueue) and stengine/HalfNAT.cpp
Bucket / Topper60 s / 300 s
Enabled by defaultYes

What it measures​

  • Stats engines: after each flush, every engine writes its flush time, CPU and memory to engine-<id>. Disk IO counters (meters 12, 13) are written by engine 0 only.
  • Capture inputs: each capture adapter writes drops, processed packets and drop percent to inputfilter-<n>, and the same values to inputfilter. A drop rate above 1% also raises a PKTDROP system alert (AF_PACKET input).
  • PCAP storage: the packet ring writer adds bytes written to inputfilter meter 14.
  • CGNAT mapping: when half-NAT mapping is configured, per-NAS gauges go to meter 15 under cgnat-match-* keys.
  • Disk Total and Disk Used are written as 0 by the probe. Disk space is reported at the hub.

Keys​

KeyMeaning
engine-0Stats engine 0 (one key per engine)
inputfilter-0Capture adapter or instance 0
inputfilterAll capture inputs together, plus PCAP write bandwidth
cgnat-match-0-10.1.1.1-percentageCGNAT match percent for NAS 10.1.1.1 on engine 0

Special keys​

KeyMeaning
SYS:GROUP_TOTALSSum of every update in the interval. It adds unrelated gauges (CPU, memory, drops) from all keys and has no useful meaning here.
cgnat-match-<engine>-<nas-ip>-<stat><stat> is one of match, nomatch, flushed, nat-creates, nat-deletes, percentage, stale-mapping.

Meter list​

IDNameTypeUnitsTopBottomDescription
0GlobalFlush-1 TimeVT_GAUGEusecs00engine-N: time taken by this engine's last flush. Same value as meter 8.
1CPU TotalVT_GAUGEpercent00engine-N: system CPU use, where 100 means one CPU fully busy. For example, 1100 means 11 CPUs at 100%.
2CPU TrisulVT_GAUGEpercent00engine-N: CPU use of the probe process.
3Mem TotalVT_GAUGEbytes00engine-N: total system memory.
4Mem SystemVT_GAUGEbytes00engine-N: memory in use on the system.
5Mem TrisulVT_GAUGEbytes00engine-N: resident memory of the probe process.
6Disk TotalVT_GAUGEbytes00Written as 0 by the probe.
7Disk UsedVT_GAUGEbytes00Written as 0 by the probe.
8GlobalFlush-0 TimeVT_GAUGEusecs00engine-N: time taken by this engine's last flush.
9Dropped PktsVT_COUNTERpackets00inputfilter*: packets dropped by the capture input.
10Processed PktsVT_COUNTERpackets00inputfilter*: packets received by the capture input.
11Dropped PercentVT_GAUGEpercent00inputfilter*: drops as a percent of received packets.
12Reads IOVT_DELTA_RATE_COUNTERios00engine-0: disk read operations, from the system's running counter.
13Writes IOVT_DELTA_RATE_COUNTERios00engine-0: disk write operations, from the system's running counter.
14PCAP disk bwVT_RATE_COUNTERBps00inputfilter: bytes written to the PCAP packet store.
15Gauge ValueVT_GAUGEvalue00cgnat-match-*: CGNAT mapping statistics.
16Counter ValueVT_COUNTERcount00Not populated by the current code.
17Unused Cardinality counterVT_GAUGEUniques2020Reserved cardinality slot. Not populated.
18Unused Cardinality counterVT_GAUGEUniques2020Reserved cardinality slot. Not populated.