Berkeley DB Java Edition
version 4.0.92

com.sleepycat.je
Class EnvironmentStats

java.lang.Object
  extended by com.sleepycat.je.EnvironmentStats
All Implemented Interfaces:
Serializable

public class EnvironmentStats
extends Object
implements Serializable

Statistics for a single environment.

The statistics are logically grouped into several categories. Viewing the statistics through toString() displays the values in these categories, as does viewing the stats through the JEMonitor mbean. Viewing the stats with toStringVerbose() will provide more detailed descriptions of the stats and stat categories.

The current categories are:

See Also:
Viewing Statistics with JConsole, Serialized Form

Method Summary
 long getAdminBytes()
          The number of bytes of JE cache used for log cleaning metadata and other administrative structures.
 long getBufferBytes()
          The total memory currently consumed by log buffers, in bytes.
 long getCacheDataBytes()
          Deprecated. Please use getDataBytes() to get the amount of cache used for data and use getAdminBytes(), getLockBytes() and getBufferBytes() to get other components of the total cache usage (getCacheTotalBytes()).
 long getCacheTotalBytes()
          The total amount of JE cache in use, in bytes.
 int getCleanerBacklog()
          The number of files to be cleaned to reach the target utilization.
 long getCursorsBins()
          The number of BINs encountered by the INCompressor that had cursors referring to them when the compressor ran.
 long getDataBytes()
          The amount of JE cache used for holding data, keys and internal Btree nodes, in bytes.
 long getDbClosedBins()
          The number of BINs encountered by the INCompressor that had their database closed between the time they were put on the compressor queue and when the compressor ran.
 long getEndOfLog()
          The location of the next entry to be written to the log.
 int getFileDeletionBacklog()
          The number of log files that are ready to be deleted.
 long getInCompQueueSize()
          The number of entries in the INCompressor queue when the getStats() call was made.
 long getLastCheckpointEnd()
          The location in the log of the last checkpoint end.
 long getLastCheckpointId()
          The Id of the last checkpoint.
 long getLastCheckpointStart()
          The location in the log of the last checkpoint start.
 long getLockBytes()
          The number of bytes of JE cache used for holding locks and transactions.
 int getNAcquiresNoWaiters()
          Number of acquires of lock table latch with no contention.
 int getNAcquiresNoWaitSuccessful()
          Number of times acquireNoWait() was successfully called for the lock table latch.
 int getNAcquiresNoWaitUnSuccessful()
          Number of times acquireNoWait() was unsuccessfully called for the lock table latch.
 int getNAcquiresSelfOwned()
          Number of acquires of lock table latch when it was already owned by the caller.
 int getNAcquiresWithContention()
          Number of acquires of lock table latch when it was already owned by another thread.
 long getNBINsStripped()
          The number of BINs stripped by the evictor.
 long getNBytesReadFromWriteQueue()
          The number of bytes read to fulfill file read operations by reading out of the pending write queue.
 long getNBytesWrittenFromWriteQueue()
          The number of bytes written from the pending write queue.
 long getNCacheMiss()
          The total number of requests for database objects which were not in memory.
 long getNCheckpoints()
          The total number of checkpoints run so far.
 long getNCleanerDeletions()
          The number of cleaner file deletions this session.
 long getNCleanerEntriesRead()
          The accumulated number of log entries read by the cleaner.
 long getNCleanerRuns()
          The number of cleaner runs this session.
 long getNClusterLNsProcessed()
          The accumulated number of LNs processed because they qualify for clustering.
 long getNDeltaINFlush()
          The accumulated number of Delta INs flushed to the log.
 long getNEvictPasses()
          The number of passes made to the evictor.
 int getNFileOpens()
          The number of times a log file has been opened.
 long getNFSyncRequests()
          The number of fsyncs requested through the group commit manager.
 long getNFSyncs()
          The number of fsyncs issued through the group commit manager.
 long getNFSyncTimeouts()
          The number of fsync requests submitted to the group commit manager which timed out.
 long getNFullBINFlush()
          The accumulated number of full BINs flushed to the log.
 long getNFullINFlush()
          The accumulated number of full INs flushed to the log.
 long getNINsCleaned()
          The accumulated number of INs cleaned.
 long getNINsDead()
          The accumulated number of INs that were not found in the tree anymore (deleted).
 long getNINsMigrated()
          The accumulated number of INs migrated.
 long getNINsObsolete()
          The accumulated number of INs obsolete.
 long getNLNQueueHits()
          The accumulated number of LNs processed without a tree lookup.
 long getNLNsCleaned()
          The accumulated number of LNs cleaned.
 long getNLNsDead()
          The accumulated number of LNs that were not found in the tree anymore (deleted).
 long getNLNsLocked()
          The accumulated number of LNs encountered that were locked.
 long getNLNsMarked()
          The accumulated number of LNs that were marked for migration during cleaning.
 long getNLNsMigrated()
          The accumulated number of LNs encountered that were migrated forward in the log.
 long getNLNsObsolete()
          The accumulated number of LNs obsolete.
 int getNLogBuffers()
          The number of log buffers currently instantiated.
 long getNMarkedLNsProcessed()
          The accumulated number of LNs processed because they were previously marked for migration.
 long getNNodesExplicitlyEvicted()
          The accumulated number of nodes evicted.
 long getNNodesScanned()
          The accumulated number of nodes scanned in order to select the eviction set.
 long getNNodesSelected()
          The accumulated number of nodes selected to evict.
 long getNNotResident()
          The number of requests for database objects not contained within the in memory data structures.
 long getNonEmptyBins()
          The number of BINs encountered by the INCompressor that were not actually empty when the compressor ran.
 int getNOpenFiles()
          The number of files currently open in the file cache.
 int getNOwners()
          Total lock owners in lock table.
 long getNPendingLNsLocked()
          The accumulated number of pending LNs that could not be locked for migration because of a long duration application lock.
 long getNPendingLNsProcessed()
          The accumulated number of LNs processed because they were previously locked.
 long getNRandomReadBytes()
          The number of bytes read which required repositioning the disk head more than 1MB from the previous file position.
 long getNRandomReads()
          The number of disk reads which required repositioning the disk head more than 1MB from the previous file position.
 long getNRandomWriteBytes()
          The number of bytes written which required repositioning the disk head more than 1MB from the previous file position.
 long getNRandomWrites()
          The number of disk writes which required repositioning the disk head by more than 1MB from the previous file position.
 int getNReadLocks()
          Total read locks currently held.
 long getNReadsFromWriteQueue()
          The number of file read operations which were fulfilled by reading out of the pending write queue.
 int getNReleases()
          Number of releases of the lock table latch.
 long getNRepeatFaultReads()
          The number of reads which had to be repeated when faulting in an object from disk because the read chunk size controlled by je.log.faultReadSize is too small.
 long getNRepeatIteratorReads()
          The number of times we tried to read a log entry larger than the read buffer size and couldn't grow the log buffer to accommodate the large object.
 long getNRequests()
          Total number of lock requests to date.
 long getNRootNodesEvicted()
          The accumulated number of database root nodes evicted.
 long getNSequentialReadBytes()
          The number of bytes read which did not require repositioning the disk head more than 1MB from the previous file position.
 long getNSequentialReads()
          The number of disk reads which did not require repositioning the disk head more than 1MB from the previous file position.
 long getNSequentialWriteBytes()
          The number of bytes written which did not require repositioning the disk head more than 1MB from the previous file position.
 long getNSequentialWrites()
          The number of disk writes which did not require repositioning the disk head by more than 1MB from the previous file position.
 int getNSharedCacheEnvironments()
          The number of environments using the shared cache.
 long getNTempBufferWrites()
          The number of writes which had to be completed using the temporary marshalling buffer because the fixed size log buffers specified by je.log.totalBufferBytes and je.log.numBuffers were not large enough.
 long getNToBeCleanedLNsProcessed()
          The accumulated number of LNs processed because they are soon to be cleaned.
 int getNTotalLocks()
          Total locks currently in lock table.
 int getNWaiters()
          Total transactions waiting for locks.
 long getNWaits()
          Total number of lock waits to date.
 int getNWriteLocks()
          Total write locks currently held.
 long getNWriteQueueOverflow()
          The number of writes operations which would overflow the Write Queue.
 long getNWriteQueueOverflowFailures()
          The number of writes operations which would overflow the Write Queue and could not be queued.
 long getNWritesFromWriteQueue()
          The number of file writes operations executed from the pending write queue.
 long getProcessedBins()
          The number of BINs that were successfully processed by the IN Compressor.
 long getRelatchesRequired()
          Returns the number of latch upgrades (relatches) required while operating on this Environment.
 long getRequiredEvictBytes()
          The number of bytes that must be evicted in order to get within the memory budget.
 long getSharedCacheTotalBytes()
          The total amount of the shared JE cache in use, in bytes.
 long getSplitBins()
          The number of BINs encountered by the INCompressor that were split between the time they were put on the compressor queue and when the compressor ran.
 long getTotalLogSize()
          An approximation of the current total log size in bytes.
 String toString()
          Returns a String representation of the stats in the form of <stat>=<value>
 String toStringVerbose()
          Returns a String representation of the stats which includes stats descriptions in addition to <stat>=<value>
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

