25.4. Reference of supported JMX MBeans

MBeans exposed by Neo4j

NameDescription

Branched Store

Information about the branched stores present in this HA cluster member

Cache/NodeCache

Information about the caching in Neo4j

Cache/RelationshipCache

Information about the caching in Neo4j

Configuration

The configuration parameters used to configure Neo4j

Diagnostics

Diagnostics provided by Neo4j

High Availability

Information about an instance participating in a HA cluster

Kernel

Information about the Neo4j kernel

Locking

Information about the Neo4j lock status

Memory Mapping

The status of Neo4j memory mapping

Primitive count

Estimates of the numbers of different kinds of Neo4j primitives

Store file sizes

Information about the sizes of the different parts of the Neo4j graph store

Transactions

Information about the Neo4j transaction manager

XA Resources

Information about the XA transaction manager


[Note]Note

For additional information on the primitive datatypes (int, long etc.) used in the JMX attributes, please see Property value types.

MBean Branched Store (org.neo4j.management.BranchedStore) Attributes

NameDescriptionTypeReadWrite

Information about the branched stores present in this HA cluster member

BranchedStores

A list of the branched stores

org.neo4j.management.BranchedStoreInfo[] as CompositeData[]

yes

no


MBean Cache/NodeCache (org.neo4j.management.Cache) Attributes

NameDescriptionTypeReadWrite

Information about the caching in Neo4j

CacheSize

The size of this cache (nr of entities or total size in bytes)

long

yes

no

CacheType

The type of cache used by Neo4j

String

yes

no

HitCount

The number of times a cache query returned a result

long

yes

no

MissCount

The number of times a cache query did not return a result

long

yes

no


MBean Cache/NodeCache (org.neo4j.management.Cache) Operations

NameDescriptionReturnTypeSignature

clear

Clears the Neo4j caches

void

(no parameters)


MBean Cache/RelationshipCache (org.neo4j.management.Cache) Attributes

NameDescriptionTypeReadWrite

Information about the caching in Neo4j

CacheSize

The size of this cache (nr of entities or total size in bytes)

long

yes

no

CacheType

The type of cache used by Neo4j

String

yes

no

HitCount

The number of times a cache query returned a result

long

yes

no

MissCount

The number of times a cache query did not return a result

long

yes

no


MBean Cache/RelationshipCache (org.neo4j.management.Cache) Operations

NameDescriptionReturnTypeSignature

clear

Clears the Neo4j caches

void

(no parameters)


MBean Configuration (org.neo4j.jmx.impl.ConfigurationBean) Attributes

NameDescriptionTypeReadWrite

The configuration parameters used to configure Neo4j

allow_store_upgrade

Configuration attribute

String

yes

yes

array_block_size

Specifies the block size for storing arrays. This parameter is only honored when the store is created, otherwise it is ignored. The default block size is 120 bytes, and the overhead of each block is the same as for string blocks, i.e., 8 bytes.. 1 < array_block_size

String

yes

yes

backup_slave

Mark this database as a backup slave.

String

yes

yes

cache_type

The type of cache to use for nodes and relationships. Note that the Neo4j Enterprise Edition has the additional gcr cache type. See the chapter on caches in the manual for more information.. Valid options:[gcr, soft, weak, strong, none]

String

yes

yes

dump_configuration

Print out the effective Neo4j configuration after startup.

String

yes

yes

ephemeral

Configuration attribute

String

yes

yes

execution_guard_enabled

Configuration attribute

String

yes

yes

forced_kernel_id

An identifier that uniquely identifies this graph database instance within this JVM. Defaults to an auto-generated number depending on how many instance are started in this JVM.

String

yes

yes

gc_monitor_threshold

Configuration attribute

String

yes

yes

gc_monitor_wait_time

Configuration attribute

String

yes

yes

gcr_cache_min_log_interval

The minimal time that must pass in between logging statistics from the cache (when using the gcr cache).

String

yes

yes

grab_file_lock

Whether to grab locks on files or not.

String

yes

yes

