iii / worker
$worker

iii-observability

v0.11.6-next.3

OpenTelemetry-based traces, metrics, logs, alerts, and sampling.

engine module
baked into the iii engine; no separate install required.

functions

19

engine::alerts::evaluate

function

Manually trigger alert evaluation

request
empty object
response
valueunknown

engine::alerts::list

function

List current alert states

request
empty object
response
valueunknown

engine::baggage::get

function

Get a baggage item value from the current context

request
  • keystringrequired

    The baggage key to retrieve

response
valueunknown

engine::baggage::get_all

function

Get all baggage items from the current context

request
empty object
response
valueunknown

engine::baggage::set

function

Set a baggage item value (returns new context, does not modify global)

request
  • keystringrequired

    The baggage key to set

  • valuestringrequired

    The baggage value to set

response
valueunknown

engine::health::check

function

Check system health status

request
empty object
response
valueunknown

engine::log::debug

function

Log a debug message using OTEL

request
  • dataunknown

    Additional structured data/attributes

  • messagestringrequired

    The log message

  • service_namestring

    Service name (defaults to function name if not provided)

  • span_idstring

    Optional span ID for correlation

  • trace_idstring

    Optional trace ID for correlation

response
valueunknown

engine::log::error

function

Log an error message using OTEL

request
  • dataunknown

    Additional structured data/attributes

  • messagestringrequired

    The log message

  • service_namestring

    Service name (defaults to function name if not provided)

  • span_idstring

    Optional span ID for correlation

  • trace_idstring

    Optional trace ID for correlation

response
valueunknown

engine::log::info

function

Log an info message using OTEL

request
  • dataunknown

    Additional structured data/attributes

  • messagestringrequired

    The log message

  • service_namestring

    Service name (defaults to function name if not provided)

  • span_idstring

    Optional span ID for correlation

  • trace_idstring

    Optional trace ID for correlation

response
valueunknown

engine::log::trace

function

Log a trace-level message using OTEL

request
  • dataunknown

    Additional structured data/attributes

  • messagestringrequired

    The log message

  • service_namestring

    Service name (defaults to function name if not provided)

  • span_idstring

    Optional span ID for correlation

  • trace_idstring

    Optional trace ID for correlation

response
valueunknown

engine::log::warn

function

Log a warning message using OTEL

request
  • dataunknown

    Additional structured data/attributes

  • messagestringrequired

    The log message

  • service_namestring

    Service name (defaults to function name if not provided)

  • span_idstring

    Optional span ID for correlation

  • trace_idstring

    Optional trace ID for correlation

response
valueunknown

engine::logs::clear

function

Clear all stored OTEL logs

request
empty object
response
valueunknown

engine::logs::list

function

List stored OTEL logs

request
  • end_timeinteger· uint64min 0

    End time in Unix timestamp milliseconds

  • limitinteger· uintmin 0

    Maximum number of logs to return

  • offsetinteger· uintmin 0

    Pagination offset (default: 0)

  • severity_mininteger· int32

    Minimum severity number (1-24, higher = more severe)

  • severity_textstring

    Filter by severity text (e.g., "ERROR", "WARN", "INFO")

  • span_idstring

    Filter by span ID

  • start_timeinteger· uint64min 0

    Start time in Unix timestamp milliseconds

  • trace_idstring

    Filter by trace ID

response
valueunknown

engine::metrics::list

function

List current metrics values

request
  • aggregate_intervalinteger· uint64min 0

    Aggregate interval in seconds

  • end_timeinteger· uint64min 0

    End time in Unix timestamp milliseconds

  • metric_namestring

    Filter by metric name

  • start_timeinteger· uint64min 0

    Start time in Unix timestamp milliseconds

response
valueunknown

engine::rollups::list

function

Get pre-aggregated metrics rollups

request
  • end_timeinteger· uint64min 0

    End time in Unix timestamp milliseconds

  • levelinteger· uintmin 0

    Rollup level index (0 = 1 min, 1 = 5 min, 2 = 1 hour)

  • metric_namestring

    Filter by metric name

  • start_timeinteger· uint64min 0

    Start time in Unix timestamp milliseconds

response
valueunknown

engine::sampling::rules

function

Get active sampling rules configuration

request
empty object
response
valueunknown

engine::traces::clear

function

Clear all stored traces (only available when exporter is 'memory' or 'both')

request
empty object
response
valueunknown

engine::traces::list

function

List stored traces (only available when exporter is 'memory' or 'both')

request
  • attributesstring[][]

    Filter by span attributes (array of [key, value] pairs, AND logic, exact match)

  • end_timeinteger· uint64min 0

    End time in unix timestamp milliseconds (include spans overlapping before this)

  • include_internalboolean

    Include internal engine traces (engine.* functions). Defaults to false.

  • limitinteger· uintmin 0

    Pagination limit (default: 100)

  • max_duration_msnumber· double

    Maximum span duration in milliseconds (sub-ms precision)

  • min_duration_msnumber· double

    Minimum span duration in milliseconds (sub-ms precision)

  • namestring

    Filter by span name (case-insensitive substring match)

  • offsetinteger· uintmin 0

    Pagination offset (default: 0)

  • search_all_spansboolean

    Search across all spans in each trace, not just root spans. When true and a `name` filter is set, traces are matched if ANY span in the trace matches the name filter. Defaults to false.

  • service_namestring

    Filter by service name (case-insensitive substring match)

  • sort_bystring

    Sort field: "duration" | "start_time" | "name" (default: "start_time")

  • sort_orderstring

    Sort order: "asc" | "desc" (default: "asc")

  • start_timeinteger· uint64min 0

    Start time in unix timestamp milliseconds (include spans overlapping after this)

  • statusstring

    Filter by status (case-insensitive substring match)

  • trace_idstring

    Filter by specific trace ID

response
valueunknown

engine::traces::tree

function

Get trace tree with nested children (only available when exporter is 'memory' or 'both')

request
  • trace_idstringrequired

    Trace ID to build the tree for

response
valueunknown

triggers

1

log

trigger

Log event trigger

invocation
  • levelany of

    Minimum log level to trigger on

    any of (2)
    variant 1
    valueunknown
    variant 2
    valuenull
return
  • attributesunknownrequired

    Log attributes

  • bodystringrequired

    Log message body

  • instrumentation_scope_namestringrequired

    Instrumentation scope name

  • instrumentation_scope_versionstringrequired

    Instrumentation scope version

  • observed_timestamp_unix_nanointeger· uint64requiredmin 0

    Observed timestamp in nanoseconds

  • resourceunknownrequired

    OpenTelemetry resource

  • service_namestringrequired

    Service name

  • severity_numberinteger· uint32requiredmin 0

    Severity number (OpenTelemetry)

  • severity_textstringrequired

    Severity text (e.g. INFO, ERROR)

  • span_idstringrequired

    Span ID

  • timestamp_unix_nanointeger· uint64requiredmin 0

    Log timestamp in nanoseconds

  • trace_idstringrequired

    Trace ID