tower_logging.yml

---
- Environment variable: "`TOWER_CRON_AUDIT_LOG_CLEAN_UP_ENABLED`"
  Description: >
    Set `false` to disable automatic deletion of audit log records. In 26.1, this applies to both the legacy `tw_audit_log` table and the new `tw_audit_log_v2` table. Restart Platform after changing this value.
  Value: "Default: `true`"
- Environment variable: "`TOWER_CRON_AUDIT_LOG_CLEAN_UP_TIME_OFFSET`"
  Description: >
    Application event audit log retention period. When cleanup is enabled, audit log records older than this period are deleted from both v1 and v2 audit log tables. Value includes units (`30d`, `24h`, `60m`, etc.).
  Value: "Default: `365d`"
- Environment variable: "`TOWER_AUDIT_LOG_V2_WRITE_MODE`"
  Description: >
    Determines which audit log tables receive new write operations. Use `v1` for the legacy table only, `dual` to write to both legacy and v2 tables during the 26.1 migration period, or `v2` for the new table only.
  Value: "Options: `v1`, `dual`, `v2`. Default: `dual`"
- Environment variable: "`TOWER_AUDIT_LOG_V2_CSV_EXPORT_MAX_LOGS`"
  Description: >
    Maximum number of audit log v2 records allowed in a single CSV export.
  Value: "Default: `500000`"
- Environment variable: "`TOWER_LOG_APPENDER`"
  Description: >
    The output format of Platform logs.
  Value: "Options: `STDOUT`, `JSON`"
- Environment variable: "`TOWER_LOG_LEVEL`"
  Description: >
    Platform backend logging detail level.
  Value: "Options: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`"
- Environment variable: "`TOWER_SECURITY_LOGLEVEL`"
  Description: >
    Platform authentication logging detail level.
  Value: "Options: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`"
- Environment variable: "`TOWER_LOG_DIR`"
  Description: >
    Base directory to store Platform logs.
  Value:
- Environment variable: "`TOWER_LOG_PATTERN`"
  Description: >
    The logging format emitted to STDOUT. See [here](https://logback.qos.ch/manual/layouts.html#conversionWord) for a reference of the full logback pattern syntax.
  Value: "`%d{MMM-dd HH:mm:ss.SSS} [%t] %X{ip:--} %-5level %logger{36} - %msg%n}  # Default logging pattern shown`"
- Environment variable: "`TOWER_LOG_MAX_HISTORY`"
  Description: >
    The maximum number of backend log files retained by the system.
  Value:
- Environment variable: "`TOWER_LOG_MAX_SIZE`"
  Description: >
    The maximum file size of the Platform backend log file. When this limit is reached, a new log file is created.
  Value:
- Environment variable: "`LOGGER_LEVELS_IO_SEQERA_TOWER_AGENT`"
  Description: >
    Tower Agent logging detail level.
  Value: "Options: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`"
- Environment variable: "`TOWER_AGENT_HEARTBEAT`"
  Description: >
    Tower Agent polling interval.
  Value: "Example: `10s`"
- Environment variable: "`TOWER_SSH_LOGLEVEL`"
  Description: >
    Event logging detail level for the SSH connection library used by Seqera.
  Value: "Options: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`"
- Environment variable: "`TOWER_ALLOW_NEXTFLOW_LOGS`"
  Description: >
    Set `true` to allow Seqera to retrieve logs and reports for runs launched with Nextflow CLI.
  Value: "Default: `false`"