getCursorsBins

public long getCursorsBins()
The number of BINs encountered by the INCompressor that had cursors referring to them when the compressor ran.


getDbClosedBins

public long getDbClosedBins()
The number of BINs encountered by the INCompressor that had their database closed between the time they were put on the compressor queue and when the compressor ran.


getInCompQueueSize

public long getInCompQueueSize()
The number of entries in the INCompressor queue when the getStats() call was made.


getNonEmptyBins

public long getNonEmptyBins()
The number of BINs encountered by the INCompressor that were not actually empty when the compressor ran.


getProcessedBins

public long getProcessedBins()
The number of BINs that were successfully processed by the IN Compressor.


getSplitBins

public long getSplitBins()
The number of BINs encountered by the INCompressor that were split between the time they were put on the compressor queue and when the compressor ran.


getLastCheckpointId

public long getLastCheckpointId()
The Id of the last checkpoint.


getNCheckpoints

public long getNCheckpoints()
The total number of checkpoints run so far.


getNFullINFlush

public long getNFullINFlush()
The accumulated number of full INs flushed to the log.


getNFullBINFlush

public long getNFullBINFlush()
The accumulated number of full BINs flushed to the log.


getNDeltaINFlush

public long getNDeltaINFlush()
The accumulated number of Delta INs flushed to the log.


