sun.com | docs.sun.com | How To Buy | My Sun | Worldwide Sites |  |

| Previous Contents Index Next
Chapter 6 # Carrier Grade Transport Protocol Statistics For information about the Carrier Grade Transfer Protocol (CGTP) statistics that can be accessed from the NMA, see the following sections: Introducing CGTP Statistics CGTP Master Statistics CGTP Node Statistics ## Introducing CGTP Statistics The CGTP statistics collected by the NMA can be used to ascertain the degree of success with which CGTP is operating in a running cluster. Network traffic conditions might slow down or prohibit the arrival of duplicate packets, or a bottleneck might occur at the local or remote end of the CGTP link. CGTP statistics provide a measure of the success with which CGTP is operating. These statistics are also useful for diagnosing the source of bad performance or failure. Using the CGTP statistics collected by the NMA it is possible to measure the success of packet duplication and filtering, redundant link by redundant link, and pinpoint the source of slow performance or packet loss. For more information about CGTP, see the Netra High Availability Suite Foundation Services 2.1 6/03 Overview. Set the `com.sun.nhas.ma.cgtp.polling` property to specify the interval in milliseconds between sequential updates of CGTP information in the NMA. ## CGTP Master Statistics ### `CgtpMasterMBean` The `CgtpMasterMBean` MBean exposes the CGTP master node view. This MBean provides lists of local and remote CGTP addresses. One MBean implementing the `CgtpMasterMBean` interface is instantiated on the cluster master node. #### Getting All Local CGTP Addresses for Which Statistics are Available To return the list of all local CGTP addresses for which statistics are available, invoke the `getLocalCgtpAddresses` method. The `getLocalCgtpAddresses` method takes no parameters, and returns a `String[]`. If statistics are not available, the method returns `null`. #### Getting All Remote CGTP Addresses for Which Statistics are Available To return the list of remote CGTP addresses for which statistics are available, invoke the `getRemoteCgtpAddresses` method. The `getRemoteCgtpAddresses` method takes no parameters, and returns a `String[]`. If statistics are not available, the method returns `null`. ## CGTP Node Statistics ### `CgtpMBean` One instance of the `CgtpMBean` is instantiated on each node. #### Getting All Local CGTP Addresses for Which Statistics Are Available To return the list of all local CGTP addresses for which statistics are available, invoke the `getLocalCgtpAddresses` method. The `getLocalCgtpAddresses` method takes no parameters, and returns a `String[]`. If statistics are not available, the method returns `null`. #### Getting All Remote CGTP Addresses for Which Statistics Are Available To return the list of remote CGTP addresses for which statistics are available, invoke the `getRemoteCgtpAddresses` method. The `getRemoteCgtpAddresses` method takes no parameters, and returns a `String[]`. If statistics are not available, the method returns `null`. ### `CgtpEmitterStatisticsMBean` The `CgtpEmitterStatisticsMBean` MBean provides statistics about the packets a node has sent through the local subinterface, in the reliable link operated by CGTP from a local CGTP address to a remote CGTP address. #### Getting the Number of Packets Sent Through Each Subinterface To get the number of packets sent through each local subinterface taking part in the reliable link, invoke the `getSubInterfaceSentCount` method. The subinterfaces are placed in the same order as that used in `CgtpReliableLinkStatisticsMBean.getSubInterfaceAddresses()`. The `getSubInterfaceSentCount` method takes no parameters, and returns an `int[]`. ### `CgtpFilterMBean` This MBean interface exposes the statistics available on the CGTP filter. There is one MBean per node which provides information on the CGTP filter. #### Getting the Number of Packets Not Received in Duplicate To get the number of packets that have not been duplicated, invoke the `getFilterFailure` method. The `getFilterFailure` method takes no parameters, and returns a `long`. #### Getting the Amount of Memory Currently Used by the Filter Module To get the amount of memory used by the filter module, invoke the `getFilterMemory` method. The `getFilterMemory` method takes no parameters, and returns a `long`. #### Getting the Number of Packets Successfully Received To get the number of packets successfully received and successfully filtered, invoke the `getFilterSuccess` method. The `getFilterSuccess` method takes no parameters, and returns a `long`. #### Getting the Number of Filter Tables Used by the Filter Module To get the current number of filter tables used by the filter module, invoke the `getFilterTables` method. The `getFilterTables` method takes no parameters, and returns an `int`. #### Getting the Number of Hash Table Collisions To get the number of collisions that have occurred in the hash table, invoke the `getHashCollisions` method. The `getHashCollisions` method takes no parameters, and returns an `int`. #### Getting the Number of Direct Hash Table Entries To get the number of direct entries in the hash table, invoke the `getHashDirect` method. The `getHashDirect` method takes no parameters, and returns an `int`. #### Getting the Number of Hash Table Entries To get the number of entries in the hash table, invoke the `getHashEntries` method. The `getHashEntries` method takes no parameters, and returns an `int`. #### Getting the Number of Packets Not Received To get the number of packets for which filtering has failed on the local node for each interface, invoke the `getInterfaceFilterFailure` method. The `getInterfaceFilterFailure` method takes no parameters, and returns a `long[]`. #### Getting the Maximum Amount of Memory Used by the Filter Module To get the highest amount of memory used by the filter, invoke the `getMaxFilterMemory` method. The `getMaxFilterMemory` method takes no parameters, and returns a `long`. #### Getting the Maximum Number of Filter Tables Used by the Filter Module To get the maximum number of filter tables used by the filter module, invoke the `getMaxFilterTables` method. The `getMaxFilterTables` method takes no parameters, and returns an `int`. #### Getting the Maximum Number of Ticks Allowed Before Duplicate Arrives To get the maximum number of ticks allowed until the duplicate of a packet is received and the packet is validated as successfully filtered, invoke the `getMaxTickPremiumToDuplicate` method. The `getMaxTickPremiumToDuplicate` method takes no parameters, and returns an `int`. If the duplicate packet does not arrive within the tick period, the package will not be validated as successfully filtered. #### Getting the Number of Packets Waiting for Duplicate Reception To get the number of packets for which no duplicate has yet been received, invoke the `getPremiumPacket` method. The `getPremiumPacket` method takes no parameters, and returns an `int`. ### `CgtpReceiverStatisticsMBean` The `CgtpReceiverStatisticsMBean` MBean provides statistics about the packets received by this node through the reliable link operated by CGTP from a remote CGTP address to a local CGTP address. #### Getting the Number of Packets Not Successfully Filtered To return the number of packets not successfully filtered on reception, invoke the `getFilterFailureCount` method. The `getFilterFailureCount` method takes no parameters, and returns an `int`. #### Getting the Number of Packets Successfully Filtered To return the number of packets successfully filtered on reception, invoke the `getFilterSuccessCount` method. The `getFilterSuccessCount` method takes no parameters, and returns an `int`. #### Getting the Number of Packets Received Through Each Subinterface To return the number of packets received through each local subinterface taking part in the reliable link, invoke the `getSubInterfaceReceivedCount` method. The subinterfaces are placed in the same order as that used in `CgtpReliableLinkStatisticsMBean.getSubInterfaceAddresses()`. The `getSubInterfaceReceivedCount` method takes no parameters, and returns an `int[]`. ### `CgtpReliableLinkStatisticsMBean` The `CgtpReliableLinkStatisticsMBean` MBean lists the addresses of the subinterfaces, and the reliable link addresses currently in use by the Reliable Transport Service. #### Getting the Remote Subinterface Addresses To get the remote interface addresses used by CGTP to send and receive packets, invoke the `getGatewayAddresses` method. The number of redundant links making up the reliable link is limited to two. The array elements are ordered identically to the subinterface. The `getGatewayAddresses` method takes no parameters, and returns a `String[]`.
Previous Contents Index Next

Copyright 1994-2004 Sun Microsystems