Skip to content

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