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