SNMP

rvtrace embeds an SNMP agent. You can use SNMP applications to query rvtrace statistics and trap SNMP events (as listed in SNMP Objects in rvtrace).

SNMP Objects in rvtrace

Object Name

Description

Network Totals

rvNetTotals

Grouping for all network totals.

rvTrdpMCPktTotals

Grouping for network totals related to multicast data packets.

rvTrdpMCDataPktTotal

Total multicast or broadcast data packets.

rvTrdpMCDataByteTotal

Total payload bytes in all multicast or broadcast data packets.

rvTrdpMCRtPktTotal

Total multicast or broadcast retransmission packets.

rvTrdpMCRtByteTotal

Total payload bytes in all multicast or broadcast retransmit packets.

rvTrdpMCNullPktTotal

Total null packets.

When a Rendezvous daemon has no data packets to transmit, it periodically sends null packets to maintain continuity.

rvTrdpMCSeqGapTotal

Total Rendezvous packets that rvtrace missed.

rvtrace tracks the serial numbers of Rendezvous packets. This object counts the missing packets in each sequence gap of multicast or broadcast data packets. For more information, see Gaps Diagnoses.

rvTrdpMCBadPktTotal

Total bad multicast data packets.

Bad packets lack UDP checksums, or are corrupt in some other way.

Warning 

See Bad Packets.

rvTrdpRtPktTotals

Grouping for network totals related to retransmitted multicast or broadcast packets.

rvTrdpRtReqPktTotal

Total retransmission request packets.

Each request packet counts separately, even if several request packets specify the same data packet numbers for retransmission. For example, if two daemons each request retransmission of the data packets numbered 121–125, and a third daemon requests retransmission of the data packets numbered 100–144, then this total increases by 3.

rvTrdpRtReqSeqTotal

Total of requested sequence numbers summed over all retransmission requests.

Each retransmission request packet can solicit one or more data packets for retransmission. This object sums the number of data packets for which retransmission is requested.

If some data packets are requested several times, each data packet counts separately each time it is requested. For example, if three daemons request retransmission of data packets numbered 121–125, then this total increases by 15.

For more information, see Diagnoses.

rvTrdpRtRejPktTotal

Total retransmission rejections.

Although Rendezvous daemons comply with retransmission requests whenever possible, sometimes the requested packets are no longer available. This object counts the number of packets that contain retransmission rejections.

rvTrdpRtBadPktTotal

Total bad multicast retransmission packets.

Bad packets lack UDP checksums, or are corrupt in some other way.

Warning 

See Bad Packets.

rvPtpPktTotals

Grouping for network totals related to point-to-point packets.

rvPtpDataPktTotal

Total point-to-point data packets.

rvPtpDataByteTotal

Total payload bytes in all point-to-point data packets.

rvPtpAckRPktTotal

Total acknowledgement request packets.

Sending Rendezvous daemons explicitly request positive acknowledgment for groups of point-to-point data packets. This object counts the number of packets containing acknowledgment requests for point-to-point data packets.

rvPtpAckPktTotal

Total acknowledgement packets.

Receiving Rendezvous daemons explicitly acknowledge groups of point-to-point data packets upon request from sending daemons. This object counts the number of packets containing acknowledgments for point-to-point data packets.

rvPtpNakPktTotal

Total negative acknowledgement packets.

Receiving Rendezvous daemons use negative acknowledgments (NAKs) to request retransmission of missing data point-to-point packets. This column displays the number of packets containing retransmission requests for point-to-point data packets.

For more information, see Nak Diagnoses.

rvPtpBadPktTotal

Total bad point-to-point packets.

Bad packets lack UDP checksums, or are corrupt in some other way.

Warning 

See Bad Packets.

rvSubjectTotals

Grouping for network totals related to Rendezvous subjects.

rvSubjMsgTotal

Total number of messages (summed over all subjects).

rvSubjByteTotal

Total number of payload bytes (summed over all subjects).

Thresholds

rvTrdpRtThreshold

Threshold for retransmit trap.

When the ratio rvTrdpMCRtByteTotal/rvTrdpMCDataByteTotal exceeds this threshold (expressed as a percentage), rvtrace sets the SNMP trap rvTrdpNotifyRetransmit.

The default threshold is 2%.

rvBadPktThreshold

Threshold for bad packet trap.

When the number of bad packets during an interval exceeds this threshold, rvtrace sets the SNMP trap rvNotifyBadPkts. Bad packets of any type count toward this threshold.

The default threshold is zero—that is, trap even for one bad packet.

Multicast Host Snapshot

rvTrdpMCHostTable

Table of multicast statistics, with one entry for each triple of sending host (rvTrdpMCHostAddr), service port (rvTrdpMCPort), and destination address (rvTrdpMCDestAddr).

rvTrdpMCPort

Service port of packets counted in the table entry.

rvTrdpMCHostAddr

IP address of the host that is the source of multicast or broadcast packets counted in the table entry.

rvTrdpMCDestAddr

Destination address of packets counted in the table entry. The destination can be a multicast address or an IP (broadcast) address.

rvTrdpMCHostDataPkts

Number of data packets for this triple.

rvTrdpMCHostDataBytes

Number of payload bytes in data packets for this triple.

rvTrdpMCHostRtPkts

Number of retransmission packets for this triple.

rvTrdpMCHostRtBytes

