Skip to content

dt log extract

Overview

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.

Synopsis

dt log extract [OPTIONS] <query> 

Options

  • -j, --json
    Display results in json

  • -p, --pretty
    Pretty print results

  • -s, --sort=<sort>
    Sort expression: +field for ASC, -field for DESC

  • -b, --batch-size=<batch-size>
    Retrieve up to batch-size results (default 100)

  • -o, --offset=<offset>
    Skip first offset rows (default 0)

  • -S, --starttime=<starttime>
    Optional query start time (microseconds since epoch or YYYY-MM-DDTHH:MM:SSZ)

  • -E, --endtime=<endtime>
    Optional query end time (microseconds since epoch or YYYY-MM-DDTHH:MM:SSZ); defaults to now

Arguments

  • query (required)
    Type: String
    Filter expression, same grammar as job ls -f

Examples

Find logs whose body contains a word

dt log extract "body contains error"

Sort and paginate extractor query results

dt log extract -s "-_timestamp" -b 200 -o 0 "containername = 'node'"

Query logs up to a specific end time (last 15 minutes window)

dt log extract --endtime 2026-07-30T12:45:00Z "severity = ERROR"

Query logs for an explicit time range

dt log extract --starttime 2026-07-30T12:30:00Z --endtime 2026-07-30T12:45:00Z "containername = 'controller'"

SEE ALSO

← Back to dt log