Skip to main content
GET
read a log stream's logs

Authorizations

Authorization
string
header
required

Type "Bearer" followed by a space and token.

Headers

X-Nuon-API-Offset
string

log stream offset

Path Parameters

log_stream_id
string
required

log stream ID

Query Parameters

order
string
default:asc

sort direction

start_time
string

only return records with timestamp >= start_time (RFC3339)

end_time
string

only return records with timestamp <= end_time (RFC3339)

service_name
string[]

filter by service_name (repeatable) collectionFormat(multi)

scope_name
string[]

filter by scope_name (repeatable; e.g. oteljob, system) collectionFormat(multi)

scope_version
string[]

filter by scope_version (repeatable) collectionFormat(multi)

resource_schema_url
string[]

filter by resource_schema_url (repeatable) collectionFormat(multi)

scope_schema_url
string[]

filter by scope_schema_url (repeatable) collectionFormat(multi)

severity_text
string[]

filter by severity_text (repeatable; INFO/WARN/ERROR/...) collectionFormat(multi)

severity_number_min
integer

filter by severity_number >= N (OTEL: TRACE=1..FATAL=24)

severity_number_max
integer

filter by severity_number <= N (OTEL: TRACE=1..FATAL=24)

trace_id
string

filter by exact trace_id (dedicated CH column)

span_id
string

filter by exact span_id (dedicated CH column)

trace_flags
integer

filter by exact trace_flags (UInt8)

runner_id
string

filter by runner_id

runner_job_id
string

filter by runner_job_id (part of CH ORDER BY — efficient)

runner_group_id
string

filter by runner_group_id

runner_job_execution_id
string

filter by runner_job_execution_id

runner_job_execution_step
string

filter by runner_job_execution_step

tool
string[]

filter by log_attributes['nuon.tool'] (repeatable; e.g. helm, terraform, kubernetes_manifest, runner) collectionFormat(multi)

helm_release_name
string

filter by log_attributes['helm.release_name']

helm_chart_name
string

filter by log_attributes['helm.chart_name']

helm_chart_id
string

filter by log_attributes['helm.chart_id']

helm_namespace
string

filter by log_attributes['helm.namespace']

helm_operation
string

filter by log_attributes['helm.operation']

tf_workspace_id
string

filter by log_attributes['tf.workspace_id']

tf_operation
string

filter by log_attributes['tf.operation']

k8s_kind
string

filter by log_attributes['k8s.kind']

k8s_namespace
string

filter by log_attributes['k8s.namespace']

k8s_name
string

filter by log_attributes['k8s.name']

k8s_operation
string

filter by log_attributes['k8s.operation']

attr
string[]

generic log_attributes filter as 'key:value' (value must be non-empty; repeatable, max 16 across all attr params) collectionFormat(multi)

resource_attr
string[]

generic resource_attributes filter as 'key:value' (value must be non-empty; repeatable, max 16 across all attr params) collectionFormat(multi)

scope_attr
string[]

generic scope_attributes filter as 'key:value' (value must be non-empty; repeatable, max 16 across all attr params) collectionFormat(multi)

q
string

case-insensitive substring filter on log body

Response

OK

body
string
created_at
string
created_by_id
string
id
string
log_attributes
object
log_stream_id
string
org_id
string

internal attributes

resource_attributes
object
resource_schema_url
string
runner_group_id
string
runner_id
string
runner_job_execution_id
string
runner_job_execution_step
string
runner_job_id
string
scope_attributes
object
scope_name
string
scope_schema_url
string
scope_version
string
service_name
string
severity_number
integer
severity_text
string
span_id
string
timestamp
string

OTEL log message attributes

timestamp_date
string
timestamp_time
string
trace_flags
integer
trace_id
string
updated_at
string