Inngest · Schema

InngestTraceSpan

A single span in the trace tree of an Inngest function run. Each span corresponds to a step operation (run, sleep, waitForEvent, invoke, ai, fetch) and may have child spans for nested steps and retries.

AI AgentsAgentKitBackground JobsConnectCron JobsDev ServerDurable EndpointsDurable ExecutionEvent-DrivenInsightsOrchestrationQueuesRealtimeSelf-HostingServerlessSignalsStep FunctionsWebhooksWorkflows

Properties

Name Type Description
id string
name string
op string Step operation type for this span.
status string
started_at string
ended_at string
attempt integer
attributes object
children array
View JSON Schema on GitHub

JSON Schema

inngest-trace-span-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/inngest/main/json-schema/inngest-trace-span-schema.json",
  "title": "InngestTraceSpan",
  "description": "A single span in the trace tree of an Inngest function run. Each span corresponds to a step operation (run, sleep, waitForEvent, invoke, ai, fetch) and may have child spans for nested steps and retries.",
  "type": "object",
  "required": ["id", "name", "op", "status"],
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "op": {
      "type": "string",
      "enum": ["RUN", "SLEEP", "WAITFOREVENT", "INVOKE", "AI", "AICALL", "FETCH", "RUN_STEP"],
      "description": "Step operation type for this span."
    },
    "status": {
      "type": "string",
      "enum": ["RUNNING", "COMPLETED", "FAILED", "CANCELLED"]
    },
    "started_at": {
      "type": "string",
      "format": "date-time"
    },
    "ended_at": {
      "type": "string",
      "format": "date-time"
    },
    "attempt": {
      "type": "integer",
      "minimum": 0
    },
    "attributes": {
      "type": "object",
      "additionalProperties": true
    },
    "children": {
      "type": "array",
      "items": {
        "$ref": "#"
      }
    }
  }
}