Audit Logs

Search and download organization audit logs from the CLI.

`kernel audit-logs search`

Search audit logs within a time window. Results are ordered newest first.

kernel audit-logs search \
  --start 2026-06-01 \
  --end 2026-06-08 \
  --search /browsers \
  --limit 500 \
  --output json

If you omit the time flags, the command searches from 24 hours ago through now. The start is inclusive and the end is exclusive. Each time window can cover up to 30 days.

Flag	Description
`--start <time>`	Inclusive start, as RFC 3339 or `YYYY-MM-DD`. Defaults to 24 hours ago.
`--end <time>`	Exclusive end, as RFC 3339 or `YYYY-MM-DD`. Defaults to now.
`--search <text>`	Search path, user ID, email, client IP, and status.
`--method <method>`	Return one HTTP method. Passing any method disables the default GET exclusion.
`--exclude-method <method>`	Exclude an HTTP method in addition to the default GET exclusion.
`--include-get`	Include GET requests, which are excluded by default.
`--service <service>`	Filter by service.
`--auth-strategy <strategy>`	Filter by authentication strategy.
`--user-id <id>`	Add a user ID to the search. Repeat the flag for multiple IDs.
`--limit <n>`	Maximum total number of results. Defaults to `100`.
`--output json`, `-o json`	Output raw JSON array.

--limit controls the total number of CLI results. The CLI automatically requests API pages of up to 100 records until it reaches that limit or runs out of results.

Include GET requests

GET requests are excluded by default to reduce noise:

# Include GET alongside every other method
kernel audit-logs search --include-get

# Return only GET requests
kernel audit-logs search --method GET

`kernel audit-logs download`

Download matching audit logs in a time window as one gzip-compressed JSONL file.

kernel audit-logs download \
  --start 2026-06-01 \
  --end 2026-07-01 \
  --to audit-june.jsonl.gz

--start and --end are required. The start is inclusive and the end is exclusive, and the time window can cover up to 30 days.

Flag	Description
`--start <time>`	Inclusive start, as RFC 3339 or `YYYY-MM-DD`. Required.
`--end <time>`	Exclusive end, as RFC 3339 or `YYYY-MM-DD`. Required.
`--search <text>`	Search path, user ID, email, client IP, and status.
`--method <method>`	Return one HTTP method. Passing any method disables the default GET exclusion.
`--exclude-method <method>`	Exclude an HTTP method in addition to the default GET exclusion.
`--include-get`	Include GET requests, which are excluded by default.
`--service <service>`	Filter by service.
`--auth-strategy <strategy>`	Filter by authentication strategy.
`--user-id <id>`	Add a user ID to the search. Repeat the flag for multiple IDs.
`--to <path>`	Output `.jsonl.gz` path. For the example above, the default is `audit-logs-20260601-20260701.jsonl.gz`.
`--force`	Replace an existing output file.

Date-only values represent midnight UTC. For example, --start 2026-06-01 --end 2026-07-01 covers all of June in UTC.

Download behavior

The command downloads up to 50,000 records at a time and appends each chunk to <output>.partial. Before writing a chunk, it verifies the SHA-256 checksum returned by the API. A chunk is attempted up to seven times when a network error, HTTP 429, HTTP 5xx, truncated response, or checksum mismatch occurs. Retries use exponential backoff capped at eight seconds. The CLI renames the temporary file to the requested output only after every chunk transfers successfully. If a transfer fails, it removes the incomplete temporary file. If the final rename fails, the completed download remains at <output>.partial. Downloads don’t resume across CLI runs; rerunning the command starts again from the beginning. The command refuses to replace an existing output unless you pass --force.

Aliases

You can also use kernel audit-log, kernel auditlogs, or kernel auditlog.

Getting Started

Commands

`kernel audit-logs search`

Include GET requests

`kernel audit-logs download`

Download behavior

Aliases

​kernel audit-logs search

​Include GET requests

​kernel audit-logs download

​Download behavior

​Aliases

`kernel audit-logs search`

Include GET requests

`kernel audit-logs download`

Download behavior

Aliases