Thread: New logging working

By default it will put logs in the directory "<game path>\logs\lonestar". If that directory doesn't exist, it will be automatically created. So for instance on my computer it's putting the logs at "C:\Valve\HLServer\orangebox\tf\logs\lonestar"

It supports dumping the same log information into the server log, but it's turned off by default.

Log entries can be forwarded to a specific player's console (useful for debugging, you need the highest admin rights in order to use this feature).

Logs are always printed to the server console in addition to anywhere else they may go.

Log file names are in the format "lonestar_MMDD###.log". Where MM is the month, DD is the day, and ### is a number that makes sure this log is a unique log name for the day.
Examples:
lonestar_0326000.log (first log the day)
lonestar_0326001.log (second log the day)
lonestar_0326002.log (third log the day)

Log's will rotate every map change.

When log messages are printed to the server console, player console, or put in the normal server log, they have a "[LoneStar]" prefix so they are easier to find

Server console example

Code:

meta load ls
[LoneStar]: LoneStar is now fully up and running
[LoneStar] INFO: LoneStar log file opened (file "C:\Valve\HLServer\orangebox\tf\logs\lonestar\lonestar_0325005.log")
Plugin "LoneStar" loaded with id 4.
Client "« ?£? » Ewok" connected (172.16.1.33:27006).
[LoneStar] DEBUG: Made real player '« ?£? » Ewok' at index 1 with steamId 'STEAM_ID_PENDING', at addr 172.16.1.33:27006
[LoneStar] DEBUG: Adding player for pending id: « ?£? » Ewok
[LoneStar] DEBUG: Found a (deferred) admin account for player « ?£? » Ewok
[LoneStar] DEBUG: Player finally has a valid steam id: « ?£? » Ewok
[LoneStar] INFO: Admin '« ?£? » Ewok' <STEAM_0:0:16511154> kicked player '« ?£? » Ewok' <STEAM_0:0:16511154>
Dropped « ?£? » Ewok from server (Kicked by Console : For not being a teamplayer)
Client "« ?£? » Ewok" connected (172.16.1.33:27006).
[LoneStar] DEBUG: Made real player '« ?£? » Ewok' at index 1 with steamId 'STEAM_ID_PENDING', at addr 172.16.1.33:27006
[LoneStar] DEBUG: Adding player for pending id: « ?£? » Ewok
[LoneStar] DEBUG: Found a (deferred) admin account for player « ?£? » Ewok
[LoneStar] DEBUG: Player finally has a valid steam id: « ?£? » Ewok
meta unload ls
[LoneStar] INFO: LoneStar log file closed
[LoneStar]: LoneStar is now completely shutdown
Plugin 4 unloaded.

When log messages are written to the lonestar log, they don't have the "[LoneStar]" prefix, but instead they have a timestamp prefix that looks like "03/26/2008 - 00:03:45:"

Log file example of the same time period as the above server console dump

Code:

03/25/2008 - 23:52:16: [INFO] LoneStar log file opened (file "C:\Valve\HLServer\orangebox\tf\logs\lonestar\lonestar_0325005.log")
03/25/2008 - 23:56:50: [DEBUG] Made real player '« ?£? » Ewok' at index 1 with steamId 'STEAM_ID_PENDING', at addr 172.16.1.33:27006
03/25/2008 - 23:56:50: [DEBUG] Adding player for pending id: « ?£? » Ewok
03/25/2008 - 23:56:55: [DEBUG] Found a (deferred) admin account for player « ?£? » Ewok
03/25/2008 - 23:56:55: [DEBUG] Player finally has a valid steam id: « ?£? » Ewok
03/26/2008 - 00:02:55: [INFO] Admin '« ?£? » Ewok' <STEAM_0:0:16511154> kicked player '« ?£? » Ewok' <STEAM_0:0:16511154>
03/26/2008 - 00:03:03: [DEBUG] Made real player '« ?£? » Ewok' at index 1 with steamId 'STEAM_ID_PENDING', at addr 172.16.1.33:27006
03/26/2008 - 00:03:03: [DEBUG] Adding player for pending id: « ?£? » Ewok
03/26/2008 - 00:03:08: [DEBUG] Found a (deferred) admin account for player « ?£? » Ewok
03/26/2008 - 00:03:08: [DEBUG] Player finally has a valid steam id: « ?£? » Ewok
03/26/2008 - 00:03:45: [INFO] LoneStar log file closed

As you might have noticed, all log messages will generally have a category before the actual message itself. The purpose of this is to help admins find or filter out different types of messages, like errors, warnings, or debug messages.

Categories right now are: ERROR, WARNING, INFO, CHAT, DEBUG


When an admin uses a power, the log entries for using them will generally look like this line (from the above log)

Code:

03/26/2008 - 00:02:55: [INFO] Admin '« ?£? » Ewok' <STEAM_0:0:16511154> kicked player '« ?£? » Ewok' <STEAM_0:0:16511154>

Unless you guy have suggestions or comments, I think logging is basically done and working as we'd like it to.

Looks good.

rgr. I'll have to take a look at pyschostats to see what it needs.

I think that can be an independent TODO item and put into the "nice to have" category (i.e. we won't let that feature hold up the first release, but we'll get to it eventually).