Skip to content

Engine Logging

The 10x Engine uses Log4j2 for all internal logging. This page covers log file locations and configuration.

Log File Location

The engine writes logs to a rolling file appender with OS-specific default locations.

Resolution Logic

The log path is resolved using the TENX_LOG_PATH environment variable:

1. If TENX_LOG_PATH environment variable is set → use that path
2. Otherwise, determine based on OS:
   - Linux/macOS: /var/log/tenx/
   - Windows: %AppData%\tenx\log\

The resulting log file is written to {resolved-path}tenx.log.

Configuration

The log4j2.yaml file (located in $TENX_CONFIG) defines the logging behavior:

properties:
  property:
    - name: log-path
      value: "${env:TENX_LOG_PATH:-/var/log/tenx/}"

appenders:
  rollingFile:
    - name: tenxFileAppender
      fileName:    "${log-path}tenx.log"
      filePattern: "${log-path}tenx.%d{dd-MMM}.%i.log"

Overriding the Log Location

To change where logs are written:

export TENX_LOG_PATH=/custom/log/path/

Set TENX_LOG_APPENDER to use console instead of file:

export TENX_LOG_APPENDER=tenxConsoleAppender

Trailing Slash

When setting TENX_LOG_PATH, include a trailing slash (/ on Linux, \ on Windows) as the filename tenx.log is appended directly.

Log Rotation

By default, logs rotate when they reach 10MB, keeping up to 10 archived files:

Setting Default Description
Size trigger 10MB Maximum size before rotation
Max archives 10 Number of rotated files to keep
Pattern tenx.{date}.{index}.log Archive naming convention