> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 调用记录

> 跨工作空间和环境查询应用调用记录，查看调用状态、耗时与失败原因

调用记录用于集中查询企业内各工作空间、各环境的应用调用详情，包括调用状态、耗时、token 用量和失败原因。Workflow 应用的每次运行、Chatflow 应用的每条对话消息分别对应一条记录。内置环境还会记录聊天助手、Agent 和文本生成应用的消息。

访问路径：企业管理后台 > **调用记录**。

工作空间内的应用 **日志** 页面仅展示单个应用的记录，企业管理后台的调用记录汇总企业内所有应用的记录。

## 记录范围

**环境** 表示应用在哪里运行，**来源** 表示调用通过什么方式发起。调用记录包含平台自带的 **内置环境**，以及在环境管理中创建的 **部署环境**：

| 环境类型 | 说明 |
| - | - |
| **内置环境** | Dify 平台自带的应用运行环境，在工作室调试时发起的调用也计入其中。 |
| **部署环境** | 在 [环境管理](/zh/3.13.x/administer/environments) 中创建、配置资源并部署应用的环境。 |

内置环境中，在工作室测试运行的调用，**来源** 显示为 **调试**。部署环境只有 **Web 应用** 和 **Service API** 两种来源。

Docker Compose 部署仅展示内置环境的调用记录。

## 查询记录

页面默认展示 **最近 24 小时** 的记录。表格上方的摘要行显示「共 N 条 · 失败 M 条」，统计结果随筛选条件变化。

<Frame>
  <img src="https://mintcdn.com/dify-enterprise-docs/Hu0J7U2xWLzt-hdq/images/administer/app-runner-invocation-logs.png?fit=max&auto=format&n=Hu0J7U2xWLzt-hdq&q=85&s=68ac9a5ed60d40f0422364ae932667c0" alt="调用记录列表与错误详情" width="3820" height="2056" data-path="images/administer/app-runner-invocation-logs.png" />
</Frame>

可通过以下条件查找目标调用：

* **时间范围**：可切换为 **最近 7 天**、**最近 30 天** 或 **自定义范围**。
* **环境、工作空间、状态和来源**：可组合筛选。将状态设为 **失败**，可仅查看失败的调用。
* **搜索应用名称**：按名称包含匹配，不区分大小写。

## 调用详情

列表展示每次调用的时间、状态、应用、环境、版本、耗时、Token 数、操作者和来源。其中：

* **版本**：显示版本名称；没有名称时显示版本号（`# N`）或 **未命名版本**。`—` 表示该记录没有版本。
* **操作者**：工作空间成员发起的调用显示成员名称，Web 应用终端用户显示其会话 ID（`session_id`），部署环境中的 Service API 调用显示请求中的 `user` 值。

展开包含错误信息的记录，可查看并复制 **错误信息**。

## 记录保留

部署环境的调用记录默认保留 30 天，系统每日删除超出保留期的记录。内置环境的记录仍保存在 Dify 中，但超出保留期后不再显示。保留期对所有时间范围都生效，包括 **自定义范围**。

如需调整保留天数，设置 `enterprise.appRunnerLog.retentionDays`（`APP_RUNNER_LOG_RETENTION_DAYS`，最小值为 `1`）。调低后，下次每日清理会删除超出新保留期的部署环境记录。详见 [部署环境（App Runner）](/zh/3.13.x/deploy/advanced-configuration/environment-variables#app-runner)。
