26.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 in Section 3.3, “Properties”.

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

all_stores_total_mapped_memory_size

The size to allocate for a memory mapping pool to be shared between all stores.

String

yes

no

allow_store_upgrade

Whether to allow a store upgrade in case the current version of the database starts against an older store version. Setting this to true does not guarantee successful upgrade, just that it allows an attempt at it.

String

yes

no

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.

String

yes

no

backup_slave

Mark this database as a backup slave.

String

yes

no

cache_type

The type of cache to use for nodes and relationships. Note that the Neo4j Enterprise Edition has the additional hpc cache type (High-Performance Cache). See the chapter on caches in the manual for more information.

String

yes

no

cypher_parser_version

Enable this to specify a parser other than the default one.

String

yes

no

dump_configuration

Print out the effective Neo4j configuration after startup.

String

yes

no

ephemeral

Configuration attribute

String

yes

no

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

no

gc_monitor_threshold

The amount of time in ms the monitor thread has to be blocked before logging a message it was blocked.

String

yes

no

gc_monitor_wait_time

Amount of time in ms the GC monitor thread will wait before taking another measurement.

String

yes

no

ha.initial_hosts

Configuration attribute

String

yes

no

ha.server_id

Configuration attribute

String

yes

no

intercept_committing_transactions

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

String

yes

no

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

no

jmx.port

Configuration attribute

String

yes

no

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

no

label_block_size

Specifies the block size for storing labels exceeding in-lined space in node record. This parameter is only honored when the store is created, otherwise it is ignored. The default block size is 60 bytes, and the overhead of each block is the same as for string blocks, i.e., 8 bytes.

String

yes

no

log_mapped_memory_stats_filename

The file where Neo4j will record memory mapping statistics.

String

yes

no

log_mapped_memory_stats_interval

The number of records to be loaded between regular logging of memory mapping statistics.

String

yes

no

log_mapped_memory_stats

Tell Neo4j to regularly log memory mapping statistics.

String

yes

no

logging.threshold_for_rotation

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

String

yes

no

logical_log_rotation_threshold

Specifies at which file size the logical log will auto-rotate. 0 means that no rotation will automatically occur based on file size. Default is 25M

String

yes

no

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

no

mapped_memory_page_size

Target size for pages of mapped memory.

String

yes

no

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

no

neostore.nodestore.db.mapped_memory

The size to allocate for memory mapping the node store.

String

yes

no

neostore.propertystore.db.arrays.mapped_memory

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

String

yes

no

neostore.propertystore.db.index.keys.mapped_memory

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

String

yes

no

neostore.propertystore.db.index.mapped_memory

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

String

yes

no

neostore.propertystore.db.mapped_memory

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

String

yes

no

neostore.propertystore.db.strings.mapped_memory

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

String

yes

no

neostore.relationshipstore.db.mapped_memory

The size to allocate for memory mapping the relationship store.

String

yes

no

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

no

node_keys_indexable

A list of property names (comma separated) that will be indexed by default. This applies to Nodes only.

String

yes

no

online_backup_enabled

Enable support for running online backups

String

yes

no

online_backup_server

Listening server for online backups

String

yes

no

read_only

Only allow read operations from this Neo4j instance. This mode still requires write access to the directory for lock purposes

String

yes

no

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

no

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

no

relationship_grab_size

How many relationships to read at a time during iteration

String

yes

no

relationship_keys_indexable

A list of property names (comma separated) that will be indexed by default. This applies to Relationships only.

String

yes

no

remote_logging_enabled

Whether to enable logging to a remote server or not.

String

yes

no

remote_logging_host

Host for remote logging using LogBack SocketAppender.

String

yes

no

remote_logging_port

Port for remote logging using LogBack SocketAppender.

String

yes

no

remote_shell_enabled

Enable a remote shell server which shell clients can log in to

String

yes

no

store_dir

The directory where the database files are located.

String

yes

no

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.

String

yes

no

tx_manager_impl

The name of the Transaction Manager service to use as defined in the TM service provider constructor.

String

yes

no

use_memory_mapped_buffers

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

String

yes

no

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

dumpAll

Dump diagnostics information to JMX

String

(no parameters)

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

Alive

Whether this instance is alive or not

boolean

yes

no

Available

Whether this instance is available or not

boolean

yes

no

InstanceId

The identifier used to identify this server in the HA cluster

String

yes

no

InstancesInCluster

Information about all instances in this cluster

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

yes

no

LastCommittedTxId

The latest transaction id present in this instance’s store

long

yes

no

LastUpdateTime

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

String

yes

no

Role

The role this instance has in the cluster

String

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

NumberOfAvertedDeadlocks

The number of lock sequences that would have lead to a deadlock situation that Neo4j has detected and averted (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.jmx.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