ha.allow_init_cluster

Configuration attribute

String

yes

yes

ha.branched_data_policy

Configuration attribute

String

yes

yes

ha.cluster_name

Configuration attribute

String

yes

yes

ha.com_chunk_size

Configuration attribute

String

yes

yes

ha.coordinator_fetch_info_timeout

Configuration attribute

String

yes

yes

ha.coordinators

Configuration attribute

String

yes

yes

ha.max_concurrent_channels_per_slave

Configuration attribute

String

yes

yes

ha.pull_interval

Configuration attribute

String

yes

yes

ha.read_timeout

Configuration attribute

String

yes

yes

ha.server_id

Configuration attribute

String

yes

yes

ha.server

Configuration attribute

String

yes

yes

ha.slave_coordinator_update_mode

Configuration attribute

String

yes

yes

ha.tx_push_factor

Configuration attribute

String

yes

yes

ha.tx_push_strategy

Configuration attribute

String

yes

yes

ha.zk_session_timeout

Configuration attribute

String

yes

yes

intercept_committing_transactions

Determines whether any TransactionInterceptors loaded will intercept prepared transactions before they reach the logical log.

String

yes

yes

intercept_deserialized_transactions

Determines whether any TransactionInterceptors loaded will intercept externally received transactions (e.g. in HA) before they reach the logical log and are applied to the store.

String

yes

yes

jmx.port

Configuration attribute

String

yes

yes

keep_logical_logs

Make Neo4j keep the logical transaction logs for being able to backup the database.Can be used for specifying the threshold to prune logical logs after. For example "10 days" will prune logical logs that only contains transactions older than 10 days from the current time, or "100k txs" will keep the 100k latest transactions and prune any older transactions.

String

yes

yes

load_kernel_extensions

Configuration attribute

String

yes

yes

logging.threshold_for_rotation

Threshold in bytes for when database logs (text logs, for debugging, that is) are rotated.. 1 < logging.threshold_for_rotation

String

yes

yes

logical_log

The base name for the logical log files, either an absolute path or relative to the store_dir setting. This should generally not be changed.

String

yes

yes

lucene_searcher_cache_size

Configuration attribute

String

yes

yes

neo4j.ext.udc.enabled

Configuration attribute

String

yes

yes

neo4j.ext.udc.first_delay

Configuration attribute

String

yes

yes

neo4j.ext.udc.host

Configuration attribute

String

yes

yes

neo4j.ext.udc.interval

Configuration attribute

String

yes

yes

neo4j.ext.udc.reg

Configuration attribute

String

yes

yes

neo_store

The base name for the Neo4j Store files, either an absolute path or relative to the store_dir setting. This should generally not be changed.

String

yes

yes

neostore.nodestore.db.mapped_memory

The size to allocate for memory mapping the node store.

String

yes

yes

neostore.propertystore.db.arrays.mapped_memory

The size to allocate for memory mapping the array property store.

String

yes

yes

neostore.propertystore.db.index.keys.mapped_memory

The size to allocate for memory mapping the store for property key strings.

String

yes

yes

neostore.propertystore.db.index.mapped_memory

The size to allocate for memory mapping the store for property key indexes.

String

yes

yes

neostore.propertystore.db.mapped_memory

The size to allocate for memory mapping the property value store.

String

yes

yes

neostore.propertystore.db.strings.mapped_memory

The size to allocate for memory mapping the string property store.

String

yes

yes

neostore.relationshipstore.db.mapped_memory

The size to allocate for memory mapping the relationship store.

String

yes

yes

node_auto_indexing

Controls the auto indexing feature for nodes. Setting to false shuts it down, while true enables it by default for properties listed in the node_keys_indexable setting.

String

yes

yes

node_cache_array_fraction

The fraction of the heap (1%-10%) to use for the base array in the node cache (when using the gcr cache).. 1.0 < node_cache_array_fraction < 10.0

String

yes

yes

node_cache_size

The amount of memory to use for the node cache (when using the gcr cache).

String

yes

yes

online_backup_enabled

