A Oracle Coherence MBeans Reference

This appendix provides a reference of the MBeans for managing and monitoring different parts of Oracle Coherence. The reference provides a detailed description of the attributes and operations of the MBeans.

The Registration interface also includes descriptions of the MBeans. See the Registration interface in the Java API Reference for Oracle Coherence. An MBean-capable agent (such as JConsole) also shows MBean information. See Chapter 2, "Using JMX to Manage Oracle Coherence," for more information about accessing Oracle Coherence MBeans.

Table A-1 lists the MBeans for managing and monitoring Oracle Coherence.

Table A-1 Oracle Coherence MBeans

MBean Description

CacheMBean

Represents a cache. A cluster member includes zero or more instances of this managed bean.

ClusterMBean

Represents a cluster. Each cluster member includes a single instance of this managed bean.

ClusterNodeMBean

Represents a cluster member. Each cluster member includes a single instance of this managed bean.

ConnectionManagerMBean

Represents an Oracle Coherence*Extend proxy. A cluster member includes zero or more instances of this managed bean.

ConnectionMBean

Represents a remote client connection through Oracle Coherence*Extend. A cluster member includes zero or more instances of this managed bean.

FlashJournalRM

Represents a flash journal resource manager. The managed bean is an instance of the JournalMBean interface. Each cluster member includes a single instance of this managed bean.

ManagementMBean

Represents the grid JMX infrastructure. Each cluster member includes a single instance of this managed bean.

PointToPointMBean

Represents the network status between two cluster members. Each cluster member includes a single instance of this managed bean.

RamJournalRM

Represents a RAM journal resource manager. The managed bean is an instance of the JournalMBean interface. Each cluster member includes a single instance of this managed bean.

ReporterMBean

Represents the Oracle Coherence reporter. Each cluster member includes a single instance of this managed bean.

ServiceMBean

Represents a clustered service. A cluster member includes zero or more instances of this managed bean.

StorageManagerMBean

Represents a storage instance for a storage-enabled distributed cache service. A cluster member includes zero or more instances of this managed bean.

TransactionManagerMBean

Represents a transaction manager. A cluster member includes zero or more instances of this managed bean.



CacheMBean

The CacheMBean MBean represents a cache. A cluster member includes zero or more instances of this managed bean depending on the number of caches that are configured for each data service type (distributed, replicated, and so on). This MBean provides operational and performance statistics for a cache. Some MBean attributes are writable and allow the behavior of a cache to be changed in real time.

The object name of the MBean is:

type=Cache,service=service name,name=cache name,nodeId=cluster node id,tier=tier tag

Note:

The CacheMBean MBean contains many attributes that are not applicable to transactional caches. A transactional cache returns a -1 value if attributes are invoked that do not apply. See Developing Applications with Oracle Coherence for a list of the supported attributes and transaction-specific descriptions.

Attributes

Table A-2 describes the attributes for CacheMBean.

Table A-2 CacheMBean Attributes

Attribute Type Access Description

AverageGetMillis

Double

read-only

The average number of milliseconds per get() invocation since the statistics were last reset

AverageHitMillis

Double

read-only

The average number of milliseconds per get() invocation that is a hit since the statistics were last reset

AverageMissMillis

Double

read-only

The average number of milliseconds per get() invocation that is a miss since the statistics were last reset

AveragePutMillis

Double

read-only

The average number of milliseconds per put() invocation since the statistics were last reset

BatchFactor

Double

read/write

The BatchFactor attribute is used to calculate the soft-ripe time for write-behind queue entries. A queue entry is considered to be ripe for a write operation if it has been in the write-behind queue for no less than the QueueDelay interval. The soft-ripe time is the point in time before the actual ripe time after which an entry is included in a batch asynchronous write operation to the cache store (along with all other ripe and soft-ripe entries). This attribute is only applicable if asynchronous writes are enabled (that is, the value of the QueueDelay attribute is greater than zero) and the cache store implements the storeAll() method. The value of the element is expressed as a percentage of the QueueDelay interval. Valid values are doubles in the interval [0.0, 1.0].

CacheHits

Long

read-only

The rough number of cache visits since the statistics were last reset. A cache hit is a read operation invocation (that is, get()) for which an entry exists in this map.

CacheHitsMillis

Long

read-only

The total number of milliseconds (since the statistics were last reset) for the get() operations for which an entry existed in this map

CacheMisses

Long

read-only

The rough number of cache misses since the statistics were last reset

CacheMissesMillis

Long

read-only

The total number of milliseconds (since the statistics were last reset) for the get() operations for which no entry existed in this map

CachePrunes

Long

read-only

The number of prune operations since the statistics were last reset. A prune operation occurs every time the cache reaches its high-water mark as specified by the HighUnits attribute.

CachePrunesMillis

Long

read-only

The total number of milliseconds for the prune operations since the statistics were last reset

Description

String

read-only

The cache description

ExpiryDelay

Integer

read/write

The time-to-live for cache entries in milliseconds. A value of zero indicates that the automatic expiry is disabled. Changing this attribute does not affect existing entries that are scheduled to expire.

HighUnits

Integer

read/write

The limit of the cache size measured in units. The cache prunes itself automatically after it reaches its maximum unit level. This is often referred to as the high-water mark of the cache.

HitProbability

Double

read-only

The rough probability (0 <= p <= 1) that the next invocation is a hit since the last time statistics were reset

LowUnits

Integer

read/write

The number of units to which the cache shrinks when it prunes. This is often referred to as a low-water mark of the cache

PersistenceType

String

read-only

The persistence type for this cache. Possible values include: NONE, READ-ONLY, WRITE-THROUGH, WRITE-BEHIND.

QueueDelay

Integer

read/write

The number of seconds that an entry added to a write-behind queue sits in the queue before being stored using a cache store. This attribute is only applicable if the persistence type is WRITE-BEHIND.

QueueSize

Integer

read-only

The size of the write-behind queue. This attribute is only applicable if the persistence type is WRITE-BEHIND.

RefreshFactor

Double

read/write

This attribute is used to calculate the soft-expiration time for cache entries. Soft-expiration is the point in time before the actual expiration after which any access request for an entry schedules an asynchronous load request for the entry. This attribute is only applicable for a read/write backing map that has an internal local cache with scheduled automatic expiration. The value of this element is expressed as a percentage of the internal local cache expiration interval. Valid values are doubles in the interval [0.0, 1.0]. If the factor is zero, refresh-ahead scheduling is disabled.

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

RequeueThreshold