getLastCheckpointStart

public long getLastCheckpointStart()
The location in the log of the last checkpoint start.


getLastCheckpointEnd

public long getLastCheckpointEnd()
The location in the log of the last checkpoint end.


getCleanerBacklog

public int getCleanerBacklog()
The number of files to be cleaned to reach the target utilization.


getFileDeletionBacklog

public int getFileDeletionBacklog()
The number of log files that are ready to be deleted. A file that is ready to be deleted may not yet have been deleted for any of the following reasons:


getNCleanerRuns

public long getNCleanerRuns()
The number of cleaner runs this session.


getNCleanerDeletions

public long getNCleanerDeletions()
The number of cleaner file deletions this session.


getNCleanerEntriesRead

public long getNCleanerEntriesRead()
The accumulated number of log entries read by the cleaner.


getNINsObsolete

public long getNINsObsolete()
The accumulated number of INs obsolete.


getNINsCleaned

public long getNINsCleaned()
The accumulated number of INs cleaned.


getNINsDead

public long getNINsDead()
The accumulated number of INs that were not found in the tree anymore (deleted).


getNINsMigrated

public long getNINsMigrated()
The accumulated number of INs migrated.


getNLNsObsolete

public long getNLNsObsolete()
The accumulated number of LNs obsolete.