Configuration attribute

String

yes

yes

online_backup_port

Configuration attribute

String

yes

yes

read_only

Only allow read operations from this Neo4j instance.

String

yes

yes

rebuild_idgenerators_fast

Use a quick approach for rebuilding the ID generators. This give quicker recovery time, but will limit the ability to reuse the space of deleted entities.

String

yes

yes

relationship_auto_indexing

Controls the auto indexing feature for relationships. Setting to false shuts it down, while true enables it by default for properties listed in the relationship_keys_indexable setting.

String

yes

yes

relationship_cache_array_fraction

The fraction of the heap (1%-10%) to use for the base array in the relationship cache (when using the gcr cache).. 1.0 < relationship_cache_array_fraction < 10.0

String

yes

yes

relationship_cache_size

The amount of memory to use for the relationship cache (when using the gcr cache).

String

yes

yes

relationship_grab_size

Configuration attribute

String

yes

yes

remote_logging_enabled

Configuration attribute

String

yes

yes

remote_logging_host

Host for remote logging using LogBack SocketAppender.

String

yes

yes

remote_logging_port

Port for remote logging using LogBack SocketAppender.. 1 < remote_logging_port < 65535

String

yes

yes

remote_shell_enabled

Configuration attribute

String

yes

yes

remote_shell_name

Configuration attribute

String

yes

yes

remote_shell_port

Configuration attribute

String

yes

yes

remote_shell_read_only

Configuration attribute

String

yes

yes

store_dir

The directory where the database files are located.

String

yes

yes

string_block_size

Specifies the block size for storing strings. This parameter is only honored when the store is created, otherwise it is ignored. Note that each character in a string occupies two bytes, meaning that a block size of 120 (the default size) will hold a 60 character long string before overflowing into a second block. Also note that each block carries an overhead of 8 bytes. This means that if the block size is 120, the size of the stored records will be 128 bytes.. 1 < string_block_size

String

yes

yes

use_memory_mapped_buffers

Tell Neo4j to use memory mapped buffers for accessing the native storage layer.

String

yes

yes


MBean Configuration (org.neo4j.jmx.impl.ConfigurationBean) Operations

NameDescriptionReturnTypeSignature

apply

Apply settings

void

(no parameters)


MBean Diagnostics (org.neo4j.management.Diagnostics) Attributes

NameDescriptionTypeReadWrite

Diagnostics provided by Neo4j

DiagnosticsProviders

A list of the ids for the registered diagnostics providers.

List (java.util.List)

yes

no


MBean Diagnostics (org.neo4j.management.Diagnostics) Operations

NameDescriptionReturnTypeSignature

dumpToLog

Dump diagnostics information to the log.

void

(no parameters)

dumpToLog

Dump diagnostics information to the log.

void

java.lang.String

extract

Operation exposed for management

String

java.lang.String


MBean High Availability (org.neo4j.management.HighAvailability) Attributes

NameDescriptionTypeReadWrite

Information about an instance participating in a HA cluster

ConnectedSlaves

(If this is a master) Information about the instances connected to this instance

org.neo4j.management.SlaveInfo[] as CompositeData[]

yes

no

InstancesInCluster

Information about all instances in this cluster

org.neo4j.management.InstanceInfo[] as CompositeData[]

yes

no

LastUpdateTime

The time when the data on this instance was last updated from the master

String

yes

no

MachineId

The identifier used to identify this machine in the HA cluster

String

yes

no

Master

Whether this instance is master or not

boolean

yes

no


MBean High Availability (org.neo4j.management.HighAvailability) Operations

NameDescriptionReturnTypeSignature

update

(If this is a slave) Update the database on this instance with the latest transactions from the master

String

(no parameters)


MBean Kernel (org.neo4j.jmx.Kernel) Attributes

NameDescriptionTypeReadWrite

Information about the Neo4j kernel

KernelStartTime

The time from which this Neo4j instance was in operational mode.

Date (java.util.Date)

yes

no

KernelVersion

The version of Neo4j

String

yes

no

