用途：系统化诊断并修复 Netra SDK 集成中的常见失败，包括初始化、模块导入、追踪（traces）和指标（metrics）问题。
主要能力：列出常见问题，如 netra 的 ModuleNotFoundError、Presidio 或提示注入扫描器缺少 extras、Netra.init() 被多次调用、仪表盘看不到 traces 或 metrics、异步或流式流程未按预期出现。提供分诊流程：确认包安装与 Python 版本兼容性；确认一次性初始化发生在 provider 导入之前；核对 API key/header 与 OTLP endpoint 配置；确认启用的 instruments 与运行时库匹配；确认网络出口与 collector 兼容性；确认 shutdown flush 路径以输出最终遥测。
使用方式：快速修复命令包括 pip install netra-sdk、pip install 'netra-sdk[presidio]'、pip install 'netra-sdk[llm_guard]'、npm install netra-sdk。TypeScript 初始化检查示例：import { Netra } from "netra-sdk"; await Netra.init({ appName: "my-app", headers: x-api-key=${process.env.NETRA_API_KEY} }); await Netra.shutdown(); 调试清单：启动后 Netra.is_initialized() 返回 True；为环境策略配置 trace_content；在需要处用 enable_metrics=True 启用指标；配置导出间隔与 shutdown flush；避免跨 worker 进程重复初始化。
适用场景：使用 Netra SDK 进行追踪与指标集成时遇到上述故障的开发者。
限制：资料未提供具体版本要求、错误码含义、平台支持范围及收费信息，需参考官方文档。