WR-streamers SNMP diagnostics
WRPC provides diagnostics via SNMP. The basic MIB for generic WRPC values can be extended for the purpose of application-specific cores (in general, an unlimited number of cores, each having its own MIB). This mechanism is used by WR Streamers to make its statistics available via SNMP.
The WR-streamers diagnostic via SNMP:
- is identified by reading OID in the MIB of WRPC that is generic for the application-specific extensions **** (to be implemented see #8)
- is the first to use this extension mechanism, and so has ID=1, thought we have already version=2 of it.
- is defined in the MIB file that can be found in wrpc-sw repository lib folder: WR-WRPC-AUX-STREAMERS-MIB.txt
Diangostic values available via SNMP for WR-streamers
Table below shows the values that are available from WR-Streamers via SNMP. Most of the values are 64-bit values that are read as two 32-bit values (LSB and MSB).
Since the values might change fast, we provide a mechanism that freezes the values (makes a coherent snapshot of the data). Such a snapshot is done by writing 0x2 to wrpcAuxDiag102RwControlRegister.1 (1.3.6.1.4.1.96.101.2.1.2.2.1.3.1). After reading all values, the data should be "un-frozen" by writing 0x0 to wrpcAuxDiag102RwControlRegister.1 (1.3.6.1.4.1.96.101.2.1.2.2.1.3.1).
name | description | source (how to get this values using OIDs from MIB table below with read-only OIDs) | Units | Example threshold |
---|---|---|---|---|
reset | 1 if the statistics are being resetted | reset | N/A | must be 0 (warning) |
overflow | 1 if the latency accumulator overflew since last reset | overflow | N/A | must be 0 (warning) |
rest time | time of the last reset of statistics (seconds+nanoseconds since epoch) | (rest time MSB)<<32 + (rest time LSB) seconds and 8*(rest time CYC) nanoseconds | time from epoch | not be 0 (warning) |
latency max | maximum latency since reset | (8/1000)*( latency max ) | [us] | < 10 (warning/error) |
latency min | minimum latency since reset | (8/1000)*( latency min ) | [us] | >3 (error) |
frames sent | number of transmitted frames since reset | ( frames sent MSB)<<32 + ( frames sent LSB) | [frame] | N/A |
frames received | number of received frames since reset | ( frames received MSB)<<32 + ( frames received LSB) | [frame] | N/A |
frames lost | number of lost frames since reset | ( frames lost MSB)<<32 + ( frames lost LSB) | [frame] | <1 (error) |
blocks lost | number of blocks of data since reset | ( blocks lost MSB)<<32 + ( blocks lost LSB) | [blocks] | <1 (error) |
average latency | average latency since reset | (8/1000)*[{(lat acc MSB)<<32(lat acc LSB) }/{(lat acc cnt MSB)<<32(lat acc cnt LSB)}] | [us] | N/A |
fixed-latency frames successful | the number of frames that had their execution on time in the fixed latency mode | (frames successful MSB)<<32 + (frames successful LSB) | [frame] | N/A |
fixed-latency frames late | number of frames that missed fixed-latency deadline | (frames late MSB)<<32 + (frames late LSB) | [frame] | <1 (error) |
fixed-latency frames timeout | number of frames with their execution timestamp too far in the future | (frames timeout MSB)<<32 + (frames timeout LSB) | [frame] | <1 (error) |
MIBs generic for the application-specific extensions (read-only)
To be added in v4.3 of WRPC, see #8
OID number | OID name | Value for this auxiliary diagnostic extension |
---|---|---|
1.3.6.1.4.1.96.101.1. **** .1.1 | wrpcAuxDiagId | 1 |
1.3.6.1.4.1.96.101.1. **** .2.1 | wrpcAuxDiagVer | 2 |
1.3.6.1.4.1.96.101.1. **** .3.1 | wrpcAuxDiagName | WR Stremers |
1.3.6.1.4.1.96.101.1. **** .4.1 | wrpcAuxDiagOID | 1.3.6.1.4.1.96.101.2.1.2.1.1 |
MIBs specific for the WR-streamers (read-only)
Name | OID number | OID name | Units | Meaning | Example threashold |
---|---|---|---|---|---|
reset | 1.3.6.1.4.1.96.101.2.1.2.1.1.3.1 | wrpcAuxDiag102RoStatus.1 | N/A | bit 0 is 1 if reset active | N/A |
overflow | 1.3.6.1.4.1.96.101.2.1.2.1.1.3.1 | wrpcAuxDiag102RoStatus .1 | N/A | bit 1 is 1 if overflow of latency accumulator | must be 0 |
rest time CYC | 1.3.6.1.4.1.96.101.2.1.2.1.1.4.1 | wrpcAuxDiag102RoResetTimeCycles.1 | 8 [ns] | reset time: clock cycles within TAI second | must not be 0 |
rest time LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.5.1 | wrpcAuxDiag102RoResetTimeTaiLsb.1 | [s] | reset time: LSB of TAI time in seconds | must not be 0 |
rest time MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.6.1 | wrpcAuxDiag102RoResetTimeTaiMsb.1 | 2^32 [s] | reset time: MSB of TAI time in seconds | must not be 0 |
latency max | 1.3.6.1.4.1.96.101.2.1.2.1.1.7.1 | wrpcAuxDiag102RoLatencyMax.1 | 8 [ns] | maximum latency in clock cycles since reset | > 0 |
latency min | 1.3.6.1.4.1.96.101.2.1.2.1.1.8.1 | wrpcAuxDiag102RoLatencyMin.1 | 8 [ns] | minimum latency in clock cycles since reset | <10000 [ns] |
frames sent LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.9.1 | wrpcAuxDiag102RoSentFrameCntLsb.1 | [frame] | number of transmitted frames (LSB) since reset | N/A |
frames sent MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.10.1 | wrpcAuxDiag102RoSentFrameCntMsb.1 | 2^32 [frame] | number of transmitted frames (MSB) since reset | N/A |
frames received LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.11.1 | wrpcAuxDiag102RoRcvdFrameCntLsb.1 | [frame] | number of received frames (LSB) since reset | N/A |
frames received MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.12.1 | wrpcAuxDiag102RoRcvdFrameCntMsb.1 | 2^32 [frame] | number of received frames (MSB) since reset | N/A |
frames lost LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.13.1 | wrpcAuxDiag102RoLostFrameCntLsb.1 | [frame] | number of lost frames (LSB) since reset | must be 0 |
frames lost MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.14.1 | wrpcAuxDiag102RoLostFrameCntMsb.1 | 2^32 [frame] | number of lost frames (MSB) since reset | must be 0 |
blocks lost LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.15.1 | wrpcAuxDiag102RoLostBlockCntLsb.1 | [block] | number of lost blocsk (LSB) since reset | must be 0 |
blocks lost MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.16.1 | wrpcAuxDiag102RoLostBlockCntMsb.1 | 2^32 [block] | number of lost blocsk (MSB) since reset | must be 0 |
lat acc cnt LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.17.1 | wrpcAuxDiag102RoLatencyCntLsb.1 | [frame] | number of latency values accumulated (LSB) since reset | N/A |
lat acc cnt MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.18.1 | wrpcAuxDiag102RoLatencyCntMsb.1 | 2^32 [frame] | number of latency values accumulated (MSB) since reset | N/A |
lat acc LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.19.1 | wrpcAuxDiag102RoLatencyAccLsb.1 | 8 [ns] | accumulated latency (LSB) in clock cycles since reset | N/A |
lat acc MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.20.1 | wrpcAuxDiag102RoLatencyAccMsb.1 | 8*2^32 [ns] | accumulated latency (MSB) in clock cycles since reset | N/A |
debug | 1.3.6.1.4.1.96.101.2.1.2.1.1.21.1 | wrpcAuxDiag102RoInputWord.1 | N/A | debug word | N/A |
magic | 1.3.6.1.4.1.96.101.2.1.2.1.1.22.1 | wrpcAuxDiag102RoMagicNumber.1 | N/A | magic value 0xDEADBEEF | must be 0xDEADBEEF |
fixed-latency frames successful LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.23.1 | wrpcAuxDiag102RoStatMatchCntLsb.1 | [frame] | number of frames (LSB) with execution on time | N/A |
fixed-latency frames successful MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.24.1 | wrpcAuxDiag102RoStatMatchCntMsb.1 | 2^32 [frame] | number of frames (MSB) with execution on time | N/A |
fixed-latency frames late LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.25.1 | wrpcAuxDiag102RoStatLateCntLsb.1 | [frame] | the number of frames (LSB) with missed execution | must be 0 |
fixed-latency frames late MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.26.1 | wrpcAuxDiag102RoStatLateCntMsb.1 | 2^32 [frame] | number of frames (MSB) with missed execution | must be 0 |
fixed-latency frames timeout LSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.27.1 | wrpcAuxDiag102RoStatTimeoutCntLsb.1 | [frame] | number of frames (MSB) with execution timeout | must be 0 |
fixed-latency frames timeout MSB | 1.3.6.1.4.1.96.101.2.1.2.1.1.28.1 | wrpcAuxDiag102RoStatTimeoutCntMsb.1 | 2^32 [frame] | number of frames (MSB) with execution timeout | must be 0 |
MIBs specific for the WR-streamers (read-write)
Name | OID number | OID name | Units | Meaning | Example threashold |
---|---|---|---|---|---|
reset | 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1 | wrpcAuxDiag102RwControlRegister.1 | N/A | bit 0 is set to 1, the statistics values are reset (write) | N/A |
freeze | 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1 | wrpcAuxDiag102RwControlRegister.1 | N/A | bit 1 is set to 1, the statistics values are frozen (write) | N/A |
12 May 2020