Integer

read/write

The size of the write-behind queue at which additional actions could be taken. If the size is zero, write-behind requeuing is disabled. Otherwise, this value controls the frequency of the corresponding log messages. For example, a value of 100 produces a log message every time the size of the write queue is a multiple of 100.

Size

Integer

read-only

The number of entries in the cache

StoreAverageBatchSize

Long

read-only

The average number of entries stored for each cache store write operation since the statistics were last reset. A call to the store() method is counted as a batch of one; whereas a call to the storeAll() method is counted as a batch of the passed Map size. The value is -1 if the persistence type is NONE.

StoreAverageReadMillis

Long

read-only

The average time (in milliseconds) spent per read operation since the statistics were last reset. The value is -1 if the persistence type is NONE.

StoreAverageWriteMillis

Long

read-only

The average time (in milliseconds) spent per write operation since the statistics were last reset. The value is -1 if the persistence type is NONE.

StoreFailures

Long

read-only

The total number of cache store failures (load, store, and erase operations) since the statistics were last reset. The value is -1 if the persistence type is NONE.

StoreReadMillis

Long

read-only

The cumulative time (in milliseconds) spent on load operations since the statistics were last reset. The value is -1 if the persistence type is NONE.

StoreReads

Long

read-only

The total number of load operations since the statistics were last reset. The value is -1 if the persistence type is NONE.

StoreWriteMillis

Long

read-only

The cumulative time (in milliseconds) spent on store and erase operations since the statistics were last reset. The value is -1 if the persistence type is NONE or READ-ONLY.

StoreWrites

Long

read-only

The total number of store and erase operations since the statistics were last reset. The value is -1 if the persistence type is NONE or READ-ONLY.

TotalGets

Long

read-only

The total number of get() operations since the statistics were last reset

TotalGetsMillis

Long

read-only

The total number of milliseconds spent on get() operations since the statistics were last reset

TotalPuts

Long

read-only

The total number of put() operations since the statistics were last reset

TotalPutsMillis

Long

read-only

The total number of milliseconds spent on put() operations since the statistics were last reset

UnitFactor

Integer

read-only

The factor by which the Units, LowUnits, and HighUnits properties are adjusted. Using a BINARY unit calculator, for example, the factor of 1048576 could be used to count megabytes instead of bytes.

Units

Integer

read-only

The size of the cache measured in units. This value must be adjusted by the UnitFactor.


Operations

The CacheMBean MBean includes a resetStatistics operation that resets all cache statistics.


ClusterMBean

The ClusterMBean MBean represents a cluster. Each cluster member includes a single instance of this managed bean. This MBean provides operational statistics about the cluster.

The object name of the MBean is:

type=Cluster

Attributes

Table A-3 describes the attributes for ClusterMBean.

Table A-3 ClusterMBean Attributes

Attribute Type Access Description

ClusterName

String

read-only

The name of the cluster

ClusterSize

Integer

read-only

The total number of cluster members

LicenseMode

String

read-only

The license mode that this cluster is using. Possible values are Evaluation, Development, or Production.

LocalMemberId

Integer

read-only

The member ID for the cluster member that is collocated with the reporting MBean server. The value is -1 if the cluster service is not running.

MemberIds

Integer[]

read-only

An array of all existing cluster member IDs

Members

String[]

read-only

An array of all existing cluster members

MembersDeparted

String[]

read-only

An array of strings containing the member information for recently departed cluster members. Members are removed from this array when the member ID is recycled. This information is since the member has joined the cluster and is reset when the MBean server member leaves and rejoins the cluster. The MembersDepartureCount is the total count of departed members and not the size of this array.

MembersDepartureCount

Long

read-only

The number of times this member has observed another member`s departure from the cluster since this management member has joined the cluster or statistics have been reset.

OldestMemberId

Integer

read-only

The senior cluster member ID. The value is -1 if the cluster service is not running.

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

Running

Boolean

read-only

Specifies whether the cluster is running

Version

String

read-only

The Oracle Coherence version


Operations

Table A-4 describes the operations for ClusterMBean.

Table A-4 ClusterMBean Operations

Operation Parameters Return Type Description

ensureRunning

Not applicable

Void

Ensures that the cluster service is running on this member

logClusterState

String sRole

Void

Logs the state (full thread dump and outstanding polls) on cluster members that are running with the specified role. The role of a cluster member is defined within the <member-identity> element of an operational override file. See Developing Applications with Oracle Coherence for details on setting up member identity information. If the sRole parameter is not specified (no value in the field), then state is logged on all cluster members.

shutdown

Not applicable

Void

Shuts down the cluster service on this member



ClusterNodeMBean

The ClusterNodeMBean MBean represents a cluster member. Each cluster member includes a single instance of this managed bean. This MBean provides operational and performance statistics for a member of a cluster. Many of the attributes are writable and allow the behavior of the member to be changed in real time.

The object name of the MBean is:

type=Node,nodeId=cluster node id

Attributes

Table A-5 describes the attributes for ClusterNodeMBean.

Table A-5 ClusterNodeMBean Attributes

Attribute Type Access Description

BufferPublishSize

Integer

read/write

The buffer size of the unicast datagram socket that is used by the publisher, measured in the number of packets. Changing this value at run time is an inherently unsafe operation that pauses all network communications and may result in the termination of all cluster services.

BufferReceiveSize

Integer

read/write

The buffer size of the unicast datagram socket that is used by the receiver, measured in the number of packets. Changing this value at run time is an inherently unsafe operation that pauses all network communications and may result in the termination of all cluster services.

CpuCount

Integer

read-only

Number of CPU cores for the computer that this member is running on

FlowControlEnabled

Boolean

read-only

Indicates whether FlowControl is enabled. To enable flow control, see the <flow-control> element in Developing Applications with Oracle Coherence.

Id

Integer

read-only

The short member ID that uniquely identifies the member now and does not change for the life of this member

LoggingDestination

String

read-only

The output device used by the logging system. Valid values are stdout, stderr, jdk, log4j, or a file name.

LoggingFormat

String

read/write

Specifies how messages are formatted before being passed to the log destination

LoggingLevel

Integer

read/write

Specifies which logged messages are output to the log destination. Valid values are nonnegative integers. A value of -1 disables all logger output.

LoggingLimit

Integer

read/write

The maximum number of characters that the logger daemon processes from the message queue before discarding all remaining messages in the queue. Valid values are positive integers in the range 0 to Integer.MAX_VALUE (2147483647). A value of zero implies Integer.MAX_VALUE.

MachineId

Integer

read-only

The computer ID of this member

MachineName

String

read-only

A unique name for the computer. The name should be the same for all members that are on the same computer and different for members that are on different computers.

MemberName

String

read-only

A unique name for a member. The name must be unique for every member.

MemoryAvailableMB

Integer

read-only

The total amount of memory (in MB) that is available in the JVM for new objects

MemoryMaxMB

Integer

read-only

The maximum amount of memory (in MB) that the JVM attempts to use

MulticastAddress

String

read-only

The multicast socket IP address that is used by this member for group communication

MulticastEnabled

Boolean

read-only

Specifies whether this member uses multicast for group communication. If false, this member uses the addresses listed in the WellKnownAddresses attribute to join the cluster and point-to-point unicast to communicate with other members of the cluster.

MulticastPort

Integer

read-only

The multicast socket port that is used by this member for group communication

MulticastThreshold

Integer

read/write

The percentage (0 to 100) of the servers in the cluster that a packet is sent to, above which the packet is sent using multicast and below which it is sent using unicast

MulticastTTL

Integer

read-only

The time-to-live for multicast packets that were sent out on this member`s multicast socket

