Logging properties#

All properties described in this page are defined as follows, depending on the deployment type:

  • Kubernetes: In the additionalProperties section of the the top-level coordinator and worker nodes in the values.yaml file.

  • Starburst Admin: In the files/coordinator/config.properties.j2 and files/worker/config.properties.j2 files.

log.annotation-file#

An optional properties file that contains annotations to include with each log message for TCP output or file output in JSON format, defined with log.path and log.format. This can be used to include machine-specific or environment-specific information into logs which are centrally aggregated. The annotation values can contain references to environment variables.

environment=production
host=${ENV:HOSTNAME}

log.format#

  • Type: string

  • Default value: TEXT

The file format for log records. Can be set to either TEXT or JSON. When set to JSON, the log record is formatted as a JSON object, one record per line. Any newlines in the field values, such as exception stack traces, are escaped as normal in the JSON object. This allows for capturing and indexing exceptions as singular fields in a logging search system.

log.path#

The path to the log file used by Trino. The path is relative to the data directory, configured to var/log/server.log by the launcher script as detailed in Run SEP. Alternatively, you can write logs to separate the process (typically running next to Trino as a sidecar process) via the TCP protocol by using a log path of the format tcp://host:port.

log.max-size#

The maximum file size for the general application log file.

log.max-total-size#

The maximum file size for all general application log files combined.

log.compression#

  • Type: string

  • Default value: GZIP

The compression format for rotated log files. Can be set to either GZIP or NONE. When set to NONE, compression is disabled.

http-server.log.enabled#

  • Type: boolean

  • Default value: true

Flag to enable or disable logging for the HTTP server.

http-server.log.compression.enabled#

  • Type: boolean

  • Default value: true

Flag to enable or disable compression of the log files of the HTTP server.

http-server.log.path#

  • Type: string

  • Default value: var/log/http-request.log

The path to the log file used by the HTTP server. The path is relative to the data directory, configured by the launcher script as detailed in Run SEP.

http-server.log.max-history#

The maximum number of log files for the HTTP server to use, before log rotation replaces old content.

http-server.log.max-size#

The maximum file size for the log file of the HTTP server. Defaults to unlimited, setting a data size value limits the file size to that value.