Bureaucrats, editor, reviewer, Administrators
13,554
edits
Changes
Jump to navigation
Jump to search
→admin:write-log
{| width='100%'
|- stylevalign="vertical-align:top;"| width='120' | '''SignaturesSignature'''|{{Func|admin:logs||element(file)*}}<br/pre>{{Func|admin:logs|( $date as xs:string|element := (entry)*}}<br/>{{Func|admin:logs|$date as xs:string, $merge as xs:boolean|? := false()) as element(entry)*}}<br/pre>|- stylevalign="vertical-align:top;"
| '''Summary'''
|Returns [[Logging]] data compiled by the database or HTTP server:
* If no argument is specified, a list of all log files will be returned, including the file size and date.
* If a {{Code|$date}} is specified, the contents of a single log file will be returned.
* If {{Code|$merge}} is set to true, related log entries will be merged. Please note that the merge might The merged representation may not be 100% successfulcorrect, as log entries may can be ambiguous.|- stylevalign="vertical-align:top;"
| '''Examples'''
|
{| width='100%'
|- stylevalign="vertical-align:top;"| width='120' | '''SignaturesSignature'''|{{Func|admin:write-log|$text as xs:string|empty-sequence()}}<br/pre>{{Func|admin:write-log|( $text message as xs:string, $type as xs:string| := ()) as empty-sequence()}}</pre>|- stylevalign="vertical-align:top;"
| '''Summary'''
|Writes a string log {{Code|$message}} to the database logs, along with current user data (timestamp, user nameusername). An optional log {{Code|$type}} can be specified. If omitted, the log type is {{Code|INFO}}.<br/>If the function is called from a database client, the IP will be logged. Otherwise, the string {{Code|SERVER}} will be logged.|- stylevalign="vertical-align:top;"
| '''Errors'''
|{{Error|type|#Errors}} Type string contains whitespaces.
{| width='100%'
|- stylevalign="vertical-align:top;"| width='120' | '''SignaturesSignature'''|{{Func|<pre>admin:delete-logs|( $date as xs:string|) as empty-sequence()}}</pre>|- stylevalign="vertical-align:top;"
| '''Summary'''
|Deletes the log entries from the specified <code>$date</code>
|- stylevalign="vertical-align:top;"
| '''Errors'''
|{{Error|today|#Errors}} Today's log file cannot be deleted.<br/>{{Error|delete|#Errors}} An error occurred while deleting a log file.
{| width='100%'
|- stylevalign="vertical-align:top;"| width='120' | '''SignaturesSignature'''|{{Func|<pre>admin:sessions||() as element(session)*}}</pre>|- stylevalign="vertical-align:top;"
| '''Summary'''
|Returns an element sequence with all currently opened database sessions, including the user nameusername, address (IP:port) and an optionally opened database.<br/>The output of this function and the {{Command|SHOW SESSIONS}} command is similar.|- stylevalign="vertical-align:top;"
| '''Examples'''
|
! width="110"|Code
|Description
|- stylevalign="vertical-align:top;"
|{{Code|delete}}
|An error occurred while deleting a log file.
|- stylevalign="vertical-align:top;"
|{{Code|today}}
|Today's log file cannot be deleted.
|- stylevalign="vertical-align:top;"
|{{Code|type}}
|Type string contains whitespaces.
