dt log audit
Overview
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.
Synopsis
dt log audit [OPTIONS]
Options
-
-u,--user=<user>
Filter by username (substring, case-insensitive; see --match) -
-A,--action=<action>
Filter by audit action, one or more comma-separated, for example kv.put,kv.delete -
-r,--resource=<resource>
Filter by resource identifier (substring, case-insensitive; see --match) -
-m,--match=<match>
How --user and --resource are compared: contains (default) or exact -
-C,--category=<category>
Filter by category, one or more comma-separated: change, sensitive_read, or auth (read is never recorded) -
-O,--outcome=<outcome>
Filter by request outcome, one or more comma-separated: success, denied, or failed; with --with-events it narrows the audit rows only, the events of the trace come as they are -
-e,--environment=<environment>
Filter by job environment, one or more comma-separated: dev, pre, prod, or system for rows about no job (users, auth, settings) -
-s,--source=<source>
Filter by source: cli, gui, python, remote_cli, oidc, or registry -
-T,--trace-id=<trace-id>
Filter by trace id: the full 32-hex id from the traceresponse header, or at least its first 8 hex characters -
-w,--with-events
Also return the system events of the same trace (requires --trace-id): the build a save started and the run it created; the run's own events are in the run's trace, named by scheduler.run_created. --outcome and the other audit filters narrow the audit rows only -
-S,--starttime=<starttime>
Query start time (microseconds since epoch or YYYY-MM-DDTHH:MM:SSZ). Defaults to 24 hours before endtime -
-E,--endtime=<endtime>
Query end time (microseconds since epoch or YYYY-MM-DDTHH:MM:SSZ); defaults to now -
-o,--offset=<offset>
Skip first offset rows (default 0) -
-b,--batch-size=<batch-size>
Retrieve up to batch-size results (default 100, max 1000) -
-j,--json
Display results in json -
-p,--pretty
Pretty print results
Examples
Show recent audit events
dt log audit
Find who saved a job named pricing
dt log audit -u alice -A job.save -r pricing
Look up a single request by its trace id
dt log audit -T 4bf92f35 --starttime 2026-09-05T12:00:00Z --endtime 2026-09-05T13:00:00Z
Open a request and the platform work it caused
dt log audit -T 4bf92f35 --with-events
Changes that were refused or failed
dt log audit --category change -O denied,failed
SEE ALSO
← Back to dt log