SuperAPI AI 工具集

agents-sdk-typescript-otel

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:为 Microsoft 365 Agents SDK 的 JavaScript/TypeScript 应用添加、配置、验证和排查 OpenTelemetry 可观测性,包括 SDK 内置遥测与本地 Aspire Dashboard。

主要能力:配置 traces、metrics、logs;使用 NodeSDK 安装全局 provider;通过 OTLP 导出到 Aspire Dashboard 或 Azure Monitor;按需添加自定义业务遥测;用 AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES 控制 SDK span 类别。

必要用法:先检查项目模块系统、包管理器、入口与现有遥测;用仓库包管理器一次性安装兼容包集,例如 npm install @opentelemetry/api @opentelemetry/api-logs @microsoft/agents-telemetry @opentelemetry/sdk-node @opentelemetry/sdk-metrics @opentelemetry/sdk-logs @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-grpc @opentelemetry/exporter-metrics-otlp-grpc @opentelemetry/exporter-logs-otlp-grpc @opentelemetry/instrumentation-http @opentelemetry/resources @opentelemetry/semantic-conventions。创建预加载插桩模块,并在应用入口前用 node --import ./dist/instrumentation.js 或 --require 预加载。OTLP 端点等通过标准环境变量配置,如 OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317、OTEL_EXPORTER_OTLP_PROTOCOL=grpc。本地 Aspire Dashboard 可运行 .\start-aspire-dashboard.ps1,访问 http://localhost:18888。

限制:不得在源码中嵌入凭据;不得默认采集消息、提示、响应、令牌、授权头、Cookie、用户或会话标识等敏感内容;自定义指标属性须低基数;不得默认开启 always-on 采样;须显式 flush 并处理关闭错误;Aspire 匿名模式仅限本地开发并绑定回环地址;遥测须记录并重新抛出应用错误。资料未提供具体收费、价格或平台支持范围。