MBeanQuery

An ObjectName that can be used as a query for getting all management beans for this Neo4j instance.

javax.management.ObjectName

yes

no

ReadOnly

Whether this is a read only instance

boolean

yes

no

StoreCreationDate

The time when this Neo4j graph store was created.

Date (java.util.Date)

yes

no

StoreDirectory

The location where the Neo4j store is located

String

yes

no

StoreId

An identifier that, together with store creation time, uniquely identifies this Neo4j graph store.

String

yes

no

StoreLogVersion

The current version of the Neo4j store logical log.

long

yes

no


MBean Locking (org.neo4j.management.LockManager) Attributes

NameDescriptionTypeReadWrite

Information about the Neo4j lock status

Locks

Information about all locks held by Neo4j

java.util.List<org.neo4j.kernel.info.LockInfo> as CompositeData[]

yes

no

NumberOfAdvertedDeadlocks

The number of lock sequences that would have lead to a deadlock situation that Neo4j has detected and adverted (by throwing DeadlockDetectedException).

long

yes

no


MBean Locking (org.neo4j.management.LockManager) Operations

NameDescriptionReturnTypeSignature

getContendedLocks

getContendedLocks

java.util.List<org.neo4j.kernel.info.LockInfo> as CompositeData[]

long


MBean Memory Mapping (org.neo4j.management.MemoryMapping) Attributes

NameDescriptionTypeReadWrite

The status of Neo4j memory mapping

MemoryPools

Get information about each pool of memory mapped regions from store files with memory mapping enabled

org.neo4j.management.WindowPoolInfo[] as CompositeData[]

yes

no


MBean Primitive count (org.neo4j.jmx.Primitives) Attributes

NameDescriptionTypeReadWrite

Estimates of the numbers of different kinds of Neo4j primitives

NumberOfNodeIdsInUse

An estimation of the number of nodes used in this Neo4j instance

long

yes

no

NumberOfPropertyIdsInUse

An estimation of the number of properties used in this Neo4j instance

long

yes

no

NumberOfRelationshipIdsInUse

An estimation of the number of relationships used in this Neo4j instance

long

yes

no

NumberOfRelationshipTypeIdsInUse

The number of relationship types used in this Neo4j instance

long

yes

no


MBean Store file sizes (org.neo4j.management.StoreFile) Attributes

NameDescriptionTypeReadWrite

Information about the sizes of the different parts of the Neo4j graph store

ArrayStoreSize

The amount of disk space used to store array properties, in bytes.

long

yes

no

LogicalLogSize

The amount of disk space used by the current Neo4j logical log, in bytes.

long

yes

no

NodeStoreSize

The amount of disk space used to store nodes, in bytes.

long

yes

no

PropertyStoreSize

The amount of disk space used to store properties (excluding string values and array values), in bytes.

long

yes

no

RelationshipStoreSize

The amount of disk space used to store relationships, in bytes.

long

yes

no

StringStoreSize

The amount of disk space used to store string properties, in bytes.

long

yes

no

TotalStoreSize

The total disk space used by this Neo4j instance, in bytes.

long

yes

no


MBean Transactions (org.neo4j.management.TransactionManager) Attributes

NameDescriptionTypeReadWrite

Information about the Neo4j transaction manager

LastCommittedTxId

The id of the latest committed transaction

long

yes

no

NumberOfCommittedTransactions

The total number of committed transactions

long

yes

no

NumberOfOpenedTransactions

The total number started transactions

int

yes

no

NumberOfOpenTransactions

The number of currently open transactions

int

yes

no

NumberOfRolledBackTransactions

The total number of rolled back transactions

long

yes

no

PeakNumberOfConcurrentTransactions

The highest number of transactions ever opened concurrently

int

yes

no


MBean XA Resources (org.neo4j.management.XaManager) Attributes

NameDescriptionTypeReadWrite

Information about the XA transaction manager

XaResources

Information about all XA resources managed by the transaction manager

org.neo4j.management.XaResourceInfo[] as CompositeData[]

yes

no