UM .NET API
6.16.1
|
LBM Receiver Transport Statistics. More...
Public Member Functions | |
LBMReceiverStatistics () | |
Instantiate an empty object containing no statistics. More... | |
unsafe | LBMReceiverStatistics (LBMReceiver lbmrcv, int maxStats) |
Instantiate object containing the aggregate set of statistics for a particular receiver. More... | |
unsafe | LBMReceiverStatistics (LBMHFXReceiver lbmrcv, int maxStats) |
Instantiate object containing the aggregate set of statistics for a particular receiver. More... | |
unsafe | LBMReceiverStatistics (LBMContext lbmctx, int maxStats) |
Instantiate object containing the aggregate set of statistics for a particular context. More... | |
unsafe | LBMReceiverStatistics (LBMReceiver lbmrcv, string source) |
Instantiate object containing the current set of statistics for a particular receiver and source. More... | |
unsafe | LBMReceiverStatistics (LBMHFXReceiver lbmrcv, string source) |
Instantiate object containing the current set of statistics for a particular receiver and source. More... | |
void | Dispose () |
Free memory associated with this set of statistics. | |
void | dispose () |
Free memory associated with this set of statistics (same as Dispose()). More... | |
unsafe void | refresh (LBMReceiver lbmrcv, int maxStats) |
Refresh the aggregate set of statistics for a particular receiver. More... | |
unsafe void | refresh (LBMHFXReceiver lbmrcv, int maxStats) |
Refresh the aggregate set of statistics for a particular receiver. More... | |
unsafe void | refresh (LBMContext lbmctx, int maxStats) |
Refresh the aggregate set of statistics for a particular context. More... | |
unsafe void | refresh (LBMReceiver lbmrcv, string source) |
Refresh the current set of statistics for a particular receiver and source. More... | |
unsafe void | refresh (LBMHFXReceiver lbmrcv, string source) |
Refresh the current set of statistics for a particular receiver and source. More... | |
int | size () |
Number of transport statistical sets encapsulated within this object. More... | |
int | type () |
Transport type (TCP, LBT-RM, LBT-RU, etc.) More... | |
int | type (int n) |
Transport type (TCP, LBT-RM, LBT-RU, etc.) More... | |
string | typeName () |
Transport type name (TCP, LBT-RM, LBT-RU, etc.). More... | |
string | typeName (int n) |
Transport type name (TCP, LBT-RM, LBT-RU, etc.). More... | |
string | source () |
Source of transport as a string. More... | |
string | source (int n) |
Source of transport as a string. More... | |
long | bytesReceived () |
Number of datagram bytes received (TCP, LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete message bytes received (BROKER) More... | |
long | bytesReceived (int n) |
Number of datagram bytes received (TCP, LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete message bytes received (BROKER) More... | |
long | messagesReceived () |
Number of datagrams received (LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete messages received (BROKER) More... | |
long | messagesReceived (int n) |
Number of datagrams received (LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete messages received (BROKER) More... | |
long | nakPacketsSent () |
Number of NAK packets sent by the receiver transport (LBT-RM, LBT-RU) More... | |
long | nakPacketsSent (int n) |
Number of NAK packets sent by the receiver transport (LBT-RM, LBT-RU) More... | |
long | naksSent () |
Number of individual NAKs sent by the receiver transport (LBT-RM, LBT-RU) More... | |
long | naksSent (int n) |
Number of individual NAKs sent by the receiver transport (LBT-RM, LBT-RU) More... | |
long | lost () |
Number of datagrams detected as lost (LBT-RM, LBT-RU) More... | |
long | lost (int n) |
Number of datagrams detected as lost (LBT-RM, LBT-RU) More... | |
long | ncfsIgnored () |
Number of NCFs received from a source transport with reason code "ignored" (LBT-RM, LBT-RU) More... | |
long | ncfsIgnored (int n) |
Number of NCFs received from a source transport with reason code "ignored" (LBT-RM, LBT-RU) More... | |
long | ncfsShed () |
Number of NCFs received with reason set to "shed" (LBT-RM, LBT-RU) More... | |
long | ncfsShed (int n) |
Number of NCFs received with reason set to "shed" (LBT-RM, LBT-RU) More... | |
long | ncfsRetransmissionDelay () |
Number of NCFs received with reason code "rx_delay" (LBT-RM, LBT-RU) More... | |
long | ncfsRetransmissionDelay (int n) |
Number of NCFs received with reason code "rx_delay" (LBT-RM, LBT-RU) More... | |
long | ncfsUnknown () |
Number of NCFs received with reason code "unknown" (LBT-RM, LBT-RU) More... | |
long | ncfsUnknown (int n) |
Number of NCFs received with reason code "unknown" (LBT-RM, LBT-RU) More... | |
long | minimumRecoveryTime () |
Minimum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | minimumRecoveryTime (int n) |
Minimum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | meanRecoveryTime () |
Mean time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | meanRecoveryTime (int n) |
Mean time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | maximumRecoveryTime () |
Maximum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | maximumRecoveryTime (int n) |
Maximum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU) More... | |
long | minimumNakTransmissions () |
Minimum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | minimumNakTransmissions (int n) |
Minimum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | meanNakTransmissions () |
Mean number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | meanNakTransmissions (int n) |
Mean number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | maximumNakTransmissions () |
Maximum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | maximumNakTransmissions (int n) |
Maximum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU) More... | |
long | duplicateMessages () |
Number of duplicate datagrams received (LBT-RM, LBT-RU) More... | |
long | duplicateMessages (int n) |
Number of duplicate datagrams received (LBT-RM, LBT-RU) More... | |
long | unrecoveredMessagesWindowAdvance () |
Number of datagrams unrecovered due to transmission window advance (LBT-RM, LBT-RU) More... | |
long | unrecoveredMessagesWindowAdvance (int n) |
Number of datagrams unrecovered due to transmission window advance (LBT-RM, LBT-RU) More... | |
long | unrecoveredMessagesNakGenerationTimeout () |
Number of messages unrecoverable due to NAK generation expiration (LBT-RM, LBT-RU) More... | |
long | unrecoveredMessagesNakGenerationTimeout (int n) |
Number of messages unrecoverable due to NAK generation expiration (LBT-RM, LBT-RU) More... | |
long | lbmMessagesReceived () |
Number of messages or message fragments received by the transport (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | lbmMessagesReceived (int n) |
Number of messages or message fragments received by the transport (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | lbmRequestsReceived () |
Number of UM requests received (message type LBM_MSG_REQUEST) (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | lbmRequestsReceived (int n) |
Number of UM requests received (message type LBM_MSG_REQUEST) (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | noTopicMessagesReceived () |
Number of messages received that were not for a a topic of interest to the receiver (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | noTopicMessagesReceived (int n) |
Number of messages received that were not for a a topic of interest to the receiver (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA) More... | |
long | datagramsDroppedIncorrectSize () |
Number of datagrams discarded due to size. More... | |
long | datagramsDroppedIncorrectSize (int n) |
Number of datagrams discarded due to size. More... | |
long | datagramsDroppedType () |
Number of datagrams discarded due to bad packet type. More... | |
long | datagramsDroppedType (int n) |
Number of datagrams discarded due to bad packet type. More... | |
long | datagramsDroppedVersion () |
Number of datagrams discarded due to version mismatch. More... | |
long | datagramsDroppedVersion (int n) |
Number of datagrams discarded due to version mismatch. More... | |
long | datagramsDroppedHeader () |
Number of datagrams discarded due to bad header type. More... | |
long | datagramsDroppedHeader (int n) |
Number of datagrams discarded due to bad header type. More... | |
long | datagramsDroppedSID () |
Number of datagrams discarded due to session ID mismatch. More... | |
long | datagramsDroppedSID (int n) |
Number of datagrams discarded due to session ID mismatch. More... | |
long | datagramsDroppedOther () |
Number of datagrams discarded due to other reasons. More... | |
long | datagramsDroppedOther (int n) |
Number of datagrams discarded due to other reasons. More... | |
long | outOfOrder () |
Number of out-of-order datagrams received. More... | |
long | outOfOrder (int n) |
Number of out-of-order datagrams received. More... | |
string | getApplicationSourceId () |
Retrieve the application source identifier associated with this set of statistics. More... | |
IPAddress | getSender () |
Retrieve the IP sender address associated with this set of statistics. More... | |
DateTime | getTimestamp () |
Retrieve the timestamp associated with this set of statistics. More... | |
long | getProcessId () |
Retrieve the sender process ID associated with this set of statistics. More... | |
long | getContextId () |
Retrieve the sender context ID associated with this set of statistics. More... | |
long | getObjectId () |
Retrieve the sender object ID associated with this set of statistics. More... | |
long | getSource () |
Retrieve the source attribute from the statistics attribute block associated with this set of statistics. More... | |
LBM Receiver Transport Statistics.
This object provides user monitoring with access to statistics of an application being monitored. The user monitoring code can be part of the application being monitored (i.e. the application can be "self-monitoring"), or the monitoring code can be remote, using the lbmmon infrastructure to deliver statistics. Note that when stats are sampled, the fields in the structure are not necessarily from the same instant in time. The structure might be updated concurrently with it being sampled, and while each structure field is atomically read, the field values can be skewed slightly across time.
com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | ) |
Instantiate an empty object containing no statistics.
unsafe com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | LBMReceiver | lbmrcv, |
int | maxStats | ||
) |
Instantiate object containing the aggregate set of statistics for a particular receiver.
This constructor will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmrcv | LBMReceiver object |
maxStats | Maximum number of sources |
unsafe com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | LBMHFXReceiver | lbmrcv, |
int | maxStats | ||
) |
Instantiate object containing the aggregate set of statistics for a particular receiver.
This constructor will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmrcv | LBMHFXReceiver object |
maxStats | Maximum number of sources |
unsafe com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | LBMContext | lbmctx, |
int | maxStats | ||
) |
Instantiate object containing the aggregate set of statistics for a particular context.
This constructor will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmctx | LBMContext object |
maxStats | Maximum number of sources |
unsafe com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | LBMReceiver | lbmrcv, |
string | source | ||
) |
Instantiate object containing the current set of statistics for a particular receiver and source.
lbmrcv | LBMReceiver object |
source | Source string (as returned by LBMMesage source()) that specifies the set of statistics to retrieve |
unsafe com.latencybusters.lbm.LBMReceiverStatistics.LBMReceiverStatistics | ( | LBMHFXReceiver | lbmrcv, |
string | source | ||
) |
Instantiate object containing the current set of statistics for a particular receiver and source.
lbmrcv | LBMHFXReceiver object |
source | Source string (as returned by LBMMesage source()) that specifies the set of statistics to retrieve |
long com.latencybusters.lbm.LBMReceiverStatistics.bytesReceived | ( | ) |
Number of datagram bytes received (TCP, LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete message bytes received (BROKER)
The total of lengths of all transport packets, including UM header information. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.bytesReceived | ( | int | n | ) |
Number of datagram bytes received (TCP, LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete message bytes received (BROKER)
The total of lengths of all transport packets, including UM header information. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedHeader | ( | ) |
Number of datagrams discarded due to bad header type.
These datagrams appeared to be intact, but with an unrecognizable header format. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedHeader | ( | int | n | ) |
Number of datagrams discarded due to bad header type.
These datagrams appeared to be intact, but with an unrecognizable header format. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedIncorrectSize | ( | ) |
Number of datagrams discarded due to size.
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedIncorrectSize | ( | int | n | ) |
Number of datagrams discarded due to size.
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedOther | ( | ) |
Number of datagrams discarded due to other reasons.
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedOther | ( | int | n | ) |
Number of datagrams discarded due to other reasons.
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedSID | ( | ) |
Number of datagrams discarded due to session ID mismatch.
These datagrams appeared to be correctly formed, but with an unmatched/unrecognized session ID field. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedSID | ( | int | n | ) |
Number of datagrams discarded due to session ID mismatch.
These datagrams appeared to be correctly formed, but with an unmatched/unrecognized session ID field. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedType | ( | ) |
Number of datagrams discarded due to bad packet type.
The datagram's type field must match the expectations of the receiver transport. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedType | ( | int | n | ) |
Number of datagrams discarded due to bad packet type.
The datagram's type field must match the expectations of the receiver transport. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedVersion | ( | ) |
Number of datagrams discarded due to version mismatch.
The datagram's version field must match the expectations of the receiver transport. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.datagramsDroppedVersion | ( | int | n | ) |
Number of datagrams discarded due to version mismatch.
The datagram's version field must match the expectations of the receiver transport. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
void com.latencybusters.lbm.LBMReceiverStatistics.dispose | ( | ) |
Free memory associated with this set of statistics (same as Dispose()).
Referenced by com.latencybusters.lbm.LBMObjectRecycler.close().
long com.latencybusters.lbm.LBMReceiverStatistics.duplicateMessages | ( | ) |
Number of duplicate datagrams received (LBT-RM, LBT-RU)
A large number can indicate a lossy network, primarily due to other receiver transports requesting retransmissions that this receiver transport has already successfully received. Such duplicates require extra effort for filtering, and This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.duplicateMessages | ( | int | n | ) |
Number of duplicate datagrams received (LBT-RM, LBT-RU)
A large number can indicate a lossy network, primarily due to other receiver transports requesting retransmissions that this receiver transport has already successfully received. Such duplicates require extra effort for filtering, and This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
|
inherited |
Retrieve the application source identifier associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
|
inherited |
Retrieve the sender context ID associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
|
inherited |
Retrieve the sender object ID associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
|
inherited |
Retrieve the sender process ID associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
|
inherited |
Retrieve the IP sender address associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
|
inherited |
Retrieve the source attribute from the statistics attribute block associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value. Compare return value to LBMMonitor.ATTR_SOURCE_NORMAL and LBMMonitor.ATTR_SOURCE_IM.
|
inherited |
Retrieve the timestamp associated with this set of statistics.
This attribute is only set for remote statistics returned by the lbmmon infrastructure. For locally-gathered statistics, this method returns an undefined value.
long com.latencybusters.lbm.LBMReceiverStatistics.lbmMessagesReceived | ( | ) |
Number of messages or message fragments received by the transport (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
A single datagram may contain one or more messages or a fragment of a larger message. For fragmented messages larger than the transport's configuration option transport_xxxxx_datagram_max_size, this count reflects the number of datagrams used to constitute those messages. Thus, this number is equal to or greater than the datagram counter (messagesReceived, above). This number also includes messages received for which there was no interested receiver, which is tallied in the noTopicMessagesReceived counter (below). This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.lbmMessagesReceived | ( | int | n | ) |
Number of messages or message fragments received by the transport (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
A single datagram may contain one or more messages or a fragment of a larger message. For fragmented messages larger than the transport's configuration option transport_xxxxx_datagram_max_size, this count reflects the number of datagrams used to constitute those messages. Thus, this number is equal to or greater than the datagram counter (messagesReceived, above). This number also includes messages received for which there was no interested receiver, which is tallied in the noTopicMessagesReceived counter (below). This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.lbmRequestsReceived | ( | ) |
Number of UM requests received (message type LBM_MSG_REQUEST) (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.lbmRequestsReceived | ( | int | n | ) |
Number of UM requests received (message type LBM_MSG_REQUEST) (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.lost | ( | ) |
Number of datagrams detected as lost (LBT-RM, LBT-RU)
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.lost | ( | int | n | ) |
Number of datagrams detected as lost (LBT-RM, LBT-RU)
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.maximumNakTransmissions | ( | ) |
Maximum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
A value higher than 1 suggests that there may have been some unrecoverable loss on the network during the sample period. A significantly high value compared to the mean number) implies an isolated incident. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.maximumNakTransmissions | ( | int | n | ) |
Maximum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
A value higher than 1 suggests that there may have been some unrecoverable loss on the network during the sample period. A significantly high value compared to the mean number) implies an isolated incident. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.maximumRecoveryTime | ( | ) |
Maximum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
If this time is near or equal to the configuration option setting for NAK generation interval, you have likely experienced some level of unrecoverable loss. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.maximumRecoveryTime | ( | int | n | ) |
Maximum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
If this time is near or equal to the configuration option setting for NAK generation interval, you have likely experienced some level of unrecoverable loss. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.meanNakTransmissions | ( | ) |
Mean number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
Ideally this should be at or near 1. A higher value indicates a lossy network. This is an exponentially weighted moving average (weighted to more recent) for accumulated NAKs per lost message. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.meanNakTransmissions | ( | int | n | ) |
Mean number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
Ideally this should be at or near 1. A higher value indicates a lossy network. This is an exponentially weighted moving average (weighted to more recent) for accumulated NAKs per lost message. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.meanRecoveryTime | ( | ) |
Mean time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
This is an exponentially weighted moving average (weighted to more recent) for accumulated measured recovery times. Ideally this field should be as close to your minimum recovery time (nak_stm_min, above) as possible. High mean recovery times indicate a lossy network. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.meanRecoveryTime | ( | int | n | ) |
Mean time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
This is an exponentially weighted moving average (weighted to more recent) for accumulated measured recovery times. Ideally this field should be as close to your minimum recovery time (nak_stm_min, above) as possible. High mean recovery times indicate a lossy network. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.messagesReceived | ( | ) |
Number of datagrams received (LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete messages received (BROKER)
Depending on batching settings, a single datagram may contain one or more messages, or a fragment of a larger message. Larger messages are split into fragment sizes limited by the transport's configuration option transport_xxxx_datagram_max_size. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.messagesReceived | ( | int | n | ) |
Number of datagrams received (LBT-RM, LBT-RU, LBT-IPC, LBT-RDMA) or complete messages received (BROKER)
Depending on batching settings, a single datagram may contain one or more messages, or a fragment of a larger message. Larger messages are split into fragment sizes limited by the transport's configuration option transport_xxxx_datagram_max_size. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.minimumNakTransmissions | ( | ) |
Minimum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
A value greater than 1 indicates a chronically lossy network. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.minimumNakTransmissions | ( | int | n | ) |
Minimum number of times per lost message that a receiver transport transmitted a NAK. (LBT-RM, LBT-RU)
A value greater than 1 indicates a chronically lossy network. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.minimumRecoveryTime | ( | ) |
Minimum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
If this time is greater than configuration option for NAK backoff interval, it may be taking multiple NAKs to initiate retransmissions, indicating a lossy network. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.minimumRecoveryTime | ( | int | n | ) |
Minimum time (in milliseconds) in which loss recovery was accomplished (LBT-RM, LBT-RU)
If this time is greater than configuration option for NAK backoff interval, it may be taking multiple NAKs to initiate retransmissions, indicating a lossy network. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.nakPacketsSent | ( | ) |
Number of NAK packets sent by the receiver transport (LBT-RM, LBT-RU)
UM batches NAKs into NAK packets to save network bandwidth. This should always be less than or equal to the number of individual NAKs sent (naksSent, below). This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.nakPacketsSent | ( | int | n | ) |
Number of NAK packets sent by the receiver transport (LBT-RM, LBT-RU)
UM batches NAKs into NAK packets to save network bandwidth. This should always be less than or equal to the number of individual NAKs sent (naksSent, below). This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.naksSent | ( | ) |
Number of individual NAKs sent by the receiver transport (LBT-RM, LBT-RU)
This may differ from the tally of lost datagrams (below) due to reasons such as
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.naksSent | ( | int | n | ) |
Number of individual NAKs sent by the receiver transport (LBT-RM, LBT-RU)
This may differ from the tally of lost datagrams (below) due to reasons such as
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsIgnored | ( | ) |
Number of NCFs received from a source transport with reason code "ignored" (LBT-RM, LBT-RU)
If a source transport receives a NAK for a datagram that it has recently retransmitted, it sends an "NCF ignored" and does not retransmit. How recently" is determined by the configuration option for ignore interval. If this count is high, a receiver transport may be having trouble receiving retransmissions, or the ignore interval may be set too long. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsIgnored | ( | int | n | ) |
Number of NCFs received from a source transport with reason code "ignored" (LBT-RM, LBT-RU)
If a source transport receives a NAK for a datagram that it has recently retransmitted, it sends an "NCF ignored" and does not retransmit. How recently" is determined by the configuration option for ignore interval. If this count is high, a receiver transport may be having trouble receiving retransmissions, or the ignore interval may be set too long. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsRetransmissionDelay | ( | ) |
Number of NCFs received with reason code "rx_delay" (LBT-RM, LBT-RU)
When a source transport's retransmit rate limiter prevents it from immediately retransmitting any more lost datagrams, it responds to a NAK by sending an "NCF rx_delay", then queues the retransmission for a later send. The receiver transport should wait for the retransmission and not immediately send another NAK. If this count is high, one or more crybaby receiver transports may be clogging the source transport's retransmit queue. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsRetransmissionDelay | ( | int | n | ) |
Number of NCFs received with reason code "rx_delay" (LBT-RM, LBT-RU)
When a source transport's retransmit rate limiter prevents it from immediately retransmitting any more lost datagrams, it responds to a NAK by sending an "NCF rx_delay", then queues the retransmission for a later send. The receiver transport should wait for the retransmission and not immediately send another NAK. If this count is high, one or more crybaby receiver transports may be clogging the source transport's retransmit queue. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsShed | ( | ) |
Number of NCFs received with reason set to "shed" (LBT-RM, LBT-RU)
When a source transport's retransmit queue and rate limiter are both at maximum, it responds to a NAK by sending an "NCF shed", and does not retransmit. The receiver transport should wait, then send another NAK. If this count is high, one or more crybaby receiver transports may be clogging the source transport's retransmit queue. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsShed | ( | int | n | ) |
Number of NCFs received with reason set to "shed" (LBT-RM, LBT-RU)
When a source transport's retransmit queue and rate limiter are both at maximum, it responds to a NAK by sending an "NCF shed", and does not retransmit. The receiver transport should wait, then send another NAK. If this count is high, one or more crybaby receiver transports may be clogging the source transport's retransmit queue. retransmission queue. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsUnknown | ( | ) |
Number of NCFs received with reason code "unknown" (LBT-RM, LBT-RU)
These are NCFs with a reason code this receiver transport does not recognize. After a delay (set by configuration option for NAK suppress interval), it resends the NAK. This counter should never be greater than 0 unless applications linked with different versions of Ultra Messaging software coexist on the same network. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.ncfsUnknown | ( | int | n | ) |
Number of NCFs received with reason code "unknown" (LBT-RM, LBT-RU)
These are NCFs with a reason code this receiver transport does not recognize. After a delay (set by configuration option for NAK suppress interval), it resends the NAK. This counter should never be greater than 0 unless applications linked with different versions of Ultra Messaging software coexist on the same network. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.noTopicMessagesReceived | ( | ) |
Number of messages received that were not for a a topic of interest to the receiver (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
A high value (relative to, or approaching lbmMessagesReceived above) indicates more CPU time required to filter out uninteresting topics, in which case, consider reconfiguring sources to filter more aggressively at the transport layer. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.noTopicMessagesReceived | ( | int | n | ) |
Number of messages received that were not for a a topic of interest to the receiver (TCP, LBM-RM, LBT-RU, LBT-IPC, LBT-RDMA)
A high value (relative to, or approaching lbmMessagesReceived above) indicates more CPU time required to filter out uninteresting topics, in which case, consider reconfiguring sources to filter more aggressively at the transport layer. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.outOfOrder | ( | ) |
Number of out-of-order datagrams received.
A datagram is counted as out of order if it fills a previously detected sequence gap, but is not a retransmission. Note that if the duplicates counter duplicate_data, above) increases along with this statistic, this implies the arrivals of retransmitted datagrams before their originals. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.outOfOrder | ( | int | n | ) |
Number of out-of-order datagrams received.
A datagram is counted as out of order if it fills a previously detected sequence gap, but is not a retransmission. Note that if the duplicates counter duplicate_data, above) increases along with this statistic, this implies the arrivals of retransmitted datagrams before their originals. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
unsafe void com.latencybusters.lbm.LBMReceiverStatistics.refresh | ( | LBMReceiver | lbmrcv, |
int | maxStats | ||
) |
Refresh the aggregate set of statistics for a particular receiver.
This method will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmrcv | LBMReceiver object |
maxStats | Maximum number of sources |
com.latencybusters.lbm.LBMException | Invalid argument or unexpected operational behavior has been encountered by unmanaged LBM C layer function. |
References com.latencybusters.lbm.LBM.errorMessage(), and com.latencybusters.lbm.LBM.errorNumber().
Referenced by com.latencybusters.lbm.LBMContext.getReceiverStatistics(), com.latencybusters.lbm.LBMHFXReceiver.getStatistics(), and com.latencybusters.lbm.LBMReceiver.getStatistics().
unsafe void com.latencybusters.lbm.LBMReceiverStatistics.refresh | ( | LBMHFXReceiver | lbmrcv, |
int | maxStats | ||
) |
Refresh the aggregate set of statistics for a particular receiver.
This method will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmrcv | LBMHFXReceiver object |
maxStats | Maximum number of sources |
com.latencybusters.lbm.LBMException | Invalid argument or unexpected operational behavior has been encountered by unmanaged LBM C layer function. |
References com.latencybusters.lbm.LBM.errorMessage(), and com.latencybusters.lbm.LBM.errorNumber().
unsafe void com.latencybusters.lbm.LBMReceiverStatistics.refresh | ( | LBMContext | lbmctx, |
int | maxStats | ||
) |
Refresh the aggregate set of statistics for a particular context.
This method will throw LBMEInvalException if maxStats is less than the the available number of transport statistical sets.
lbmctx | LBMContext object |
maxStats | Maximum number of sources |
com.latencybusters.lbm.LBMException | Invalid argument or unexpected operational behavior has been encountered by unmanaged LBM C layer function. |
References com.latencybusters.lbm.LBM.errorMessage(), and com.latencybusters.lbm.LBM.errorNumber().
unsafe void com.latencybusters.lbm.LBMReceiverStatistics.refresh | ( | LBMReceiver | lbmrcv, |
string | source | ||
) |
Refresh the current set of statistics for a particular receiver and source.
lbmrcv | LBMReceiver object |
source | Source string (as returned by LBMMesage source()) that specifies the set of statistics to retrieve |
com.latencybusters.lbm.LBMException | Invalid argument or unexpected operational behavior has been encountered by unmanaged LBM C layer function. |
com.latencybusters.lbm.LBMEOPException | Unknown transport |
com.latencybusters.lbm.LBMEInvalException | Statistics not found |
References com.latencybusters.lbm.LBM.errorMessage(), and com.latencybusters.lbm.LBM.errorNumber().
unsafe void com.latencybusters.lbm.LBMReceiverStatistics.refresh | ( | LBMHFXReceiver | lbmrcv, |
string | source | ||
) |
Refresh the current set of statistics for a particular receiver and source.
lbmrcv | LBMHFXReceiver object |
source | Source string (as returned by LBMMesage source()) that specifies the set of statistics to retrieve |
com.latencybusters.lbm.LBMException | Invalid argument or unexpected operational behavior has been encountered by unmanaged LBM C layer function. |
com.latencybusters.lbm.LBMEOPException | Unknown transport |
com.latencybusters.lbm.LBMEInvalException | Statistics not found |
References com.latencybusters.lbm.LBM.EINVAL, com.latencybusters.lbm.LBM.EOP, com.latencybusters.lbm.LBM.errorMessage(), com.latencybusters.lbm.LBM.errorNumber(), com.latencybusters.lbm.LBM.TRANSPORT_STAT_BROKER, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTIPC, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRDMA, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRM, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRU, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTSMX, and com.latencybusters.lbm.LBM.TRANSPORT_STAT_TCP.
int com.latencybusters.lbm.LBMReceiverStatistics.size | ( | ) |
Number of transport statistical sets encapsulated within this object.
string com.latencybusters.lbm.LBMReceiverStatistics.source | ( | ) |
Source of transport as a string.
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class. The string format depends on transport type and is described under LBMTransportSourceInfo.
string com.latencybusters.lbm.LBMReceiverStatistics.source | ( | int | n | ) |
Source of transport as a string.
This method returns a value from the nth set of statistics encapsulated within this object. The string format depends on transport type and is described under LBMTransportSourceInfo.
n | Statistics set index |
int com.latencybusters.lbm.LBMReceiverStatistics.type | ( | ) |
Transport type (TCP, LBT-RM, LBT-RU, etc.)
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
int com.latencybusters.lbm.LBMReceiverStatistics.type | ( | int | n | ) |
Transport type (TCP, LBT-RM, LBT-RU, etc.)
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
string com.latencybusters.lbm.LBMReceiverStatistics.typeName | ( | ) |
Transport type name (TCP, LBT-RM, LBT-RU, etc.).
This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
string com.latencybusters.lbm.LBMReceiverStatistics.typeName | ( | int | n | ) |
Transport type name (TCP, LBT-RM, LBT-RU, etc.).
This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
References com.latencybusters.lbm.LBM.TRANSPORT_STAT_BROKER, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTIPC, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRDMA, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRM, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTRU, com.latencybusters.lbm.LBM.TRANSPORT_STAT_LBTSMX, and com.latencybusters.lbm.LBM.TRANSPORT_STAT_TCP.
long com.latencybusters.lbm.LBMReceiverStatistics.unrecoveredMessagesNakGenerationTimeout | ( | ) |
Number of messages unrecoverable due to NAK generation expiration (LBT-RM, LBT-RU)
This is controlled by the transport's nak_generation_interval, with a default of 10000ms. This field also includes messages declared unrecoverable due to a burst loss event (LBM_MSG_UNRECOVERABLE_LOSS_BURST). This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.unrecoveredMessagesNakGenerationTimeout | ( | int | n | ) |
Number of messages unrecoverable due to NAK generation expiration (LBT-RM, LBT-RU)
This is controlled by the transport's nak_generation_interval, with a default of 10000ms. This field also includes messages declared unrecoverable due to a burst loss event (LBM_MSG_UNRECOVERABLE_LOSS_BURST). This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |
long com.latencybusters.lbm.LBMReceiverStatistics.unrecoveredMessagesWindowAdvance | ( | ) |
Number of datagrams unrecovered due to transmission window advance (LBT-RM, LBT-RU)
This means that the message was no longer in the source-side transmission window and therefore not retransmitted. The window size is set by the transport configuration option for transmission window size. This method returns a value from the first set of statistics encapsulated within this object and would normally be used when the object has been created using a specific source to instantiate the class.
long com.latencybusters.lbm.LBMReceiverStatistics.unrecoveredMessagesWindowAdvance | ( | int | n | ) |
Number of datagrams unrecovered due to transmission window advance (LBT-RM, LBT-RU)
This means that the message was no longer in the source-side transmission window and therefore not retransmitted. The window size is set by the transport configuration option for transmission window size. This method returns a value from the nth set of statistics encapsulated within this object.
n | Statistics set index |