# 日志采集

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

火山方舟支持将模型调用相关日志投递至火山引擎日志服务 TLS（Torch Log Service）。开启后，每次调用的请求、响应、状态码、时延和 Token 用量等会近实时写入您账号下的 TLS，便于检索日志、分析调用和排查问题。

> **说明**
>
> 日志服务 TLS 为火山引擎独立计费产品，使用后将产生 TLS 侧费用，计费标准请参考 [日志服务计费说明](https://docs.volcengine.com/docs/torch-log-service/billing-itemsbasedonpay-by-feature-mode?lang=zh) 。

<span id="prerequisites"></span>
## 前提条件
  当前账号具备日志服务 TLS 的开通权限。首次开启时，按控制台提示完成 TLS 开通与跨服务授权。

<span id="supported-scope"></span>
## 支持范围

- **在线推理**：日志投递按推理接入点开启，预置推理接入点和自定义推理接入点均支持。
- **模型**：大语言模型、生图模型、生视频模型、生 3D 模型。
- **API**：Chat API、Responses API、Messages API、Image Generation API、Video Generation API。
- **投递时机**：同步调用在请求结束后投递；异步任务在返回最终结果后投递。

<span id="enable-log-delivery"></span>
## 开启日志投递

1. 访问 [创建推理接入点](https://ark.volcengine.com/region:cn-beijing/endpoint/create) ，展开 **更多**，打开 **日志投递** 开关；或进入已有接入点的详情页，在 **日志投递** 卡片中打开开关。
2. 首次开启时，在 **开启日志投递** 窗口中勾选同意条款，点击 **一键授权并开通**。方舟自动完成 TLS 开通和跨服务授权。

> **说明**
>
> 关闭日志投递：在接入点详情页关闭 **日志投递** 开关并确认。关闭后，该接入点新增的调用日志不再投递；已投递日志按 TLS 保留策略存储至过期，期间持续产生存储费用。

<span id="view-call-logs"></span>
## 查看调用日志

开启日志投递后，方舟会在您的 TLS 同一地域同一项目下创建日志项目 `ark_inference_project_<project_name>`（`<project_name>` 为推理接入点所属的项目名称）和日志主题 `ark-inference-log`。该推理接入点后续新发起的请求会统一投递至 `ark_inference_project_<project_name>` 下的 `ark-inference-log`。

进入 [日志服务 TLS 控制台](https://console.volcengine.com/tls) ，在对应日志主题中检索、分析日志。

<span id="log-fields"></span>
## 日志字段说明

一条日志对应一次 API 调用，字段说明如下。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `request_id` | string | 请求唯一标识，用于日志检索和问题排查。 |
| `X-Client-Request-Id` | string | 客户端请求标识，用于关联客户端请求与对应的调用日志。 |
| `account_id` | string | 火山引擎账号 ID。 |
| `project_name` | string | 项目名称。 |
| `endpoint_id` | string | 推理接入点 ID。 |
| `api_type` | string | 接口类型。 |
| `model_name` | string | 模型名称和版本。 |
| `service_tier` | string | 推理服务等级。 |
| `api_key` | string | API Key ID，以脱敏形式记录。 |
| `client_ip` | string | 客户端来源 IP。 |
| `status` | string | 请求处理状态，以字符串形式记录。 |
| `extra.status.status_code` | int | HTTP 状态码。 |
| `extra.status.code` | string | 请求错误码。 |
| `extra.status.message` | string | 请求错误描述。 |
| `usage` | string(JSON) | 响应体中的用量信息。 |
| `input` | string(JSON) | 请求内容，包含模型、消息、提示词或生成参数等信息。 |
| `output` | string(JSON) | 模型响应或生成结果，包含回答内容、用量信息或产物链接等信息。 |

`usage`、`input` 和 `output` 为 JSON 字符串，具体结构以对应 API 的请求参数和响应参数为准。

<span id="multimodal-content-storage"></span>
## 多模态内容存储说明

多模态内容按数据形式采用以下存储方式，输入与输出中的 Base64 内容均适用统一转存规则。

- **Base64 内容**：所有形式的 Base64 内容，包括图片、视频、音频、PDF/文档等输入，以及以 Base64 返回的生成产物，均统一转存为 TLS 的 TOS URL，日志中记录转存后的 URL。转存文件的 TTL 与对应日志的 TTL 一致，按日志保留周期管理。
- **其他产物 URL**：以 URL 返回的图片、视频、视频尾帧和 3D 产物保留原始 URL，有效期为 24 小时。日志保存时间不会延长原产物 URL 的有效期。
- **File ID**：以 File ID 引用的文件保留原始 `file_id`，不修改该标识，也不转换为 TOS URL。

<span id="disclaimer"></span>
## 免责声明

特殊情况下，日志采集可能存在遗漏。日志数据仅供调用追踪和问题排查参考，不作为方舟侧模型计费的依据，实际费用请以账单为准。

日志仅写入您账号下的 TLS，方舟侧不会存储您的日志数据。