NackEnabled

Boolean

read-only

Indicates whether the early packet loss detection protocol is enabled

NackSent

Long

read-only

The total number of NACK packets that were sent since the member statistics were last reset

PacketDeliveryEfficiency

Float

read-only

The efficiency of packet loss detection and retransmission. A low efficiency indicates a high rate of unnecessary packet retransmissions.

PacketsBundled

Long

read-only

The total number of packets that were bundled before transmission. The total number of network transmissions equals PacketsSent - PacketsBundled.

PacketsReceived

Long

read-only

The number of packets that were received since the member statistics were last reset

PacketsRepeated

Long

read-only

The number of duplicate packets that were received since the member statistics were last reset

PacketsResent

Long

read-only

The number of packets that were re-sent since the member statistics were last reset. A packet is re-sent when there is no ACK received within a timeout period.

PacketsResentEarly

Long

read-only

The total number of packets that were re-sent too soon. A packet is re-sent too soon when there is a NACK indicating that the packet has not been received.

PacketsResentExcess

Long

read-only

The total number of packet retransmissions that were later proven unnecessary

PacketsSent

Long

read-only

The number of packets that were sent since the member statistics were last reset

Priority

Integer

read-only

The priority, or weight, of the member. This value is used to determine tie-breakers

ProcessName

String

read-only

A name that should be the same for members that are in the same process (JVM) and different for members that are in different processes. If not explicitly provided, the name is calculated internally as the Name attribute of the system RuntimeMXBean, which normally represents the process identifier (PID).

ProductEdition

String

read-only

The product edition this member is running. Possible values are Standard Edition, Enterprise Edition, and Grid Edition.

PublisherPacketUtilization

Float

read-only

The publisher packet utilization for this cluster member since the member socket was last reopened. This value is a ratio of the number of bytes sent to the number that would have been sent had all packets been full. A low utilization indicates that data is not being sent in large enough chunks to make efficient use of the network.

PublisherSuccessRate

Float

read-only

The publisher success rate for this cluster member since the member statistics were last reset. The publisher success rate is a ratio of the number of packets successfully delivered in a first attempt to the total number of sent packets. A failure count is incremented when there is no ACK received within a timeout period. It could be caused by either very high network latency or a high packet drop rate.

QuorumStatus

String

read-only

The current state of the cluster quorum

RackName

String

read-only

A name for the rack on which the member is located. This name should be the same for members that are on the same physical rack (or frame or cage) and different for members that are on different physical racks

ReceiverPacketUtilization

Float

read-only

The receiver packet utilization for this cluster member since the socket was last reopened. This value is a ratio of the number of bytes that were received to the number that would have been received had all packets been full. A low utilization indicates that data is not being sent in large enough chunks to make efficient use of the network.

ReceiverSuccessRate

Float

read-only

The receiver success rate for this cluster member since the member statistics were last reset. The receiver success rate is a ratio of the number of packets that were successfully acknowledged in a first attempt to the total number of received packets. A failure count increments when a redelivery of a previously received packet is detected. Very high inbound network latency or lost ACK packets can cause a low success rate.

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

ResendDelay

Integer

read/write