getNLNsCleaned

public long getNLNsCleaned()
The accumulated number of LNs cleaned.


getNLNsDead

public long getNLNsDead()
The accumulated number of LNs that were not found in the tree anymore (deleted).


getNLNsLocked

public long getNLNsLocked()
The accumulated number of LNs encountered that were locked.


getNLNsMigrated

public long getNLNsMigrated()
The accumulated number of LNs encountered that were migrated forward in the log.


getNLNsMarked

public long getNLNsMarked()
The accumulated number of LNs that were marked for migration during cleaning.


getNLNQueueHits

public long getNLNQueueHits()
The accumulated number of LNs processed without a tree lookup.


getNPendingLNsProcessed

public long getNPendingLNsProcessed()
The accumulated number of LNs processed because they were previously locked.


getNMarkedLNsProcessed

public long getNMarkedLNsProcessed()
The accumulated number of LNs processed because they were previously marked for migration.


getNToBeCleanedLNsProcessed

public long getNToBeCleanedLNsProcessed()
The accumulated number of LNs processed because they are soon to be cleaned.


getNClusterLNsProcessed

public long getNClusterLNsProcessed()
The accumulated number of LNs processed because they qualify for clustering.


getNPendingLNsLocked

public long getNPendingLNsLocked()
The accumulated number of pending LNs that could not be locked for migration because of a long duration application lock.


getNRepeatIteratorReads

public long getNRepeatIteratorReads()
The number of times we tried to read a log entry larger than the read buffer size and couldn't grow the log buffer to accommodate the large object. This happens during scans of the log during activities like environment open or log cleaning. Implies that the read chunk size controlled by je.log.iteratorReadSize is too small.


getTotalLogSize

public long getTotalLogSize()
An approximation of the current total log size in bytes.


getNCacheMiss

public long getNCacheMiss()
The total number of requests for database objects which were not in memory.


getEndOfLog

public long getEndOfLog()
The location of the next entry to be written to the log.

Note that the log entries prior to this position may not yet have been flushed to disk. Flushing can be forced using a Sync or WriteNoSync commit, or a checkpoint.


getNFSyncs

public long getNFSyncs()
The number of fsyncs issued through the group commit manager.


getNFSyncRequests

public long getNFSyncRequests()
The number of fsyncs requested through the group commit manager.


getNFSyncTimeouts

public long getNFSyncTimeouts()
The number of fsync requests submitted to the group commit manager which timed out.


getNLogBuffers

public int getNLogBuffers()
The number of log buffers currently instantiated.


getNRandomReads

public long getNRandomReads()
The number of disk reads which required repositioning the disk head more than 1MB from the previous file position. Reads in a different *.jdb log file then the last IO constitute a random read.

This number is approximate and may differ from the actual number of random disk reads depending on the type of disks and file system, disk geometry, and file system cache size.


getNRandomReadBytes

public long getNRandomReadBytes()
The number of bytes read which required repositioning the disk head more than 1MB from the previous file position. Reads in a different *.jdb log file then the last IO constitute a random read.

This number is approximate vary depending on the type of disks and file system, disk geometry, and file system cache size.


getNRandomWrites

public long getNRandomWrites()
The number of disk writes which required repositioning the disk head by more than 1MB from the previous file position. Writes to a different *.jdb log file (i.e. a file "flip") then the last IO constitute a random write.

This number is approximate and may differ from the actual number of random disk writes depending on the type of disks and file system, disk geometry, and file system cache size.


getNRandomWriteBytes

public long getNRandomWriteBytes()
The number of bytes written which required repositioning the disk head more than 1MB from the previous file position. Writes in a different *.jdb log file then the last IO constitute a random write.

This number is approximate vary depending on the type of disks and file system, disk geometry, and file system cache size.


