From 817e9d79f641e375f9ad94454d187419666e039d Mon Sep 17 00:00:00 2001 From: Natalia Ivakina <82437520+NataliaIvakina@users.noreply.github.com> Date: Tue, 18 Nov 2025 14:16:29 +0100 Subject: [PATCH] Add note on configuring logging in embedded Neo4j (#2690) Co-authored-by: Reneta Popova --- modules/ROOT/pages/monitoring/logging.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/modules/ROOT/pages/monitoring/logging.adoc b/modules/ROOT/pages/monitoring/logging.adoc index c95fd4c87..e5417e426 100644 --- a/modules/ROOT/pages/monitoring/logging.adoc +++ b/modules/ROOT/pages/monitoring/logging.adoc @@ -6,6 +6,7 @@ Neo4j provides logs for monitoring purposes. The logs are stored in the _logs_ directory. If you want to use a custom directory, set the path to that directory in the _neo4j.conf_ file by using the parameter xref:configuration/configuration-settings.adoc#config_server.directories.logs[`server.directories.logs`]. + == Log files The following table describes the log files that are available in Neo4j and their default configuration. @@ -338,6 +339,14 @@ The default logging configuration is a good starting point, but you might want t The following sections describe some Log4j configuration elements and how to use them to customize the logging configuration. For additional information and more advanced customizations, such as filtering and extensions, see the https://logging.apache.org/log4j/2.x/manual/configuration.html[Log4j official documentation on configuration]. +[NOTE] +==== +If Neo4j is embedded in your Java applications, you must provide an implementation of `org.neo4j.logging.LogProvider`. +Depending on how you set up your log provider, it uses or ignores the _user-logs.xml_ file. +For details, refer to link:{neo4j-docs-base-uri}/java-reference/{page-version}/java-embedded/logging/[Java Reference -> Using Neo4j embedded in Java applications]. +==== + + [[general-logging-appenders]] === Appenders All Log4j standard appenders are available in Neo4j.