The minimum number of milliseconds that a packet remains queued in the publisher`s resend queue before it is re-sent to any recipients if the packet has not been acknowledged. Setting this value too low can overflow the network with unnecessary repetitions. Setting the value too high can increase the overall latency by delaying the re-sending of dropped packets. Change of this value may require a change in the SendAckDelay value.

RoleName

String

read-only

A name that indicates the role of a cluster member to the application. Use a name that is meaningful to the application.

SendAckDelay

Integer

read/write

The minimum number of milliseconds between the queuing and sending of an ACK packet. This value should not be more then half of the ResendDelay value.

SendQueueSize

Integer

read-only

The number of packets that are currently scheduled for delivery. This number includes both packets that are to be sent immediately and packets that have been sent and are awaiting for an acknowledgment. Packets that do not receive an acknowledgment within the ResendDelay interval are automatically re-sent.

SiteName

String

read-only

A name for the site where the member is located. The name should be the same for members that are on the same physical site (for example, data center), and different for members that are on different physical sites

SocketCount

Integer

read-only

The number of CPU sockets for the computer that this member is running on

Statistics

String

read-only

The statistics for this cluster member in a human readable format

TcpRingFailures

Long

read-only

The number of TcpRing disconnects that were recovered since the member statistics were last reset. A recoverable disconnect is an abnormal event that is registered when the TcpRing peer drops the TCP connection, but recovers after no more than the maximum configured number of attempts. A value of -1 indicates that TcpRing is disabled.

Timestamp

Date

read-only

The date/time value (in cluster time) that this member joined the cluster

TrafficJamCount

Integer

read/write

The maximum total number of packets in the send and resend queues that forces the publisher to pause client threads. A value of zero means no limit.

TrafficJamDelay

Integer

read/write

The number of milliseconds to pause client threads when a traffic jam condition has been reached. Anything less than one (for example, zero) is treated as one millisecond.

UnicastAddress

String

read-only

The datagram socket IP address that is used by this member for point-to-point communication

UnicastPort

Integer

read-only

The datagram socket port that is used by this member for point-to-point communication

WeakestChannel

Integer

read-only

The ID of the cluster member to which this member is having the most difficulty communicating, or -1 if none is found. A channel is considered to be weak if either the point-to-point publisher or receiver success rates are below 1.0.

WellKnownAddresses

String[]

read-only

An array of well-known socket addresses that this member uses to join the cluster


Operations

Table A-6 describes the operations for ClusterNodeMBean.

Table A-6 ClusterNodeMBean Operations

Operation Parameters Return Type Description

ensureService

String sCacheName

void

Ensure that a cache service for the specified cache runs at the cluster member represented by this MBean. This method uses the configurable cache factory to find out which cache service to start if necessary.

resetStatistics

Not applicable

void

Reset the cluster member statistics

logNodeSate

Not applicable

Void

Logs a full thread dump and outstanding polls for the services on this cluster member

shutdown

Not applicable

void

Stop all the clustered services running at this member (controlled shutdown). The management of this member is not available until the member restarts (manually or programmatically).



ConnectionManagerMBean

The ConnectionManagerMBean MBean represents an Oracle Coherence*Extend proxy. A cluster member includes zero or more instances of this managed bean depending on the number of configured proxies. The MBean contains statistics for throughput and connection information for proxy hosts.

The object name of the MBean is:

type=ConnectionManager,name=service name,nodeId=cluster node id

Attributes

Table A-7 describes the attributes for ConnectionManagerMBean.

Table A-7 ConnectionManagerMBean Attributes

Attribute Type Access Description

ConnectionCount

Integer

read-only

The number of client connections

HostIP

String

read-only

The IP address and port of the proxy host

IncomingBufferPoolCapacity

Long

read-only

The pool capacity (in bytes) of the incoming buffer

IncomingBufferPoolSize

Integer

read-only

The number of buffers in the incoming pool

OutgoingBufferPoolCapacity

Long

read-only

The pool capacity (in bytes) of the outgoing buffer

OutgoingBufferPoolSize

Integer

read-only

The number of buffers in the outgoing pool

OutgoingByteBacklog

Long

read-only

The backlog (in bytes) of the outgoing queue

OutgoingMessageBacklog

Long

read-only

The backlog of the outgoing message queue

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

TotalBytesReceived

Long

read-only

The total number of bytes that were received by the proxy host since the statistics were last reset

TotalBytesSent

Long

read-only

The total number of bytes that were sent by the proxy host since the statistics were last reset

TotalMessagesReceived

Long

read-only

The total number of messages that were received by the proxy host since the statistics were last reset

TotalMessagesSent

Long

read-only

The total number of messages that were sent by the proxy host since the statistics were last reset

UnauthorizedConnectionAttempts

Long

read-only

The number of connection attempts from unauthorized hosts. This feature was added as part of a patch release. For information about which updates are included in a patch, see Release Notes for Oracle Coherence.


Operations

The ConnectionManagerMBean MBean has no operations.


ConnectionMBean

The ConnectionMBean MBean represents a remote client connection through Oracle Coherence*Extend. A cluster member includes zero or more instances of this managed bean depending on the number of active remote connections to the cluster. The MBean contains performance and usage statistics for the connection.

The object name of the MBean is:

type=Connection,name=service name ,nodeId=cluster node id,UUID=connection id

Attributes

Table A-8 describes the attributes for ConnectionMBean.

Table A-8 ConnectionMBean Attributes

Attribute Type Access Description

ConnectionTimeMillis

Long

read-only

The time duration (in milliseconds) that the client has been connected

Member

String

read-only

The member identity information for the client. The value can be customized using the <member-identity> element in the client operational override file. See Developing Applications with Oracle Coherence for details on setting up member identity information.

OutgoingByteBacklog

Long

read-only

The backlog (in bytes) of the outgoing queue

OutgoingMessageBacklog

Integer

read-only

The backlog of the outgoing message queue

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

RemoteAddress

String

read-only

The IP address of the corresponding client

RemotePort

Integer

read-only

The port of the corresponding client

Timestamp

Date

read-only

The date/time value (in local time) that the corresponding client connected to the proxy

TotalBytesReceived

Long

read-only

The total number of bytes that were received since the last time the statistics were reset

TotalBytesSent

Long

read-only

The total number of bytes that were sent since the last time the statistics were reset

TotalMessagesReceived

Long

read-only

The total number of messages that were received since the last time the statistics were reset

TotalMessagesSent

Long

read-only

The total number of messages that were sent since the last time the statistics were reset

UUID

String

read-only

The unique identifier for this connection


Operations

Table A-9 describes the operations for ConnectionMBean.

Table A-9 ConnectionMBean Operations

Operation Parameters Return Type Description

closeConnection

Not applicable

void

Close the corresponding connection.

resetStatistics

Not applicable

void

Reset the connection statistics.



FlashJournalRM

The JournalMBean MBean provides an interface for the flash journal resource manager (FlashJournalRM). The resource manager stores data to flash memory. Each cluster member includes a single instance of this managed bean, which provides operational statistics.

The object name of the MBean is:

type=Journal,name=FlashJournalRM,nodeId=cluster node id

Attributes

Table A-10 describes the attributes for JournalMBean that pertain to the flash journal resource manager.

Table A-10 JournalMBean Attributes for FlashJournalRM

Attribute Type Access Description

BacklogCount

Integer

read-only

The number of serialized values that have yet to be stored in the journal

BacklogSize

Integer

read-only

The amount of data that has been enqueued for the journal to write to disk, but which has not yet been written to disk. The maximum amount of memory used by the backlog is at least twice the configured amount, because the data enqueued is held in binary form and rendered to the write-behind buffers.

BinaryStoreCount

Integer

read-only

The number of active JournalBinaryStore objects that are using this journal

BufferSize

Integer

read-only

The size of the buffers that are used to write data to a journal file

CollectorLoadFactor

Double

read-only

The threshold after which files are eligible for garbage collection. The larger the value, the more aggressively files are collected.

CurrentCollectorLoadFactor

Double

read-only

The current load factor threshold at which files are being garbage collected

FileCount

Integer

read-only

The number of journal files that are currently in use

HighFileCount

Integer

read-only

The high file count after which compulsory compaction (garbage collection) occurs for the Journal

HighestLoadFactor

Double

read-only

The approximate high-water mark of the Journal capacity utilization

MaxBacklogSize

Integer

read-only

The maximum size, in bytes, of the backlog. Writes are delayed when the backlog exceeds this level and remain delayed until the backlog recedes below this level.

MaxFileSize

Long

read-only

The maximum allowable size of an individual journal file

MaxJournalFilesNumber

Integer

read-only

The maximum number of journal files that can be used

MaxPoolSize

Integer

read-only

The maximum size, in bytes, of the buffer pool

MaxTotalRam

Long

read-only

This attribute does not pertain to a flash journal and returns -1.

MaxValueSize

Integer

read-only

The maximum allowable size, in bytes, for serialized values

NioRam

Boolean

read-only

Whether the RAM journal uses on-heap byte buffers or off-heap NIO buffers (NIO RAM). Valid values are true and false. A true value indicates off-heap NIO buffers. A false value indicates on-heap byte buffers. The default value is false.

PoolSize

Integer

read-only

The total size, in bytes, of all available buffers in the pool

TotalCompactionCount

Integer

read-only

The total number of times compaction (garbage collection) has been done for the journal

TotalDataSize

Long

read-only

The amount of data, in bytes, that is currently stored for this journal

TotalFileSize

Long

read-only

The total size of all journal files for this journal


Operations

The JournalMBean MBean has no operations.


ManagementMBean

The ManagementMBean MBean represents the grid JMX infrastructure. Each cluster member includes a single instance of this managed bean. The MBean contains management settings. Some of the attributes are writable and allow management behavior to be changed in real time.

The object name of the MBean is:

type=Management

Attributes

Table A-11 describes the attributes for ManagementMBean.

Table A-11 ManagementMBean Attributes

Attribute Type Access Description

ExpiryDelay

Long

read/write

The number of milliseconds that the MBean server keeps a remote model snapshot before refreshing

RefreshCount

Long

read-only

The total number of snapshots retrieved since the statistics were last reset

RefreshExcessCount

Long

read-only

The number of times that the MBean server predictively refreshed information and the information was not accessed

RefreshOnQuery

Boolean

read-only

Specifies whether the refresh-on-query MBean server is configured. If this is true, then the RefreshPolicy value should be refresh-onquery.

RefreshPolicy

String

read/write

The policy that determines the behavior when refreshing remote models. Valid values are refresh-ahead, refresh-behind, refresh-expired, and refresh-onquery. Invalid values are converted to refresh-expired.

RefreshPredictionCount

Long

read-only

The number of times that the MBean server used a predictive (refresh-behind, refresh-ahead, refresh-onquery) algorithm to refresh MBean information

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

RefreshTimeoutCount

Long

read-only

The number of times that this management member has timed out while attempting to refresh remote MBean attributes

RemoteNotificationCount

Long

read-only

The total number of remote notifications that were received for all MBeans by this member since the last time the statistics were reset


Operations

The ManagementMBean MBean includes a resetStatistics operation that resets the RefreshCount, RefreshExcessCount, and RefreshPredictionCount statistics.


PointToPointMBean

The PointToPointMBean MBean represents the network status between two cluster members. Each cluster member includes a single instance of this managed bean. The MBean provides network statistics from the perspective of the current viewing member to a specified viewed member. To specify the member, enter its ID using the ViewedMemberId attribute.

The object name of the MBean is:

type=PointToPoint,nodeId=cluster node id

Attributes

Table A-12 describes the attributes for PointToPointMBean.

Table A-12 PointToPointMBean Attributes

Attribute Type Access Description

DeferredPackets

Integer

read-only

The number of packets that were addressed to the viewed member that the viewing member is currently deferring to send. The viewing member delays sending these packets until the number of outstanding packets falls below the value of the Threshold attribute. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

Deferring

Boolean

read-only

Indicates whether the viewing member is currently deferring packets to the viewed member. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

LastIn

Long

read-only

The number of milliseconds that have elapsed since the viewing member last received an acknowledgment from the viewed member

LastOut

Long

read-only

The number of milliseconds that have elapsed since the viewing member last sent a packet to the viewed member

LastSlow

Long

read-only

The number of milliseconds that have elapsed since the viewing member declared the viewed member as slow, or -1 if the viewed member has never been declared slow

OutstandingPackets

Integer

read-only

The number of packets that the viewing member has sent to the viewed member that have yet to be acknowledged. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

PauseRate

Float

read-only

The percentage of time since the last time statistics were reset in which the viewing member considered the viewed member to be unresponsive. Under normal conditions this value should be very close to 0.0. Values near 1.0 would indicate that the viewed member is nearly inoperable, likely due to extremely long garbage collection. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

Paused

Boolean

read-only

Indicates whether the viewing member currently considers the viewed member to be unresponsive. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

PublisherSuccessRate

Float

read-only

The publisher success rate from the viewing member to the viewed member since the statistics were last reset

ReceiverSuccessRate

Float

read-only

The receiver success rate from the viewing member to the viewed member since the statistics were last reset

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time

Threshold

Integer

read-only

The maximum number of outstanding packets for the viewed member that the viewing member is allowed to accumulate before initiating the deferral algorithm. The value of this attribute is only meaningful if the viewing member has FlowControl enabled. See the <flow-control> element in Developing Applications with Oracle Coherence.

ViewedMemberId

Integer

read/write

The ID of the member being viewed

ViewerStatistics

String[]

read-only

A human readable summary of the point-to-point statistics from the viewing member for all other members


Operations

Table A-13 describes the operations for PointToPointMBean.

Table A-13 PointToPointMBean Operations

Operation Parameters Return Type Description

resetStatistics

Not applicable

void

Reset the viewing member`s point-to-point statistics for all other members.

