主线程调度器
C# SDK 提供主线程调度器抽象,用于在特定执行上下文中处理回调。
建议
Enqueue()可从任意线程调用ProcessQueue()只在受控主循环中调用- 不要在回调里执行长时间阻塞任务
入站并发与背压
入站请求(Agent→SDK 的 Invoke 等)由有界 worker 池处理: 读循环只投递不执行业务(串行处理会让一个慢 handler 卡住整条连接)。
- 默认 worker 数 ≈ CPU 核数;待处理队列容量 ≈
workers × 4(突发吸收 4 轮满载) - 业务队列打满时立即回 busy 错误帧(
inbound queue full, retry on another instance),Agent 侧 failover 换实例重试——SDK 内存不积累 - 调优入口在 transport 层配置(Go:
InboundWorkers/InboundQLen; 其他语言见各自配置章节),语义六语言一致
控制消息(心跳/注册/drain)的双车道隔离目前仅 Go 落地:控制请求走 专用队列永不 reject,业务洪峰时会话仍存活(protocol.IsControlRequest() 分类)。其余语言心跳与业务共用车道,待按 Go 基准迁移。
