Skip to content

dt log

Overview

This command reads logging output. You can read the log of other processes. You can either read stderr or stdout. Admins can search audit events; anyone with job read can view a job's platform events.

Synopsis

dt log SUBCOMMAND [OPTIONS] [ARGUMENTS]

Available Subcommands

  • log read - Read log files
  • log system - Collect recent system logs into a gzipped archive for inspection
  • log extract - Extract logs by query string through log-server service. Filter on body, containername, severity, service_name, service_namespace, span_id, trace_id or _timestamp. Equality is case-sensitive: severity values are upper-case (ERROR, WARN, INFO, DEBUG). Defaults to the last 15 minutes when starttime is omitted.
  • log audit - Search audit events (admin only). Stream selection is server-side. Defaults to the last 24 hours when starttime is omitted, up to 366 days. --user and --resource match substrings, case-insensitively, unless --match exact is given. Pass --with-events with --trace-id to include the system events of the same trace from the default stream. Text output shows user, source, action, resource and outcome with UTC timestamps; --json returns every field.
  • log events - Read platform lifecycle events for a job you can read: the latest run's by default, a run's with -i, or with --job-level the job's own, such as its image builds per version, which is also what a job with no run yet shows (a job whose first build failed, for example). Admins can pass --all to search those events across jobs, including names that were never created; with --all, -e narrows the search to one or more comma-separated environments, system meaning events about no job. --resource matches substrings, case-insensitively, unless --match exact is given. Raw service logs are not returned; they stay in OpenObserve. Follow a trace with --trace-id: a user request's from the traceresponse header, a run's from its scheduler.run_created event; use dt log audit -T --with-events to include the audit row in the same call. Timestamps in text output are UTC.

SEE ALSO

← Back to dt