arangoinspect Options

Usage: arangoinspect [<options>]

General

NameTypeDescription
check-configurationbooleanCheck the configuration and exit
This is a command, no value needs to be specified. The process terminates after executing the command.
configstringThe configuration file or ‘none’
Default: “”
configurationstringThe configuration file or ‘none’
Default: “”
default-languagestringISO-639 language code
Default: “”
default-language-checkbooleanCheck if default language matches stored language
This option can be specified without value to enable it.
Default: true
Introduced in: v3.8.0
definestring…Define key=value for a @key@ entry in config file
Default: []
dump-dependenciesbooleanDump dependency graph
This is a command, no value needs to be specified. The process terminates after executing the command.
dump-optionsbooleanDump configuration options in JSON format
This is a command, no value needs to be specified. The process terminates after executing the command.
jslintstring…Do not start as shell, run jslint instead
Default: []
logstring…The global or topic-specific log level
Default: [“info”]
Deprecated in: v3.5.0
quietbooleanSilent startup
This option can be specified without value to enable it.
Default: false
versionbooleanReports the version and exits
This is a command, no value needs to be specified. The process terminates after executing the command.

Console

NameTypeDescription
console.audit-filestringAudit log file to save commands and results
Default: “”
console.auto-completebooleanEnable auto completion
This option can be specified without value to enable it.
Default: true
console.colorsbooleanEnable color support
This option can be specified without value to enable it.
Default: dynamic (e.g. false)
console.historybooleanWhether or not to load and persist command-line history
This option can be specified without value to enable it.
Default: true
Introduced in: v3.4.5
console.pagerbooleanEnable paging
This option can be specified without value to enable it.
Default: false
console.pager-commandstringPager command
Default: “less -X -R -F -L”
console.pretty-printbooleanEnable pretty printing
This option can be specified without value to enable it.
Default: true
console.promptstringPrompt used in REPL. prompt components are: ‘%t’: current time as timestamp, ‘%p’: duration of last command in seconds, ‘%d’: name of current database, ‘%e’: current endpoint, ‘%E’: current endpoint without protocol, ‘%u’: current user
Default: “%E@%d> “

Encryption

NameTypeDescription
encryption.key-generatorstringEnterprise Edition only
Program providing the encryption key on stdout. If set, encryption will be enabled.
Default: “”
encryption.keyfilestringEnterprise Edition only
File containing the encryption key. If set, encryption will be enabled.
Default: “”

JavaScript

NameTypeDescription
javascript.allow-external-process-controlbooleanAllow execution and control of external processes from within JavaScript actions
This option can be specified without value to enable it.
Default: false
Introduced in: v3.5.0
javascript.allow-port-testingbooleanAllow testing of ports from within JavaScript actions
This option can be specified without value to enable it.
Default: false
Introduced in: v3.5.0
javascript.check-syntaxstring…Syntax check code JavaScript code from file
Default: []
javascript.client-modulestringClient module to use at startup
Default: “inspector.js”
javascript.copy-directorystringTarget directory to copy files from ‘javascript.startup-directory’ into (only used when —javascript.copy-installation is enabled)
Default: “”
javascript.copy-installationbooleanCopy contents of ‘javascript.startup-directory’
This option can be specified without value to enable it.
Default: false
javascript.current-module-directorybooleanAdd current directory to module path
This option can be specified without value to enable it.
Default: true
javascript.endpoints-allowliststring…Endpoints that can be connected to via @arangodb/request module in JavaScript actions
Default: []
Introduced in: v3.5.0
javascript.endpoints-denyliststring…Endpoints that cannot be connected to via @arangodb/request module in JavaScript actions (if not in allowlist)
Default: []
Introduced in: v3.5.0
javascript.environment-variables-allowliststring…Environment variables that will be accessible in JavaScript
Default: []
Introduced in: v3.5.0
javascript.environment-variables-denyliststring…Environment variables that will be inaccessible in JavaScript (if not in allowlist)
Default: []
Introduced in: v3.5.0
javascript.executestring…Execute JavaScript code from file
Default: []
javascript.execute-stringstring…Execute JavaScript code from string
Default: []
javascript.files-allowliststring…Filesystem paths that will be accessible from within JavaScript actions
Default: []
Introduced in: v3.5.0
javascript.gc-intervaluint64Request-based garbage collection interval (each n.th command)
Default: 50
javascript.hardenbooleanDisables access to JavaScript functions in the internal module: getPid() and logLevel()
This option can be specified without value to enable it.
Default: false
Introduced in: v3.5.0
javascript.module-directorystring…Additional paths containing JavaScript modules
Default: []
javascript.startup-directorystringStartup paths containing the JavaScript files
Default: “./js”
javascript.startup-options-allowliststring…Startup options whose names match this regular expression will be allowed and exposed to JavaScript
Default: []
Introduced in: v3.5.0
javascript.startup-options-denyliststring…Startup options whose names match this regular expression will not be exposed (if not in allowlist) to JavaScript actions
Default: []
Introduced in: v3.5.0
javascript.unit-test-filterstringFilter testcases in suite
Default: “”
javascript.unit-testsstring…Do not start as shell, run unit tests instead
Default: []
javascript.v8-max-heapuint64Maximal heap size (in MB)
Default: 3072
javascript.v8-optionsstring…Options to pass to v8
Default: []

Log

