Neo4j Admin report
You can use the neo4j-admin server report
command to collect information about a Neo4j installation and save it to an archive.
Syntax
The neo4j-admin server report
command has the following syntax:
neo4j-admin server report [-h] [--expand-commands] [--list] [--verbose] [--ignore-disk-space-check[=true|false]] [--additional-config=<file>] [--to-path=<path>] [<classifier>...]
The intended usage of the report tool is to simplify the support process by collecting the relevant information in a standard way. This tool does not send any information automatically. To share this information with the Neo4j Support organization, you have to send it manually.
Options and classifiers
The neo4j-admin server report
command has the following options and classifiers:
Option | Possible values | Description |
---|---|---|
|
Show this help message and exit. |
|
|
Allow command expansion in config value evaluation. |
|
|
List all available classifiers. |
|
|
Enable verbose output. |
|
|
|
Ignore disk full warning. |
|
|
Destination directory for reports. |
By default, the tool tries to estimate the final size of the report and uses that to assert that there is enough disk space available for it.
If there is not enough available space, the tool aborts.
However, this estimation is pessimistic and does not consider the compression.
Therefore, if you are confident that you do have enough disk space, you can disable this check with the option --ignore-disk-space-check
.
Classifier | Online | Description |
---|---|---|
|
Include all of the available classifiers. |
|
|
Include the current cluster state. |
|
|
Include Neo4j configuration files. |
|
|
|
Include a heap dump. |
|
Include log files, e.g., debug.log, neo4j.log, etc. |
|
|
Include the collected metrics. |
|
|
Include a text view of the plugin directory (no files are collected). |
|
|
Include a list of running processes. |
|
|
Include the raft log. |
|
|
|
Include a list of Java system properties. |
|
|
Include a thread dump of the running instance. |
|
Include a text view of the folder structure of the data directory (no files are collected). |
|
|
Include transaction logs. |
The classifiers marked as Online work only when you have a running Neo4j instance that the tool can find.
If no classifiers are specified, the following classifiers are used: logs
, config
, plugins
, tree
, metrics
, threads
, sysprop
, ps
, and version
.
The reporting tool does not read any data from your database.
However, the heap, the raft logs, and the transaction logs may contain data.
Additionally, even though the standard neo4j.conf file does not contain password information, for specific configurations, it may have this type of information.
Therefore, be aware of your organization’s data security rules before using the classifiers heap
, tx
, raft
, and config
.
Examples
This tool uses the Java Attach API to gather data from a running Neo4j instance. Therefore, it requires the Java JDK to run properly. |
neo4j-admin server report
using the default classifiersThe following command gathers information about the Neo4j instance using the default classifiers and saves it to the default location:
$neo4j-home> bin/neo4j-admin server report
neo4j-admin server report
using all classifiersThe following command gathers information about the Neo4j instance using all classifiers and saves it to a specified location:
$neo4j-home> bin/neo4j-admin server report --to-path=./report all
neo4j-admin server report
to gather only logs and thread dumpsThe following command gathers only logs and thread dumps from the running Neo4j instance and saves it to a specified location:
$neo4j-home> bin/neo4j-admin server report --to-path=./report threads logs
Was this page helpful?