getNSequentialReads

public long getNSequentialReads()
The number of disk reads which did not require repositioning the disk head more than 1MB from the previous file position. Reads in a different *.jdb log file then the last IO constitute a random read.

This number is approximate and may differ from the actual number of sequential disk reads depending on the type of disks and file system, disk geometry, and file system cache size.


getNSequentialReadBytes

public long getNSequentialReadBytes()
The number of bytes read which did not require repositioning the disk head more than 1MB from the previous file position. Reads in a different *.jdb log file then the last IO constitute a random read.

This number is approximate vary depending on the type of disks and file system, disk geometry, and file system cache size.


getNSequentialWrites

public long getNSequentialWrites()
The number of disk writes which did not require repositioning the disk head by more than 1MB from the previous file position. Writes to a different *.jdb log file (i.e. a file "flip") then the last IO constitute a random write.

This number is approximate and may differ from the actual number of sequential disk writes depending on the type of disks and file system, disk geometry, and file system cache size.


getNSequentialWriteBytes

public long getNSequentialWriteBytes()
The number of bytes written which did not require repositioning the disk head more than 1MB from the previous file position. Writes in a different *.jdb log file then the last IO constitute a random write.

This number is approximate vary depending on the type of disks and file system, disk geometry, and file system cache size.


getNBytesReadFromWriteQueue

public long getNBytesReadFromWriteQueue()
The number of bytes read to fulfill file read operations by reading out of the pending write queue.


getNBytesWrittenFromWriteQueue

public long getNBytesWrittenFromWriteQueue()
The number of bytes written from the pending write queue.


getNReadsFromWriteQueue

public long getNReadsFromWriteQueue()
The number of file read operations which were fulfilled by reading out of the pending write queue.


getNWritesFromWriteQueue

public long getNWritesFromWriteQueue()
The number of file writes operations executed from the pending write queue.


getNWriteQueueOverflow

public long getNWriteQueueOverflow()
The number of writes operations which would overflow the Write Queue.


getNWriteQueueOverflowFailures

public long getNWriteQueueOverflowFailures()
The number of writes operations which would overflow the Write Queue and could not be queued.


getBufferBytes

public long getBufferBytes()
The total memory currently consumed by log buffers, in bytes. If this environment uses the shared cache, this method returns only the amount used by this environment.


getNNotResident

public long getNNotResident()
The number of requests for database objects not contained within the in memory data structures.


getNRepeatFaultReads

public long getNRepeatFaultReads()
The number of reads which had to be repeated when faulting in an object from disk because the read chunk size controlled by je.log.faultReadSize is too small.


getNTempBufferWrites

public long getNTempBufferWrites()
The number of writes which had to be completed using the temporary marshalling buffer because the fixed size log buffers specified by je.log.totalBufferBytes and je.log.numBuffers were not large enough.


getNFileOpens

public int getNFileOpens()
The number of times a log file has been opened.


getNOpenFiles

public int getNOpenFiles()
The number of files currently open in the file cache.


getNEvictPasses

public long getNEvictPasses()
The number of passes made to the evictor.


getNNodesExplicitlyEvicted

public long getNNodesExplicitlyEvicted()
The accumulated number of nodes evicted.


getNRootNodesEvicted

public long getNRootNodesEvicted()
The accumulated number of database root nodes evicted.


getNBINsStripped

public long getNBINsStripped()
The number of BINs stripped by the evictor.


getRequiredEvictBytes

public long getRequiredEvictBytes()
The number of bytes that must be evicted in order to get within the memory budget.


getNNodesScanned

public long getNNodesScanned()
The accumulated number of nodes scanned in order to select the eviction set.


getNNodesSelected

public long getNNodesSelected()
The accumulated number of nodes selected to evict.


getNSharedCacheEnvironments

public int getNSharedCacheEnvironments()
The number of environments using the shared cache. This method says nothing about whether this environment is using the shared cache or not.


