# 日志分析

日志分析用于对指定范围内的模型推理日志进行智能分析，自动识别团队或个人的 AI 使用模式，并生成包含活动分布、主要任务、风险与建议等内容的结构化报告，帮助您了解 AI 的实际使用情况并发现潜在问题。


一次日志分析通常包括以下步骤：

1. 完成基本设置，选择分析任务使用的模型并配置活动分类；
2. 新建分析任务，选择需要分析的日志范围；
3. 等待任务在后台完成；
4. 查看、下载报告，或基于原配置重新分析。


## 使用前提

使用日志分析前，请确认符合以下条件：

- 当前项目已开启推理日志；
- 已准备可用于日志分析的 API Key，且该 API Key 已获得所需模型的调用权限；

若页面未展示日志分析入口，请优先检查当前项目是否已开启推理日志，以及当前账号是否具备相关功能权限。

> **数据安全提示** 日志分析将读取所选范围内的推理日志。日志中可能包含个人信息、业务数据或其他敏感内容。使用前，请确认相关数据的记录和分析符合您及所在组织的数据安全与合规要求。


## 基本设置

首次使用日志分析前，需要完成基本设置。进入**模型服务平台 > 模型日志 > 日志分析**，单击**基本设置**，配置以下内容：

| 设置项     | 说明                                          |
| ------- | ------------------------------------------- |
| API Key | 用于调用预处理模型、向量模型和分析模型。列表展示当前账号有权限使用的 API Key。 |
| 预处理模型   | 用于对原始日志进行预处理。可选项取决于所选 API Key 的模型权限。        |
| 向量模型    | 用于对日志内容进行向量化处理和语义聚合。可选项取决于所选 API Key 的模型权限。 |
| 分析模型    | 用于完成深度分析并生成报告洞察。可选项取决于所选 API Key 的模型权限。     |
| 活动分类    | 用于按照统一标准统计日志中的活动类型。建议根据实际业务调整分类，使报告更贴合分析目标。 |

若所选 API Key 下没有可用于某个分析环节的模型，请更换 API Key，或前往密钥管理页面开通相应模型权限。

修改基本设置只影响后续提交的分析任务，不会改变已生成的历史报告。

## 创建日志分析

1. 进入**模型服务平台 > 模型日志 > 日志分析**。
2. 单击页面右上角的**新建分析**。
3. 检查页面展示的当前分析设置。如需调整，单击**编辑设置**。
4. 填写报告名称并选择分析范围。
5. 确认后提交任务。


任务提交成功后将在后台异步执行。

处理大量日志可能需要较长时间，建议稍后或次日返回查看。

### 分析范围

所有分析条件取交集，系统只会分析同时满足全部条件的日志。


日志分析具有以下范围限制：

- 仅分析所选项目下已记录的推理日志；
- 当前仅支持分析响应成功的模型请求；
- 单次任务最长可分析连续 31 天的日志；
- 最早可选择最近 60 天内的日志；

具体可选模型、日志量上限及其他限制，以控制台页面展示为准。


## 管理分析任务

在日志分析列表中，可查看和管理历史任务。

列表中的每条任务包含任务名称、状态、分析范围、创建时间和可用操作。

### 任务状态

|状态|说明|
|---|---|
|排队中|任务已提交，正在等待系统分配执行资源。|
|分析中|系统正在处理日志并生成报告。|
|成功|任务已完成，可以查看和下载报告。|
|异常|任务执行失败，可查看错误信息并重新分析。|
|已取消|任务已由用户取消，可复制原配置后重新分析。|

### 重新分析

点击**重新分析**，系统将复制原任务配置并进入创建页面，您可以直接提交，也可以修改报告名称、分析范围等参数后再提交。

重新提交后会生成一个新的分析任务，原任务及其报告不会被覆盖。

### 查看报告

任务状态变为**成功**后，单击**查看**进入报告页面。

报告内容由模型基于采样日志生成，仅供分析和决策参考。对于重要结论，建议结合业务背景和原始日志进一步核验。

### 下载报告

在报告页面单击**下载**，可将当前分析结果下载为 HTML 文件。

当前仅支持下载分析结果报告页，暂不支持随报告下载样本原始日志。若需要保存原始日志，请通过模型日志或日志服务提供的能力单独检索和导出。



## 数据保存与费用

- 日志分析报告最多保留最近 60 天，超过保存期限后可能无法查看或下载。
- 日志分析会调用预处理模型、向量模型和分析模型，并按照各模型的实际用量计费。
- 取消正在执行的任务不会撤销已产生的模型调用和费用。
- 可在**模型服务平台 > 模型日志**、**消费中心**查看日志分析产生的模型用量与消费明细。


## 常见问题

### 为什么看不到日志分析入口？

请确认当前项目已开启推理日志，并且当前账号拥有该项目的日志分析功能权限。若仍未显示，请联系项目管理员确认权限配置。

### 为什么没有可用的分析模型？

可选模型取决于基本设置中所选 API Key 的模型权限。请尝试更换 API Key，或前往密钥管理页面开通所需模型权限。

### 为什么符合条件的日志数量为 0？

请依次确认：

1. 所选时间范围内是否已产生推理日志；
2. 推理日志是否在模型请求发生前开启；
3. API Key 和模型筛选条件是否正确；
4. 所选请求是否为成功响应；
5. 日志是否仍在保存期限内。

### 为什么提交后没有立即生成报告？

日志分析采用异步执行方式。任务需要依次完成排队、日志处理和报告生成，执行时间与日志量、采样率、模型响应和系统负载有关。您可以离开页面，稍后在分析列表中查看任务状态。

### 任务异常后怎么办？

单击异常任务的**查看详情**，查看错误码和失败原因。对于模型权限、账号状态或日志范围等问题，请按提示处理后单击**重新分析**。重新分析会创建新任务，不会覆盖原记录。

### 取消任务后还会产生费用吗？

可能会。取消排队中的任务通常尚未产生分析消耗；取消分析中的任务时，已经完成的模型调用会正常计费。

### 为什么同一时间段内报告中覆盖的日志数量与模型日志页面不同？

两处数据可能采用不同的时间范围、筛选条件、保存期限和统计口径。日志分析还可能按采样率抽取样本，并对请求进行会话整理和去重。

### 报告内容可以直接作为最终结论吗？

不建议。报告由模型根据采样日志生成，可能受样本范围、采样率、分类配置和模型能力影响。对于风险判断、人员评价或重要业务决策，请结合完整数据和业务背景进行人工核验。