追踪与监控

适用场景

• 需要查看某次 agent 运行的输入、输出、工具调用和延迟，定位错误或慢的步骤。

• 需要在上线后看到 token 消耗、延迟、运行成功率等运行指标。

• 需要对生产流量做持续评测，并在 Foundry 中看到评测分数趋势。

前提

步骤

1. 连接 Application Insights：在 Foundry（new）门户打开项目，进入 Agents 页面的 Traces 标签，选择 Connect；也可在 Manage > Project details > Connected resources 中添加 Application Insights 连接。

2. 选择插桩方式：

• 服务端追踪（推荐起点）：连接后自动启用，不需改代码，适用于 Foundry 中托管的 agent。

• 客户端追踪：在自有应用中安装 OpenTelemetry 与 Azure SDK 追踪插件，并在创建项目客户端之前开启 GenAI 追踪。C# 示例需要设置运行时开关，属于实验性功能，待核实。

• VS Code 本地追踪：通过本地 OTLP 兼容收集器接收 span，适合开发调试，不需要 Application Insights。

1. 运行 agent 至少一次（门户或应用中均可）。

2. 在 Traces 中确认出现新 trace，并逐个 span 查看输入、输出和工具调用。

3. 查看监控仪表板：在 Build 中选择 agent，打开 Monitor 标签，查看运行指标与评测图表。

4. 如需持续评测：在 Monitor 设置中创建循环评测（定期或持续采样），或用 SDK 创建评测与评测规则。若用 SDK 配置持续评测，需要给项目的托管身份分配 Foundry User 角色（页面说明）。

参数表

验证

• Traces 列表中出现与刚才运行对应的新记录，并显示时间、耗时与状态。

• Monitor 标签中运行指标与评测图表在所选时间范围内有数据。

• 持续评测规则为启用状态，评测运行列表中的状态为已完成（Completed）。

排错

限制与待核实

• trace 可能包含用户输入、模型输出与工具参数，应视为生产遥测，套用相同的访问控制与保留策略。

• 追踪的 GA 状态：页面称 prompt agent 与 hosted agent 已正式可用，workflow 与外部 agent 为预览（待核实）。

• 仪表板的“定期评测”“红队扫描”“告警”标注为预览，功能与配额待核实。

• 自定义 agent 若在 Foundry 外运行，需先注册到控制平面，再将 trace 发送到同一个 Application Insights 实例，具体步骤未读取，待核实。

来源与核对

• sources：见页头 sources 列表（追踪设置页、监控仪表板页、追踪概念页、观测概念页）。

• read_scope：正文已读。以上四页正文已通读；页面中引用的角色说明与 SDK 示例仅记录要点，未逐一核对。