File Logging

Learn how to save logs to files in Logixlysia.

Save your logs to files for persistence and analysis using Logixlysia's file logging system.

Basic Usage

logixlysia({
  config: {
    logFilePath: './logs/app.log'
  }
})

Configuration Options

OptionTypeDescriptionDefault
logFilePathstringPath to the log file'./logs/elysia.log'

Multiple Log Files

Create separate log files for different purposes:

logixlysia({
  config: {
    logFilePath: {
      error: './logs/error.log',
      access: './logs/access.log',
      debug: './logs/debug.log'
    }
  }
})

File Format

Logs are written in a structured format:

🦊 2025-04-13 15:00:19.225 INFO  123.45ms GET /api/users 200 
🦊 2025-04-13 15:00:20.225 ERROR 234.56ms POST /api/users 500 Error creating user

Best Practices

  1. File Organization

    • Use descriptive file names
    • Organize logs by type/level
    • Consider using date-based directories
  2. Performance

    • Use async file writing
    • Consider buffering for high-volume logs
    • Monitor disk space usage
  3. Security

    • Set appropriate file permissions
    • Avoid logging sensitive data
    • Regular log review and cleanup

Example Configurations

Production Configuration

logixlysia({
  config: {
    logFilePath: './logs/production.log'
  }
})

Development Configuration

logixlysia({
  config: {
    logFilePath: './logs/development.log'
  }
})

On this page