Skip to main content

Logs

Aggregate Logs

Return severity counts grouped by time buckets at a configurable grain (auto, minute, hour, day).

List Facets

Return the facet hierarchy: attribute families (native, attribute, resource, scope) with their keys, counts, and top values for the requested time range.

List Facet Values

Return distinct values with occurrence counts for a given facet field.

List Fields

Return all queryable fields: static columns and dynamic attribute families (attribute., resource.).

Find Patterns

Find stable templates in a bounded sample of matching log bodies. The response reports sampling and truncation metadata and never returns an unbounded list of raw bodies.

Query Logs

Run an OQL log query using the pipeline grammar fetch logs | filter <expr> | sort timestamp desc | limit N. The query is compiled onto the same engine as SearchLogs; timestamp desc is the only supported sort.

Search Logs

Query log records with filters, free-text search, and keyset pagination. Results are ordered timestamp desc (the only supported sort, mirroring traces).

Retrieve a Log

Retrieve a log record by its ULID. Returns 404 if the record does not exist or belongs to another workspace.

Get Log Context

Retrieve the matching log records immediately before and after an anchor log. Neighbors use the same free-text and structured filter dialect as SearchLogs and are returned in chronological order.

List Trace Logs

Return all log records correlated with a given trace_id. Results are scoped to the authenticated workspace.