Item10362: Logger documentation is insufficient

The documentation on the new Foswiki 1.1 logger is very insufficient.

When migrating a web site,

• What are all the file name changes?
• How does one migrate and assure contiguous logs?
• How do you ensure statistics are correct across the migration.

Started some initial docs when trying to figure out how to migrate Foswiki.org, but it's incomplete. This needs to be polished up a bit and added to the release notes.

Logging information

Foswiki 1.0.x logs to the data directory, 1.1.x logs to working/logs The format of the log files has not changed.

Foswiki 1.0.x	Foswiki 1.1.x
Current & Prior	Current Month	Prior Months
foswiki-root/data/logYYYYMM	foswiki-root/working/logs/events.log	foswiki-root/working/logs/events.YYYYMM
foswiki-root/data/warnYYYYMM	(Not sure if this file still exists - have not seen one yet)
foswiki-root/data/error.log	foswiki-root/working/logs/error.log	foswiki-root/working/logs/error.YYYYMM
foswiki-root/data/debug.txt	foswiki-root/working/logs/debug.log	foswiki-root/working/logs/debug.YYYYMM
foswiki-root/data/configurationlog.txt	foswiki-root/working/logs/configure.log	(Doesn't appear to auto roll?)

1. Copy current log from data to working/logs directory renaming to remove the YYYYMM
2. Copy older files over renaming to the new file pattern

-- GeorgeClark - 17 Feb 2011

I can't comment on the configuration log (I didn't do that one) but the others are bang on the money. A warn log will emerge if anyone ever generates a warning, but as Foswiki::Func logs warnings in the debug log, that's unlikely. But it could in theory happen - it's just another log level.

-- CrawfordCurrie - 17 Feb 2011

Commenting is disabled while not logged in