getSharedCacheTotalBytes

public long getSharedCacheTotalBytes()
The total amount of the shared JE cache in use, in bytes. If this environment uses the shared cache, this method returns the total amount used by all environments that are sharing the cache. If this environment does not use the shared cache, this method returns zero.

To get the configured maximum cache size, see EnvironmentMutableConfig.getCacheSize().


getCacheTotalBytes

public long getCacheTotalBytes()
The total amount of JE cache in use, in bytes. If this environment uses the shared cache, this method returns only the amount used by this environment.

This method returns the sum of getDataBytes(), getAdminBytes(), getLockBytes() and getBufferBytes().

To get the configured maximum cache size, see EnvironmentMutableConfig.getCacheSize().


getDataBytes

public long getDataBytes()
The amount of JE cache used for holding data, keys and internal Btree nodes, in bytes. If this environment uses the shared cache, this method returns only the amount used by this environment.


getAdminBytes

public long getAdminBytes()
The number of bytes of JE cache used for log cleaning metadata and other administrative structures. If this environment uses the shared cache, this method returns only the amount used by this environment.


getLockBytes

public long getLockBytes()
The number of bytes of JE cache used for holding locks and transactions. If this environment uses the shared cache, this method returns only the amount used by this environment.


getCacheDataBytes

public long getCacheDataBytes()
Deprecated. Please use getDataBytes() to get the amount of cache used for data and use getAdminBytes(), getLockBytes() and getBufferBytes() to get other components of the total cache usage (getCacheTotalBytes()).

The amount of JE cache used for all items except for the log buffers, in bytes. If this environment uses the shared cache, this method returns only the amount used by this environment.


getRelatchesRequired

public long getRelatchesRequired()
Returns the number of latch upgrades (relatches) required while operating on this Environment. Latch upgrades are required when an operation assumes that a shared (read) latch will be sufficient but later determines that an exclusive (write) latch will actually be required.

Returns:
number of latch upgrades (relatches) required.

getNOwners

public int getNOwners()
Total lock owners in lock table. Only provided when Environment.getStats is called in "slow" mode.


getNReadLocks

public int getNReadLocks()
Total read locks currently held. Only provided when Environment.getStats is called in "slow" mode.


getNTotalLocks

public int getNTotalLocks()
Total locks currently in lock table. Only provided when Environment.getStats is called in "slow" mode.


getNWaiters

public int getNWaiters()
Total transactions waiting for locks. Only provided when Environment.getStats is called in "slow" mode.


getNWriteLocks

public int getNWriteLocks()
Total write locks currently held. Only provided when Environment.getStats is called in "slow" mode.


getNRequests

public long getNRequests()
Total number of lock requests to date.


getNWaits

public long getNWaits()
Total number of lock waits to date.


getNAcquiresNoWaiters

public int getNAcquiresNoWaiters()
Number of acquires of lock table latch with no contention.


getNAcquiresSelfOwned

public int getNAcquiresSelfOwned()
Number of acquires of lock table latch when it was already owned by the caller.


getNAcquiresWithContention

public int getNAcquiresWithContention()
Number of acquires of lock table latch when it was already owned by another thread.


getNAcquiresNoWaitSuccessful

public int getNAcquiresNoWaitSuccessful()
Number of times acquireNoWait() was successfully called for the lock table latch.


getNAcquiresNoWaitUnSuccessful

public int getNAcquiresNoWaitUnSuccessful()
Number of times acquireNoWait() was unsuccessfully called for the lock table latch.


getNReleases

public int getNReleases()
Number of releases of the lock table latch.


toString

public String toString()
Returns a String representation of the stats in the form of <stat>=<value>

Overrides:
toString in class Object

toStringVerbose

public String toStringVerbose()
Returns a String representation of the stats which includes stats descriptions in addition to <stat>=<value>


Berkeley DB Java Edition
version 4.0.92

Copyright (c) 2004-2010 Oracle. All rights reserved.