SourceForge.net Logo
January 10, 2007
© GPL
 
ProWikiCenter
Log File
 
Difference (previous author) (Change, Edit, normal page display)

Changed: 1c1,29
Describe the new page here.
The LogFile logs all wiki requests. It is a monthly file, named <n>"log YYMM"</n> (e.g. <n>log 0609</n> for the September 2006), located in the DataDir directory.

=== Structure of the LogFile ===

The LogFile is a text file delimited using the "|" character. It has field names inline to allow for structural changes.

[[table]
field name | example content | meaning
ACTION | <n>somepath/wiki.cgi?edit=FrontPage</n> | the incoming request
STAMP | 4. Januar 2007 1:22 | date and time stamp of the request
HOST | 123.23.45.6#111 | the IP address and preferences cookie number of the requesting computer, #111 is a special number signifying that no cookie exists.
USER | <n>TestUser</n> | formal login username (may be empty)
NAME | <n>MyName</n> | informal preferences username (may be empty)
UT | 0.250 | Unix user time needed for answering the request
ST | 0.030 | Unix system time needed for answering the request
TS | 1167866576 | the unix time in seconds, corresponding to STAMP (epoche time)
]

When reading the LogFile using external programs, no specific order of the fields should be assumed.
=== Archiving and Deleting ===

LogFiles are needed to create statistics. They can get quite large and are therefore archived or deleted sooner or later. When deleting them, keep in mind the more recent files are often used to create statistics (e. g. Command/ActionStat or CdmlHotspots). Usually it's ok to archive and delete LogFiles older than 2 months.

=== See also ===

The changes to the wiki are logged additionally in the RcLogFile. This is for quicker generation of the RecentChanges display.



FolderFiles

The LogFile logs all wiki requests. It is a monthly file, named "log_YYMM" (e.g. log_0609 for the September 2006), located in the DataDir directory.

Structure of the LogFile

The LogFile is a text file delimited using the "|" character. It has field names inline to allow for structural changes.

field nameexample contentmeaning
ACTIONsomepath/wiki.cgi?edit=FrontPagethe incoming request
STAMP4. Januar 2007 1:22date and time stamp of the request
HOST123.23.45.6#111the IP address and preferences cookie number of the requesting computer, #111 is a special number signifying that no cookie exists.
USERTestUserformal login username (may be empty)
NAMEMyNameinformal preferences username (may be empty)
UT0.250Unix user time needed for answering the request
ST0.030Unix system time needed for answering the request
TS1167866576the unix time in seconds, corresponding to STAMP (epoche time)

When reading the LogFile using external programs, no specific order of the fields should be assumed.

Archiving and Deleting

LogFiles are needed to create statistics. They can get quite large and are therefore archived or deleted sooner or later. When deleting them, keep in mind the more recent files are often used to create statistics (e. g. Command/ActionStat or CdmlHotspots). Usually it's ok to archive and delete LogFiles older than 2 months.

See also

The changes to the wiki are logged additionally in the RcLogFile. This is for quicker generation of the RecentChanges display.


FolderFiles