HFS: Log menu: Difference between revisions

From rejetto wiki
Jump to navigation Jump to search
 
(22 intermediate revisions by one other user not shown)
Line 1: Line 1:
----
----


This menu can be accessed by right-clicking in the log window in the right pane.
This menu can be accessed by right-clicking in the log window in the right pane of the HFS main window.
The first item is used to specify exactly which items are logged. Check any item you want logged, and uncheck to disable an item.<br>In the listing below, example log entries are shown for every item that can be logged.
The first item is used to specify exactly which items are logged. Check any item you want logged, and uncheck to disable an item.<br>In the listing below, example log entries are shown for most items that can be logged.


[[Image:053.PNG]]
[[Image:056.PNG]]
 
There is no simple text file that contains all possible log messages. Instead, the messages are composed dynamically from elements consisting mainly of the values of variables in reponse to system events.
 
The log message system runs in read-only mode by default. This means that all messages are written to the HFS log window. They disappear forever when you close the server. If you want to keep a more permanent record, uncheck "Read-only mode, and check "Log to file". You are prompted for a filename:<br>
 
[[Image:074.png]]
 
If you use symbols in the filename,"%d%%m%%y%HFS.log" for example, the resultant log file is named something like this: 28102006HFS.log.


==Log what==
==Log what==
;Time
;Time
:Show time in every entry, in hh:mm:ss format, eg."18:51:34"
:Show time in every entry, in hh:mm:ss format, eg."18:51:34".
;Date
;Date
:Show date at the start of every entry. 20/10/2006
:Show date at the start of every entry, in dd:mm:yyyy format, eg. "20/10/2006".
;Browsing
;Browsing
:Log getting of file list. Requested GET /Downloads/~files.lst?
:Log every time a user requests the file list. Log entry example, "Requested GET /Downloads/~files.lst".
;Icons
;Icons
:Log getting file icons.
:Log the getting of file icons. Log entry example, "Requested GET /favicon.ico".
;Progress
;Progress
:Log getting of progress page.  
:Log the getting of progress page.  
;Banned
;Banned
:Log banning of users.
:Log the banning of users.
;Only served events
;Only served events
:xxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
:xxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
;Other events
;Other events
:This contains, for example, dynamic DNS updates.
:This includes, for example, dynamic DNS updates.
;Connections
;Connections
:Log every new connection.
:Log every new connection.
;Disconnections
;Disconnections
:Log closing of connections.
:Log all closing of connections.
;Requests
;Requests
:Log requests the browser made, this means downloads and uploads.
:Log requests made by the browser for downloads and uploads. A typical entry is: "Requested GET /Downloads/<filename>". The file extension is not normally shown.
;Requests dump
;Requests dump
:Show full request dump for every request.
:Show a full request dump for every request. These log entries can be very long. Here, for example, is the entry for a small download request:<br> > Host: localhost<br
> Accept: text/html, application/xml;q=0.9, application/xhtml+xml, image/png, image/jpeg, image/gif, image/x-xbitmap, */*;q=0.1<br
> Accept-Language: en-GB,en;q=0.9<br
> Accept-Charset: iso-8859-1, utf-8, utf-16, *;q=0.1<br
> Referer: xxxxxxx/Downloads/<br
> Connection: Keep-Alive, TE<br
> TE: deflate, gzip, chunked, identity, trailers<br>Fully downloaded - 531 B @ 8 KB/s
;Replies
;Replies
:Log what HFS answered (eg. what it served).
:Log what HFS answered (eg. what it served).
;Full downloads
;Full downloads
:Log completed downloads.
:Log completed downloads. Log entry example, "Fully downloaded - 558,531 B @ 48 KB/s".
;Uploads
;Uploads
:Log uploads.
:Log uploads.
Line 42: Line 56:
:After each request, log how many bytes HFS sent to the browser.
:After each request, log how many bytes HFS sent to the browser.
;Server start
;Server start
:Log starting of HFS.
:Log starting of HFS. The log message is, "Server start".
;Server stop
;Server stop
:Log stopping of HFS.
:Log stopping of HFS. The log message is, "Server stop".


==Main items==
==Main items==
;Log to screen
;Log to screen
:Write log to this window.
:Writes the log to this window. If this is unchecked, nothing is written to the window and no log is kept unless you have turned on "Log to file".
;Log to file
;Log to file
:Write log to a file. When you click this, you are prompted to specify the name of the log file.
:Writes the log to a file. When you click this, you are prompted to specify the name of the log file.
;Do not log address
;Do not log address
:Exclude specified IPs. More about [[HFS:_IP_masks|IP masks]]
:Exclude specified IPs. More about [[HFS:_IP_masks|IP masks]]
;Address 2 name
;Address 2 name
:Opens the translation table for IP addresses to names. These names will be shown in the log in {}-brackets after the real IP. This is useful if you have users with a fixed IP (for example, in a LAN) and want to show their names.
:Opens the translation table for IP addresses to names. These names are shown in the log in {}-brackets after the real IP. This is useful if you have users with a fixed IP (for example, in a LAN) and want to show their names.
;Font
;Font
:Lets you choose the font for the log.
:Lets you choose the font for the log. The usual Windows dialog box is displayed so you can also choose the text size, style, etc.
;Read only
;Read only
:Prevents editing of the log. Normally, leave this checked.
:Prevents editing of the log. Normally, leave this checked.
Line 62: Line 76:
:Copies the whole log, or a selected part, to the clipboard. This is obviously useful when you want to paste log entries into an email or other document.
:Copies the whole log, or a selected part, to the clipboard. This is obviously useful when you want to paste log entries into an email or other document.
;Clear
;Clear
;Deletes all entries in the log window.
:Deletes all entries in the log window.
;Save
;Save
:Saves the log to the file specified in 'Log on file...'
:Saves the log to the file specified in 'Log on file'.
;Save as
;Save as
:Saves the log and prompts you for the file name.
:Saves the log and prompts you for the file name.
;Addresses Ever Connected...
:Displays a list of all the unique ip addresses that have ever connected.

Latest revision as of 04:17, 11 November 2007


This menu can be accessed by right-clicking in the log window in the right pane of the HFS main window. The first item is used to specify exactly which items are logged. Check any item you want logged, and uncheck to disable an item.
In the listing below, example log entries are shown for most items that can be logged.

Error creating thumbnail: Unable to save thumbnail to destination

There is no simple text file that contains all possible log messages. Instead, the messages are composed dynamically from elements consisting mainly of the values of variables in reponse to system events.

The log message system runs in read-only mode by default. This means that all messages are written to the HFS log window. They disappear forever when you close the server. If you want to keep a more permanent record, uncheck "Read-only mode, and check "Log to file". You are prompted for a filename:

Error creating thumbnail: Unable to save thumbnail to destination

If you use symbols in the filename,"%d%%m%%y%HFS.log" for example, the resultant log file is named something like this: 28102006HFS.log.

Log what

Time
Show time in every entry, in hh:mm:ss format, eg."18:51:34".
Date
Show date at the start of every entry, in dd:mm:yyyy format, eg. "20/10/2006".
Browsing
Log every time a user requests the file list. Log entry example, "Requested GET /Downloads/~files.lst".
Icons
Log the getting of file icons. Log entry example, "Requested GET /favicon.ico".
Progress
Log the getting of progress page.
Banned
Log the banning of users.
Only served events
xxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Other events
This includes, for example, dynamic DNS updates.
Connections
Log every new connection.
Disconnections
Log all closing of connections.
Requests
Log requests made by the browser for downloads and uploads. A typical entry is: "Requested GET /Downloads/<filename>". The file extension is not normally shown.
Requests dump
Show a full request dump for every request. These log entries can be very long. Here, for example, is the entry for a small download request:
> Host: localhost
Accept: text/html, application/xml;q=0.9, application/xhtml+xml, image/png, image/jpeg, image/gif, image/x-xbitmap, */*;q=0.1
Accept-Language: en-GB,en;q=0.9
Accept-Charset: iso-8859-1, utf-8, utf-16, *;q=0.1
Referer: xxxxxxx/Downloads/
Connection: Keep-Alive, TE
TE: deflate, gzip, chunked, identity, trailers
Fully downloaded - 531 B @ 8 KB/s
Replies
Log what HFS answered (eg. what it served).
Full downloads
Log completed downloads. Log entry example, "Fully downloaded - 558,531 B @ 48 KB/s".
Uploads
Log uploads.
Bytes received
After each request, log how many bytes HFS received from the browser.
Bytes sent
After each request, log how many bytes HFS sent to the browser.
Server start
Log starting of HFS. The log message is, "Server start".
Server stop
Log stopping of HFS. The log message is, "Server stop".

Main items

Log to screen
Writes the log to this window. If this is unchecked, nothing is written to the window and no log is kept unless you have turned on "Log to file".
Log to file
Writes the log to a file. When you click this, you are prompted to specify the name of the log file.
Do not log address
Exclude specified IPs. More about IP masks
Address 2 name
Opens the translation table for IP addresses to names. These names are shown in the log in {}-brackets after the real IP. This is useful if you have users with a fixed IP (for example, in a LAN) and want to show their names.
Font
Lets you choose the font for the log. The usual Windows dialog box is displayed so you can also choose the text size, style, etc.
Read only
Prevents editing of the log. Normally, leave this checked.
Copy
Copies the whole log, or a selected part, to the clipboard. This is obviously useful when you want to paste log entries into an email or other document.
Clear
Deletes all entries in the log window.
Save
Saves the log to the file specified in 'Log on file'.
Save as
Saves the log and prompts you for the file name.
Addresses Ever Connected...
Displays a list of all the unique ip addresses that have ever connected.