Changes

Jump to navigation Jump to search
292 bytes added ,  13:47, 19 August 2021
This article is part of the [[Advanced User's Guide]]. It describes how client operations are logged by the server.The server logs can e.g. be used to get an overview of all processes executed on your server, trace any errorsor compile performance statistics.
==Introduction==
The server logs are written in plain text. In your [[Configuration#Database Directory|Database Directory]], you can find a folder named <code>.logs</code> in which all log files are stored with the according date. Note that, depending on your OS and configuration, files and folders beinning beginning with a <code>.</code> may be hidden. The log directory can be changed via the {{Option|LOGPATH}} option. If BaseX is used in a [[Web Application]], all trace output (generated via {{Code|fn:trace}}, {{Function|Profiling|prof:dump}} and similar functions) will be stored in the logs as well.
Some more notes on the logging facility:
* The maximum length of logging messages can be changed via {{Option|LOGMSGMAXLEN}}.
* The [[Admin Module]] provides access to the log files from XQuery.
 
If a proxy is used, the original IP address of the client will be added to the logs.
==RESTXQ==
 
{{Mark|Updated with Version 9.3:}} User will also be looked up in the request attributes.
By default, RESTXQ code is executed with the {{Code|admin}} user. As a result, this user will be displayed in the logs for all RESTXQ requests. In a web application with a custom user management, however, the name of the actual user who has sent a request is often more relevant.
=Changelog=
 
;Version 9.5
* Updated: Show IP address behind proxy.
;Version 9.3
* Updated: Store trace output in database logs* Updated: [[#RESTXQ|RESTXQ]]: User The request attributes will also be looked up in the request attributeschecked for a user id.
;Version 8.6
* Added: The log directory can be changed with the {{Option|LOGPATH}} option.
* Updated: Include session attributes in log data.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu