[LogSettings]
Available since Exponential 6.0.15 (in development, not in a release yet).
Summary
The group [LogSettings] of settings/velocity.ini.
File
settings/velocity.ini; override it in settings/override/velocity.ini.append.php, in a siteaccess or in an extension.
Settings
| Setting | Default | Description |
|---|---|---|
| Enabled | enabled | The server's own access and error log, one line per request and one per fault. LogFile above is only what the process prints to the console. On, because without it the server writes nothing at all: no access log, no error log, no record of a single request. |
| Dir | var/vc/qbix/log | The qbix engine's log directory; relative paths resolve against the installation root. Everything Velocity writes for one server is kept together below var/vc/<engine>/: log/ (the frankenphp engine's is [FrankenPHPSettings] LogDir, the php engine's [PHPServerSettings] LogFile), run/ (pid file, console output, generated configuration, admin socket), and for qbix the configuration tree etc/ and lib/, for frankenphp bin/, tls/ and caddy/. Until 2026-09 this was var/log/qbix; an installation that sets Dir keeps its own. |
| AccessName | (empty) | The file names. Empty names them after the default siteaccess ([SiteSettings] DefaultAccess in site.ini): site-access.log and site-error.log for a siteaccess called "site", which keeps several installations apart in one directory. Rotation puts the date in front of the extension, so site-access.log becomes site-access.2026-09-24.log. |
| ErrorName | (empty) | |
| Format | combined | The access line. combined what Apache and nginx write, for tools that read those. The default here. qbix combined, plus the time the response took. The server's own default. common combined without referrer and user agent. Anything else is taken as a format string, with %{Host}i and the like. |
| FileMode | 0640 | Permissions of the log files, octal. Empty leaves them to the umask. An access log names the people who visited, so it is not for every account on the machine to read. |
| DirMode | 0750 | Permissions of the log directory, octal, applied to one that already exists as well. Empty leaves it to the umask, which in practice is 0755 -- anyone could list the files, and 0640 on each of them hides only their contents. 0750 goes with 0640. For a group that shares the logs, 2770 with a FileMode of 0660: the setgid bit passes the group on to new files, it does not give the group write access. chmod needs ownership, so a directory another user created keeps its mode, and the server says so on start. |
See also
Generated example: velocity.ini [LogSettings]
Added to the reference for Exponential 6.0.15: the 4.x reference had no page for this group. The descriptions are the comment lines of settings/velocity.ini.
Contributors
- Graham Brookins Updated
Comments
Add a comment