trackWeakest

Not applicable

void

Instruct the Point-to-Point MBean to track the weakest member. A viewed member is considered to be weak if either the corresponding publisher or receiver success rate is below 1.0.



RamJournalRM

The JournalMBean MBean provides an interface for the RAM journal resource manager (RamJournalRM). The resource manager is responsible for storing data to RAM memory. Each cluster member includes a single instance of this managed bean, which provides operational statistics.

The object name of the MBean is:

type=Journal,name=RamJournalRM,nodeId=cluster node id

Attributes

Table A-14 describes the attributes for JournalMBean that pertain to the RAM journal resource manager.

Table A-14 JournalMBean Attributes for RamJournalRM

Attribute Type Access Description

BacklogCount

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

BacklogSize

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

BinaryStoreCount

Integer

read-only

The number of active JournalBinaryStore objects that are using this journal

BufferSize

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

CollectorLoadFactor

Double

read-only

The threshold after which files are eligible for garbage collection. The larger the value, the more aggressively files are collected.

CurrentCollectorLoadFactor

Double

read-only

The current load factor threshold at which files are being garbage collected

FileCount

Integer

read-only

The number of journal files that are currently in use

HighFileCount

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

HighestLoadFactor

Double

read-only

This attribute does not pertain to a RAM journal and returns 0.0.