Number of payload bytes in retransmission packets for this triple.

rvTrdpMCHostNullPkts

Number of null packets for this triple.

rvTrdpMCHostSeqGaps

Number of requested sequence numbers summed over all retransmission requests for this triple.

Each retransmission request packet can solicit one or more data packets for retransmission. This object sums the number of data packets for which retransmission is requested.

For more information, see Diagnoses.

rvTrdpMCHostBadPkts

Number of bad multicast or broadcast packets for this triple.

Multicast Retransmission Host Snapshot

rvTrdpRtHostTable

Table of multicast retransmission statistics, with one entry for each pair of host (rvTrdpRtHostAddr) and service port (rvTrdpRtPort).

Entries in this table count several types of packets related to the retransmission request protocol for multicast or broadcast data.

rvTrdpRtPort

Service port of packets counted in the table entry.

rvTrdpRtHostAddr

IP address of the host that is the source or destination of packets counted in the table entry.

rvTrdpRtReqPktsSrc

Number of retransmission request packets sent by the host (that is, the host is the source of the request packet).

These packets indicate that the receiving Rendezvous daemon on the host missed inbound data packets, and has requested retransmission.

Each request packet counts separately, even if several request packets specify the same data packet numbers for retransmission.

rvTrdpRtReqSeqSrc

Number of data packet sequence numbers requested by the host (that is, the host is the source of the request).

Each retransmission request packet can solicit one or more data packets for retransmission. This item counts the number of data packets for which the host requested retransmission, summing them over the request packets (as counted by rvTrdpRtReqPktsSrc).

If the host requests some data packets several times, each data packet counts separately each time the host requests it. For more information, see Diagnoses.

rvTrdpRtRejPktsSrc

Number of retransmission rejection notices sent by the host (that is, the host is the source of the rejection packet).

Although Rendezvous daemons comply with retransmission requests whenever possible, sometimes the requested data packets are no longer available.

rvTrdpRtBadPktsSrc

Number of bad retransmission request packets sent by the host (that is, the host is the source of the bad packet).

Bad packets lack UDP checksums, or are corrupt in some other way.

Warning 

See Bad Packets.

rvTrdpRtReqPktsDest

Number of retransmission request packets indicating the host as destination.

These packets indicate that receiving Rendezvous daemons missed data, and requested retransmission from the host.

Each request packet counts separately, even if several request packets specify the same data packet numbers for retransmission.

rvTrdpRtReqSeqDest

Number of data packet sequence numbers requested from the host.

Each retransmission request packet can solicit one or more data packets for retransmission. This item counts the number of data packets requested, summing them over the request packets (as counted by rvTrdpRtReqPktsDest).

If several daemons request a data packet several times, each request counts separately. For more information, see Diagnoses.

rvTrdpRtRejPktsDest

Number of retransmission rejection notices indicating the host as destination.

Although Rendezvous daemons comply with retransmission requests whenever possible, sometimes the requested data packets are no longer available.

rvTrdpRtBadPktsDest

Number of bad retransmission request packets indicating the host as destination.

Bad packets lack UDP checksums, or are corrupt in some other way.

Warning 

See Bad Packets.

Point-to-Point Host Snapshot

rvPtpHostTable

Table of point-to-point statistics, with one entry for each pair of host (rvPtpHostAddr) and service port (rvPtpPort)

rvPtpPort

Service port of packets counted in the table entry.

rvPtpHostAddr

IP address of the host that is the source or destination of packets counted in the table entry.

rvPtpPktsSrc

Number of point-to-point data packets sent by the host (that is, the host is the source of the data packet).

rvPtpBytesSrc

Number of payload bytes summed over point-to-point data packets sent by the host (that is, the host is the source of the data).

rvPtpAckRPktsSrc

Number of packets requesting acknowledgement sent by the host (that is, the host is the source of the acknowledgement request packet).

rvPtpAckPktsSrc

Number of ACK packets sent by the host.

rvPtpNakPktsSrc

Number of NAK packets sent by the host.

rvPtpBadPktsSrc

Number of bad packets sent by the host.

rvPtpPktsDest

Number of point-to-point data packets indicating the host as destination.

rvPtpBytesDest

Number of payload bytes summed over data packets indicating the host as destination.

rvPtpAckRPktsDest

Number of acknowledgement request packets indicating the host as destination.

rvPtpAckPktsDest

Number of ACK packets indicating the host as destination.

rvPtpNakPktsDest

Number of NAK packets indicating the host as destination.

rvPtpBadPktsDest

Number of bad packets indicating the host as destination.

Subject Snapshot

rvSubjTable

Table of subject statistics, with one entry for each pair of subject (rvSubject) and service port (rvSubjPort)

rvSubjPort

Service port of messages counted in the table entry.

rvSubject

Subject of messages counted in the table entry.

rvSubjMsgs

Number of messages for this pair.

rvSubjBytes

Number of payload bytes summed over messages for this pair.

Traps

rvtraceStart

Notify when the SNMP agent in rvtrace starts.

rvtraceStop

Notify when the SNMP agent in rvtrace stops.

rvTrdpNotifyRetransmit

Notify when the ratio rvTrdpMCRtByteTotal/rvTrdpMCDataByteTotal—expressed as a percentage—exceeds rvTrdpRtThreshold.

rvNotifyBadPkts

Notify when the number of bad packets during an interval exceeds rvBadPktThreshold.