MainSDK
Search⌘K
Docs

Diagnostics channels

Every channel MainSDK publishes on node:diagnostics_channel, with its kind, version and publisher, and how a channel changes between versions.

Updated 2026-10-28

Every channel below is published at version 1 under the name mainsdk:<area>.<event>. Subscribe with observe; read a payload shape with observe.schema(name). A channel is never changed in place: a new shape ships as @2 beside @1, and both publish for one minor release.

ChannelKindVersionPublished by
mainsdk:network.decisionevent1network
mainsdk:network.attemptevent1network
mainsdk:network.breakerevent1network
mainsdk:permission.decisionevent1disk, system
mainsdk:access.decisionevent1access
mainsdk:agent.decisionevent1agents
mainsdk:ai.callevent1ai
mainsdk:action.callevent1action
mainsdk:mcp.callevent1mcp
mainsdk:files.uploadevent1files
mainsdk:files.accessevent1files
mainsdk:pay.callevent1pay
mainsdk:share.createevent1share
mainsdk:config.pushevent1config
mainsdk:tenant.systemevent1tenant
mainsdk:device.telemetryevent1device
mainsdk:http.fetchspan1network
mainsdk:driver.callspan1every interface
mainsdk:action.runspan1action
mainsdk:system.runspan1system

Events carry the common envelope (id, time, app, tenant, user, trace and span ids, caller, data). Spans add a start and an end phase. Fields listed as detail appear only while debug detail is on.

Was this page helpful?

↑↓ moveEnter openEsc close

Not decided yet