moth/docs/logs.md

Moth Logs

Moth has multiple log channels:

points.log

the points log, used by server and scoreboard

events.log

significant events, used to do manual analysis after an event

stdout

HTTP server access

stderr

warnings and errors

points.log format

The points log is a space-separated file. Each line has four fields:

timestamp	teamID	category	points
int	string	string	int
Unix epoch	Team's unique ID	Name of category	Points awarded

Example

1602702696 2255 nocode 1
1602702705 2255 sequence 1
1602702787 2255 nocode 2
1602702831 2255 sequence 2
1602702839 9458 nocode 3
1602702896 2255 sequence 8
1602702900 9458 nocode 4
1602702913 2255 sequence 16

events.log format

The events log is a space-separated file. Each line has six fields minimum:

timestamp	event	participantID	teamID	category	points	extra...
int	string	string	string	string	int	string...
Unix epoch	Event type	Participant's (hopefully) unique ID	Team's unique ID	Name of category, if any	Points awarded, if any	Additional fields, if any

Fields after points contain extra fields associated with the event.

Event types

These may change in the future.

• init: startup of server
• disabled: points accumulation disabled
• enabled: points accumulation re-enabled
• load: puzzle load
• wrong: wrong answer submitted
• correct: correct answer submitted

Example

1602716345 init - - - - 0
1602716349 load 2255 player5 sequence 1
1602716450 load 4824 player3 sequence 1
1602716359 correct 2255 player5 sequence 1
1602716423 wrong 4824 player3 sequence 1
1602716428 correct 4824 player3 sequence 1
1602716530 correct 4824 player3 sequence 1
1602716546 abduction 4824 player3 - 0 alien FM1490

The final entry is a made-up "alien abduction" entry, since at the time of writing, we didn't have any actual events that wrote extra fields.