3.7. Controlling logging

This section describes how to control logging in Neo4j embedded using the Neo4j embedded logging framework.

Neo4j embedded provides logging via its own org.neo4j.logging.Log layer, and does not natively use any existing Java logging framework. All logging events produced by Neo4j have a name, a level and a message. The name is a FQCN (fully qualified class name).

Neo4j uses the following log levels:


For serious errors that are almost always fatal


For events that are serious, but not fatal


Informational events


Debugging events

To enable logging, an implementation of org.neo4j.logging.LogProvider must be provided to the GraphDatabaseFactory, as follows:

        LogProvider logProvider = new MyCustomLogProvider( output );
        graphDb = new GraphDatabaseFactory().setUserLogProvider( logProvider ).newEmbeddedDatabase( databaseDirectory );

Neo4j also includes a binding for SLF4J, which is available in the neo4j-slf4j library jar. This can be obtained via Maven:


To use this binding, pass an instance of org.neo4j.logging.slf4j.Slf4jLogProvider to the GraphDatabaseFactory, as follows:

        graphDb = new GraphDatabaseFactory().setUserLogProvider( new Slf4jLogProvider() )
                .newEmbeddedDatabase( databaseDirectory );

All log output can then be controlled via SLF4J configuration.