Logs

This feature allows you to automatically reset or clear the logs generated from each station at a defined time interval. It is useful for reducing disk usage and keeping the log data manageable, especially for long-running servers.

logs: # Logs Station
  enable: false
  reset-logs:
    enable: false
    every: "12h30m"       # Time interval (e.g., 12 hours 30 minutes)
    timezone: "Asia/Bangkok" # Timezone used for log reset context

How It Works

  • When reset-logs.enable is set to true, the system will schedule a repeating task using the configured interval (every).

  • Time intervals can be defined using combinations of:

    • s for seconds

    • m for minutes

    • h for hours

    • d for days

    • mo for months (30 days)

    • y for years (365 days)

Example:

every: "1d6h45m"  # 1 day, 6 hours, and 45 minutes

How to Specify Timezone

The timezone configuration uses identifiers from the IANA Time Zone Database (also known as the TZ database). This ensures that scheduled tasks, like log resets, run according to the correct local time.

Valid Timezone Identifiers

You can find a complete list of valid time zone names here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones


1. Log Folder & File

Logs are stored in separate files based on each station. A log file is automatically created the first time a specific station is used.


Example Log File Structure

When a station is used, a log entry will be created with the following information:

  1. timestamp – The time when the log was recorded

  2. player – The name of the player

  3. item – The name of the item involved

  4. success – Whether the operation was successful (true or false)

  5. reason – The message or reason returned after using the station


Last updated