NameTypeDescription
log.colorbooleanUse colors for TTY logging
This option can be specified without value to enable it.
Default: dynamic (e.g. true)
log.escapebooleanEscape characters when logging
This option can be specified without value to enable it.
Default: true
log.filestringShortcut for ‘—log.output file://
Default: “-“
log.file-groupstringGroup to use for new log file, user must be a member of this group
Default: “”
Introduced in: v3.4.5
log.file-modestringMode to use for new log file, umask will be applied as well
Default: “”
Introduced in: v3.4.5
log.force-directbooleanDo not start a seperate thread for logging
This option can be specified without value to enable it.
Default: false
log.foreground-ttybooleanAlso log to tty if backgrounded
This option can be specified without value to enable it.
Default: dynamic (e.g. false)
log.hostnamestringHostname to use in log message (empty for none, use ‘auto’ to automatically figure out hostname)
Default: “”
Introduced in: v3.8.0
log.idsbooleanLog unique message ids
This option can be specified without value to enable it.
Default: true
Introduced in: v3.5.0
log.levelstring…The global or topic-specific log level
Default: [“info”]
log.line-numberbooleanInclude the function name, file name and line number of the source code that issues the log message. Format: [func@FileName.cpp:123]
This option can be specified without value to enable it.
Default: false
log.max-entry-lengthuint32Maximum length of a log entry (in bytes)
Default: 134217728
Introduced in: v3.7.9
log.outputstring…Log destination(s), e.g. file:///path/to/file (any ‘$PID’ will be replaced with the process id)
Default: []
log.performancebooleanShortcut for ‘—log.level performance=trace’
This option can be specified without value to enable it.
Default: false
Deprecated in: v3.5.0
log.prefixstringPrefix log message with this string
Default: “”
log.processbooleanShow process identifier (pid) in log message
This option can be specified without value to enable it.
Default: true
Introduced in: v3.8.0
log.request-parametersbooleanInclude full URLs and HTTP request parameters in trace logs
This option can be specified without value to enable it.
Default: true
log.rolebooleanLog server role
This option can be specified without value to enable it.
Default: false
log.shorten-filenamesbooleanShorten filenames in log output (use with —log.line-number)
This option can be specified without value to enable it.
Default: true
log.threadbooleanShow thread identifier in log message
This option can be specified without value to enable it.
Default: false
log.thread-namebooleanShow thread name in log message
This option can be specified without value to enable it.
Default: false
log.time-formatstringTime format to use in logs
Default: “utc-datestring”
Possible values: “local-datestring”, “timestamp”, “timestamp-micros”, “timestamp-millis”, “uptime”, “uptime-micros”, “uptime-millis”, “utc-datestring”, “utc-datestring-millis”
Introduced in: v3.5.0
log.use-json-formatbooleanUse json output format
This option can be specified without value to enable it.
Default: false
Introduced in: v3.8.0
log.use-local-timebooleanUse local timezone instead of UTC
This option can be specified without value to enable it.
Default: false
Deprecated in: v3.5.0
log.use-microtimebooleanUse microtime instead
This option can be specified without value to enable it.
Default: false
Deprecated in: v3.5.0

Random

NameTypeDescription
random.generatoruint32Random number generator to use (1 = MERSENNE, 2 = RANDOM, 3 = URANDOM, 4 = COMBINED (not for Windows), 5 = WinCrypt (Windows only)
Default: 1
Possible values: 1, 2, 3, 4

Server

NameTypeDescription
server.ask-jwt-secretbooleanIf this option is specified, the user will be prompted for a JWT secret. This option is not compatible with —server.username or —server.password. If specified, it will be used for all connections - even when a new connection to another server is created
This option can be specified without value to enable it.
Default: true
server.authenticationbooleanRequire authentication credentials when connecting (does not affect the server-side authentication settings)
This option can be specified without value to enable it.
Default: false
server.connection-timeoutdoubleConnection timeout in seconds
Default: 5
server.databasestringDatabase name to use when connecting
Default: “_system”
server.endpointstringEndpoint to connect to. Use ‘none’ to start without a server. Use http+ssl:// or vst+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp://, vst+tcp:// or unix://
Default: “http+tcp://127.0.0.1:8529”
server.force-jsonbooleanForce to not use VelocyPack for easier debugging
This option can be specified without value to enable it.
Default: false
Introduced in: v3.6.0
server.jwt-secret-keyfilestringIf this option is specified, the jwt secret will be loaded from the given file. This option is not compatible with —server.ask-jwt-secret, —server.username or —server.password. If specified, it will be used for all connections - even when a new connection to another server is created
Default: “”
server.max-packet-sizeuint64Maximum packet size (in bytes) for client/server communication
Default: 1073741824
server.passwordstringPassword to use when connecting. If not specified and authentication is required, the user will be prompted for a password
Default: “”
server.request-timeoutdoubleRequest timeout in seconds
Default: 1200
server.usernamestringUsername to use when connecting
Default: “root”

SSL

NameTypeDescription
ssl.protocoluint64Ssl protocol (1 = SSLv2 (unsupported), 2 = SSLv2 or SSLv3 (negotiated), 3 = SSLv3, 4 = TLSv1, 5 = TLSv1.2, 6 = TLSv1.3, 9 = generic TLS)
Default: 5
Possible values: 1, 2, 3, 4, 5, 6, 9

Temp

NameTypeDescription
temp.pathstringPath for temporary files
Default: “”