可易

用 Azure 开发者 CLI 监视托管智能体日志

可易团队阅读约 2 分钟

用 azd 查看托管智能体的控制台日志、实时流、系统事件和会话日志，并对照常见模式排障。

#用 Azure 开发者 CLI 监视托管智能体日志

流式传输并检查已部署的 Microsoft Foundry 托管智能体（Hosted agent）日志，用于故障排查和可观测性。你将了解如何查看控制台日志、实时流式传输、检查系统事件、按会话筛选，以及识别常见日志模式。

先决条件

查看最近的控制台日志

  • 获取最近的控制台日志：
    azd ai agent monitor

此命令从智能体上一次调用会话中获取最近的控制台日志，包括标准输出和标准错误。如果不存在会话，它会流式传输容器日志。该命令在获取到可用日志后退出。使用 --follow 可持续流式传输。

实时流式传输日志

  • 持续流式传输日志：
    azd ai agent monitor --follow

按 Ctrl+C 停止。这是调试时最有用的模式。在一个终端中运行它，同时在另一个终端中发送请求。

查看系统事件日志

  • 显示容器生命周期事件，而不是控制台输出：
    azd ai agent monitor --type system

使用系统事件日志诊断容器崩溃、重启循环和资源问题。

查看特定会话的日志

  • 把日志筛选到特定智能体会话：
    azd ai agent monitor --session-id <session-id>
  • 与 --follow 结合以实时流式传输：
    azd ai agent monitor --session-id <session-id> --follow

要查找会话 ID，请检查 azd ai agent invoke 的输出。它会为每个请求打印会话 ID。

控制日志长度

  • 显示最后 100 行：
    azd ai agent monitor --tail 100

范围是 1 到 300。默认值是 50。

监视特定智能体

  • 在多服务项目中，传入智能体名称：
    azd ai agent monitor my-agent

识别常见日志模式

模式含义动作
Listening on 0.0.0.0:8088智能体已成功启动。无需操作。
AuthenticationError智能体的 Entra 智能体身份（Entra Agent Identity）无法认证。检查基于角色的访问控制（Role-Based Access Control，RBAC）角色。
ModelNotFound模型部署名称不匹配。确认 azure.yaml 中的部署名称与 Foundry 门户一致。
ResourceNotFoundFoundry 终结点不匹配。检查 FOUNDRY_PROJECT_ENDPOINT 的值。
系统日志中的容器重启事件崩溃循环。检查代码中未处理的异常；考虑在 azure.yaml 中提高容器资源限制。
TimeoutError请求耗时过长。检查模型响应能力；在调用时增加超时。

遵循调试工作流

一次典型的调试会话如下：

  1. 在一个终端中流式传输日志：
    azd ai agent monitor --follow
  1. 在另一个终端中发送请求：
    azd ai agent invoke "Test message"
  1. 观察日志中的错误模式或意外行为。
  2. 如果智能体似乎无响应，检查系统事件：
    azd ai agent monitor --type system

完整的调试工作流请参阅调试托管智能体。

PRIMARY_SOURCE: https://learn.microsoft.com/en-us/azure/foundry/agents/how-to/monitor-hosted-agent-logs

  • #Foundry
  • #日志
  • #可观测性
  • #会话
  • #排障

继续阅读

  • 落地方法

    调试托管智能体