MaxBacklogSize

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

MaxFileSize

Long

read-only

The maximum allowable size of an individual journal file

MaxJournalFilesNumber

Integer

read-only

The maximum number of journal files that can be used

MaxPoolSize

Integer

read-only

The maximum size, in bytes, of the buffer pool

MaxTotalRam

Long

read-only

The total amount of RAM used for this journal

MaxValueSize

Integer

read-only

The maximum allowable size, in bytes, for serialized values

NioRam

Boolean

read-only

Whether the RAM journal uses on-heap byte buffers or off-heap NIO buffers (NIO RAM). Valid values are true and false. A true value indicates off-heap NIO buffers. A false value indicates on-heap byte buffers. The default value is false.

PoolSize

Integer

read-only

This attribute does not pertain to a RAM journal and returns -1.

TotalCompactionCount

Integer

read-only

The total number of times compaction (garbage collection) has been done for the journal

TotalDataSize

Long

read-only

The amount of data, in bytes, that is currently stored for this journal

TotalFileSize

Long

read-only

The total size of all journal files for this journal


Operations

The JournalMBean MBean has no operations.


ReporterMBean

The ReporterMBean MBean represents the Oracle Coherence Reporter. Each cluster member includes a single instance of this managed bean. The MBean contains settings and statistics for Oracle Coherence reporting. Many of the attributes are writable and change reporting behavior in real time. In addition, the MBean contains operations that start and stop reporting and run reports in real time.

The object name of the MBean is:

type=Reporter

Attributes

Table A-15 describes the attributes for ReporterMBean.

Table A-15 ReporterMBean Attributes

Attribute Type Access Description

AutoStart

Boolean

read-only

Specifies whether reporting starts automatically with the member

ConfigFile

String

read/write

The report group configuration file to be used for reporting

CurrentBatch

Long

read/write

The batch identifier for the reporter

IntervalSeconds

Long

read/write

The interval between executions in seconds

LastExectionTime

Date

read-only

The last time a report batch ran. For local servers, it is the local time.

LastReport

String

read-only

The last report to execute

OutputPath

String

read/write

The path where report output is located

RefreshTime

Date

read-only

The last time that the reporter statistics were reset. For local servers, it is the local time.

Reports

String[]

read-only

The list of reports that were created

RunAverageMillis

Double

read-only

The average batch run in milliseconds since the statistics were last reset

RunLastMillis

Long

read-only

The last batch run in milliseconds since the statistics were last reset

RunMaxMillis

Long

read-only

The maximum batch run in milliseconds since the statistics were last reset

State

String

read-only

The reporting state. Valid values are Running (reports are being created), Waiting (the reporter is waiting for the interval to complete), Starting (the reporter is being started), Stopping (the reporter is attempting to stop and waiting for running reports to complete), Stopped (the reporter is stopped) and, Sleeping (the reporter is sleeping).


Operations

Table A-16 describes the operations for ReporterMBean.

Table A-16 ReporterMBean Operations

Operation Parameters Return Type Description

resetStatistics

Not applicable

void

Reset the reporter statistics.

runReport

String sReportFile

void

