用途:为 Python 和 TypeScript 的 AI 服务首次接入 Netra SDK,完成一次性启动初始化,并按环境选择正确的 instrument。
主要能力:安装基础包与可选扩展;在应用启动时调用一次 Netra.init(...);配置认证头与环境标签;只启用应用实际使用的 instrument;注册 shutdown flush 以保证干净退出。
安装:Python 使用 pip install netra-sdk,可选 pip install 'netra-sdk[presidio]' 或 pip install 'netra-sdk[llm_guard]';TypeScript 使用 npm install netra-sdk。
用法要点:Python 从 netra 导入 Netra,从 netra.instrumentation.instruments 导入 InstrumentSet,调用 Netra.init(app_name=..., instruments={InstrumentSet.OPENAI})。TypeScript 从 netra-sdk 导入 Netra 与 NetraInstruments,await Netra.init({ appName, environment, instruments: new Set([NetraInstruments.OPENAI]) })。生产环境可读取 NETRA_APP_NAME、NETRA_API_KEY、NETRA_ENV 等环境变量,设置 headers 为 x-api-key=...,并按需设置 trace_content、enable_metrics。TypeScript 可在 SIGTERM 中 await Netra.shutdown() 后退出。
优先环境变量:NETRA_OTLP_ENDPOINT、NETRA_API_KEY。
检查清单:Netra.init() 只调用一次;必要时在 provider/框架导入前初始化;非本地环境设置 API key 头;所选 instrument 与实际运行时依赖一致。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;具体 instrument 名称与可用扩展以官方文档为准。参考文档见 https://docs.getnetra.ai/quick-start/QuickStart_Tracing、https://docs.getnetra.ai/sdk-reference/sdk/overview、https://docs.getnetra.ai/sdk-reference/sdk/typescript、https://docs.getnetra.ai/Observability/Traces/configuration/initialization、https://pypi.org/project/netra-sdk/。