Run a report group or single report one time using the specified report group or report file, respectively (for example (reports/report-group.xml or reports/report-cache-size.xml).

start

Not applicable

void

Start reporting

stop

Not applicable

void

Stop reporting



ServiceMBean

The ServiceMBean MBean represents a clustered service. A cluster member includes zero or more instances of this managed bean depending on the number of clustered services that are started. The MBean contains usage and performance statistics for a service. Some of the attributes are writable and change the behavior of a service in real time. In addition, the MBean contains operations to start and stop a service in real time.

The object name of the MBean is:

type=Service,name=service name,nodeId=cluster node id

Terminology

The terms task and request have unique definitions within Oracle Coherence. Understand the terms before setting the task-related and request-related attributes for ServiceMBean.

  • Task – A task is an invoked object that executes on one or more members. The objects include filters, invocation agents (entry processors and aggregators), or single-pass agents (Invocable objects).

  • Request – A request is the round-trip required to complete a task. A request begins the moment a task is sent for execution by a client and includes the following:

    • The time it takes to deliver the request to an executing member (server)

    • The interval between the time the task is received and placed into a service queue until the execution starts

    • The task execution time

    • The time it takes to deliver a result back to the client

Attributes

Table A-17 describes the attributes for ServiceMBean.

Table A-17 ServiceMBean Attributes

Attribute Type Access Description

BackupCount

Integer

read-only

The number of backups for every cache storage

BackupCountAfterWritebehind

Integer

read-only

The number of members of the partitioned (distributed) cache service that retain backup data, which does not require write-behind. The data is not vulnerable to being lost even if the entire cluster is shut down.

EventInterceptorInfo

String[]

read-only

An array of statistics for live events processed by event interceptors. The statistics include:

  • Interceptors – a list of registered interceptors

  • ExceptionCount – the number of exceptions thrown from the interceptors since the last time the statistics were reset

  • LastException – a stack trace of the last exception thrown from the interceptors

JoinTime

Date

read-only

The date and time (in cluster time) that this member joined the service

OwnedPartitionsBackup

Integer

read-only

The number of partitions that this member backs up (responsible for the backup storage)

OwnedPartitionsPrimary

Integer

read-only

The number of partitions that this member owns (responsible for the primary storage)

PartitionsAll

Integer

read-only

The total number of partitions that every cache storage is divided into

PartitionsEndangered

Integer

read-only

The total number of partitions that are not currently backed up

PartitionsUnbalanced

Integer

read-only

The total number of primary and backup partitions that remain to be transferred until the partition distribution across the storage enabled service members is fully balanced

PartitionsVulnerable

Integer

read-only

The total number of partitions that are backed up on the same computer where the primary partition owner resides

QuorumStatus

String

read-only

The current state of the service quorum

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

RequestAverageDuration

Float

read-only

The average duration (in milliseconds) of an individual request that was issued by the service since the last time the statistics were reset

RequestMaxDuration

Long

read-only

The maximum duration (in milliseconds) of a request that was issued by the service since the last time the statistics were reset

RequestPendingCount

Long

read-only

The number of pending requests that were issued by the service

RequestPendingDuration

Long

read-only

The duration (in milliseconds) of the oldest pending request that was issued by the service

RequestTimeoutCount

Long

read-only

The total number of timed-out requests since the last time the statistics were reset

RequestTimeoutMillis

Long

read/write

The default timeout value in milliseconds for requests that can be timed-out (for example, implement the com.tangosol.net.PriorityTask interface) but do not explicitly specify the request timeout value

RequestTotalCount

Long

read-only

The total number of synchronous requests that were issued by the service since the last time the statistics were reset

Running

Boolean

read-only

Specifies whether the service is running

SeniorMemberId

Integer

read-only

The service senior member ID. The value is -1 if the service is not running.

Statistics

String

read-only

The statistics for this service in a human readable format

StatusHA

String

read-only

The High Availability (HA) status for this service. A value of MACHINE-SAFE indicates that all the cluster members running on any given computer could be stopped without data loss. A value of NODE-SAFE indicates that a cluster member could be stopped without data loss. A value of ENDANGERED indicates that abnormal termination of any cluster member that runs this service may cause data loss. A value of N/A indicates that the service has no high availability impact.

StorageEnabled

Boolean

read-only

Specifies whether the local storage is enabled for this cluster member

StorageEnabledCount

Integer

read-only

Specifies the total number of cluster members running this service for which local storage is enabled

TaskAverageDuration

Float

read-only

The average duration (in milliseconds) of an individual task execution

TaskBacklog

Integer

read-only

The size of the backlog queue that holds tasks scheduled to be executed by a service thread

TaskCount

Long

read-only

The total number of executed tasks since the last time the statistics were reset

TaskHungCount

Integer

read-only

The total number of currently executing hung tasks

TaskHungDuration

Long

read-only

The longest currently executing hung task duration in milliseconds

TaskHungTaskId

String

read-only

The ID of the longest currently executing hung task

TaskHungThresholdMillis

Long

read/write

The amount of time in milliseconds that a task can execute before it is considered hung. A posted task that has not yet started is never considered as hung.

This attribute is applied only if a thread pool is started (that is, the ThreadCount value is > 0).

TaskMaxBacklog

Integer

read-only

The maximum size of the backlog queue since the last time the statistics were reset

TaskTimeoutCount

Integer

read-only

The total number of timed-out tasks since the last time the statistics were reset

TaskTimeoutMillis

Long

read/write

The default timeout value in milliseconds for tasks that can be timed-out (for example, implement the com.tangosol.net.PriorityTask interface) but do not explicitly specify the task execution timeout value.

This attribute is applied only if a thread pool is started (that is, the ThreadCount value is > 0).

ThreadAbandonedCount

Integer

read-only

The number of abandoned threads from the service thread pool. A thread is abandoned and replaced with a new thread if it executes a task for a period longer than the execution timeout and all attempts to interrupt it fail.

ThreadAverageActiveCount

Float

read-only

The average number of active (not idle) threads in the service thread pool since the last time the statistics were reset

ThreadCount

Integer

read/write

The number of threads in the service thread pool. This attribute can only be changed in real time if a service is configured to use a thread pool (that is, a thread count > 0). To initially set this value, configure the thread-count for a service either in an operational override file or a cache configuration file. If the value is 0 (the default), then only the service thread is used and a thread pool is never started.

Note: For a proxy service, setting a thread count value disables dynamic thread pool sizing. A dynamic thread pool automatically adjusts the number of threads based on proxy service load.

ThreadCountMax

Integer

read/write

The maximum number of threads that are allowed for a proxy service when dynamic thread pool sizing is enabled. A value of -1 indicates that dynamic thread pool sizing is disabled.

ThreadCountMin

Integer

read/write

The minimum number of threads that are allowed for a proxy service when dynamic thread pool sizing is enabled. A value of -1 indicates that dynamic thread pool sizing is disabled.

ThreadIdleCount

Integer

read-only

The number of currently idle threads in the service thread pool

ThreadPoolSizingEnabled

Boolean

read-only

Specifies whether dynamic thread pool sizing is enabled for this service. Only proxy services support dynamic thread pools. To enable dynamic thread pools, no value must be specified for the thread-count attribute.

TransportAddress

String

read-only

The service-dedicated transport address. If an address is shown (indicating that a reliable transport has been enabled on the service), then the service instance communicates with other service members using the dedicated transport address rather then using the shared cluster transport.

TransportBackloggedConnectionList

String[]

read-only

A list of backlogged connections on the service-dedicated transport

TransportBackloggedConnections

Integer

read-only

The number of backlogged connections on the service-dedicated transport. Any new requests that require the connection are blocked until the backlog is cleared.

TransportConnections

Integer

read-only

The number of maintained connections on the service-dedicated transport. This count may be lower than the member count if some members have not been configured to use the dedicated transport, or it has been identified that there is no advantage in using the dedicated transport for communication with certain members.

TransportReceivedBytes

Long

read-only

The number of bytes that were received by the service-dedicated transport since the last time the statistics were reset

TransportReceivedMessages

Long

read-only

The number of messages that were received by the service-dedicated transport since the last time the statistics were reset

TransportRetainedBytes

Long

read-only

The number of bytes that were retained by the service-dedicated transport and that are awaiting delivery acknowledgment. This memory is allocated outside of the Java garbage collection heap space.

TransportSentBytes

Long

read-only

The number of bytes that were sent by the service-dedicated transport since the last time the statistics were reset

TransportSentMessages

Long

read-only

The number of messages that were sent by the service-dedicated transport since the last time the statistics were reset

Type

String

read-only

The type identifier of the service


Operations

Table A-18 describes the operations for ServiceMBean.

Table A-18 ServiceMBean Operations

Operation Parameters Return Type Description

reportOwnership

fVerbose

String

Reports the partitions that are owned by the service on this node. The fVerbose parameter formats the ownership summary. Valid values are true or false. Setting the parameter to true includes the detailed ownership catalog.

resetStatistics

Not applicable

void

Reset the service statistics

shutdown

Not applicable

void

Stop the service. This is a controlled shutdown, and is preferred to the stop operation.

start

Not applicable

void

Start the service

stop

Not applicable

void

Force the service to stop. Use the shutdown operation for normal service termination.



StorageManagerMBean

The StorageManagerMBean MBean represents a storage instance for a storage-enabled distributed cache service. A storage instance manages all index, listener, and lock information for the portion of the distributed cache managed by the local member. A cluster member includes zero or more instances of this managed bean depending on the number of configured distributed caches. The MBean contains usage statistics for the storage-enabled cache and also includes statistics for queries.

The object name of the MBean is:

type=StorageManager,service=service name,cache=cache name,nodeId=cluster node id

Attributes

Table A-19 describes the attributes for StorageManagerMBean.

Table A-19 StorageManagerMBean Attributes

Attribute Type Access Description

EventInterceptorInfo

String[]

read-only

An array of statistics for live events processed by event interceptors. The statistics include:

  • Interceptors – a list of registered interceptors

  • ExceptionCount – the number of exceptions thrown from the interceptors since the last time the statistics were reset

  • LastException – a stack trace of the last exception thrown from the interceptors

EventsDispatched

Long

read-only

The total number of events that were dispatched by the storage manager since the last time the statistics were reset

EvictionCount

Long

read-only

The number of evictions, from the backing map that is managed by this storage manager, that were caused by entry expiry or insert operations that would make the underlying backing map reach its configured size limit. The eviction count is used to audit the cache size in a static system:

Cache Size = Insert Count - Remove Count - Eviction Count

Therefore, the eviction count is not reset by the reset statistics method.

IndexInfo

String[]

read-only

An array of information for each index that is applied to the portion of the partitioned cache managed by the storage manager. Each element is a string value that includes a ValueExtractor description, ordered flag (true to indicate that the contents of the index are ordered; false otherwise), and cardinality (number of unique values indexed).

InsertCount

Long

read-only

The number of inserts into the backing map. In addition to standard inserts that are caused by put and invoke operations or synthetic inserts that are caused by get operations with read-through backing map topology, this counter increments when distribution transfers move resources into the underlying backing map and decrements when distribution transfers move data out.

The insert count is used to audit the cache size in a static system:

Cache Size = Insert Count - Remove Count - Eviction Count

Therefore, the insert count is not reset by the reset statistics method.

ListenerFilterCount

Integer

read-only

The number of filter-based listeners that is currently registered with the storage manager

ListenerKeyCount

Integer

read-only

The number of key-based listeners that is currently registered with the storage manager

ListenerRegistrations

Long

read-only

The total number of listener registration requests that were processed by the storage manager since the last time the statistics were reset

LocksGranted

Integer

read-only

The number of locks that is currently granted for the portion of the partitioned cache managed by the storage manager.

LocksPending

Integer

read-only

The number of pending lock requests for the portion of the partitioned cache managed by the storage manager

MaxQueryDescription

String

read-only

A description of the query with the longest duration that exceeds the MaxQueryThresholdMillis attribute since the statistics were last reset

MaxQueryDurationMillis

Long

read-only

The number of milliseconds of the longest running query since the statistics were last reset

MaxQueryThresholdMillis

Long

read/write

A threshold, in milliseconds, for recording queries. The longest query that executes longer than this threshold is reported by the MaxQueryDescription attribute. The default value is 30 ms.

NonOptimizedQueryAverageMillis

Long

read-only

The average duration, in milliseconds, for non-optimized query execution since the cache statistics were last reset

NonOptimizedQueryCount

Long

read-only

The total number of parallel queries that could not be resolved (or that were partially resolved) using indexes since the statistics were last reset

NonOptimizedQueryTotalMillis

Long

read-only

The total execution time, in milliseconds, for queries that could not be resolved (or that were partially resolved) using indexes since the statistics were last reset

OptimizedQueryAverageMillis

Long

read-only

The average duration, in milliseconds, per optimized query execution since the statistics were last reset

OptimizedQueryCount

Long

read-only

The total number of queries that were fully resolved using indexes since the statistics were last reset

OptimizedQueryTotalMillis

Long

read-only

The total execution time, in milliseconds, for queries that were fully resolved using indexes since the statistics were last reset

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

RemoveCount

Long

read-only

The number of removes from the backing map managed by this storage manager caused by operations such as clear, remove, or invoke.

The remove count is used to audit the cache size in a static system:

Cache Size = Insert Count - Remove Count - Eviction Count

Therefore, the remove count is not reset by the reset statistics method.

TriggerInfo

String[]

read-only

An array of information for each trigger that is applied to the portion of the partitioned cache managed by the storage manager. Each element is a string value that represents a human-readable description of the corresponding MapTrigger implementation.


Operations

The StorageManagerMBean MBean includes a resetStatistics operation that resets storage manager statistics. This operation does not reset the EvictionCount, InsertCount, or RemoveCount attributes.


TransactionManagerMBean

The TransactionManagerMBean MBean represents a transaction manager and is specific to the transactional framework. A cluster member includes zero or more instances of this managed bean depending on the number of configured transactional caches. The MBean provides global transaction manager statics by aggregating service-level statistics from all transaction service instances. Each cluster member has one instance of the transaction manager MBean for each service.

The object name of the MBean is:

type=TransactionManager,service=service name,nodeId=cluster node id

Note:

For certain transaction manager attributes, the coordinator member for the transaction maintains the count even though multiple members participate in the transaction. For example, a transaction may include modifications to entries stored on multiple members, but the TotalCommitted attribute only increments on the MBean on the member that coordinated the commit of that transaction.

Attributes

Table A-20 describes the attributes for TransactionManagerMBean.

Table A-20 TransactionManagerMBean Attributes

Attribute Type Access Description

CommitTotalMillis

Long

read-only

The cumulative time (in milliseconds) that was spent during the commit phase since the last time statistics were reset

RefreshTime

Date

read-only

The timestamp when this model was last retrieved from a corresponding member. For local servers, it is the local time.

TimeoutMillis

Long

read-only

The transaction timeout value in milliseconds. This value only applies to transactional connections obtained after the value is set. This attribute is currently not supported.

TotalActive

Long

read-only

The total number of currently active transactions. An active transaction is counted as any transaction that contains at least one modified entry and has yet to be committed or rolled back. The coordinator member for this transaction maintains the count even though multiple members may have participated in the transaction.

TotalCommitted

Long

read-only

The total number of transactions that have been committed by the transaction manager since the last time the statistics were reset. The coordinator member for this transaction maintains the count even though multiple members may have participated in the transaction.

TotalRecovered

Long

read-only

The total number of transactions that have been recovered by the transaction manager since the last time the statistics were reset. The coordinator member for this transaction maintains the count even though multiple members may have participated in the transaction.

TotalRolledback

Long

read-only

The total number of transactions that have been rolled back by the transaction manager since the last time the statistics were reset. The coordinator member for this transaction maintains the count even though multiple members may have participated in the transaction.

TotalTransactionMillis

Long

read-only

The cumulative time (in milliseconds) that was spent on active transactions


Operations

The TransactionManagerMBean MBean includes a resetStatistics operation that resets all transaction manager statistics.