本文介绍如何查看日志。接入日志后支持进行检索分析与监控告警等。
简介
模型路由提供以下两种日志能力：
CLS 日志：推荐使用，依托 CLS 日志服务，提供从日志采集、日志存储到日志检索分析、监控告警等多项服务。
注意：
基本日志：模型路由提供基本的日志功能，您可以在实例详情中查看最近 24 小时内的 API 请求记录，包括请求状态、Token 消耗、响应耗时等信息，帮助您快速排查问题与分析调用情况。后期计划下线。
模型路由接入 CLS 后，您将获得以下能力：
故障排查：通过检索访问日志，快速定位请求失败、超时等问题。
安全审计：记录所有模型调用请求，满足审计和合规要求。
用量分析：统计模型调用量、Token 消耗、响应延迟等指标，辅助容量规划和成本优化。
监控告警：基于 CLS 的告警能力，对异常访问模式、错误率上升等指标设置告警规则。
字段说明
模型路由投递至 CLS 的访问日志包含以下字段：
字段名称 | 类型 | 说明 |
timestamp | long | 请求时间戳（毫秒级） |
request_id | text | 请求唯一标识 |
client_ip | text | 客户端 IP 地址 |
model | text | 请求的模型名称 |
provider | text | 模型提供商 |
request_path | text | 请求路径 |
method | text | 请求方法（如 POST） |
status_code | long | 响应状态码 |
latency_ms | long | 请求延迟（毫秒） |
request_tokens | long | 请求消耗的输入 Token 数 |
response_tokens | long | 响应消耗的输出 Token 数 |
total_tokens | long | 请求消耗的总 Token 数 |
upstream_status | long | 后端模型服务返回的状态码 |
upstream_latency_ms | long | 后端模型服务响应延迟（毫秒） |
error_code | text | 错误码（请求失败时返回） |
error_message | text | 错误信息（请求失败时返回） |
user_agent | text | 客户端 User-Agent |
注意：
前提条件
1. 已开通 日志服务 CLS，创建日志集和日志主题。日志主题（Topic）是日志数据进行采集、存储、检索和分析的基本单元，日志集则是对日志主题的分类，方便用户管理日志主题。
2. 已创建模型路由实例，详细操作指导请参见 创建模型路由实例。
操作步骤
步骤1：开启日志投递
1. 登录 模型路由 控制台，在实例管理页面，单击目标实例 ID，进入目标实例的实例基本信息页面。
2. 切换至日志页签，单击立即启用。
3. 在开启日志投递弹窗中，选择已有日志集和日志主题，然后单击立即开启完成配置。推荐您记录输入输出内容。
说明：
日志从投递到可检索存在约1 - 3分钟的延迟。日志投递开启后，您可以在 CLS 控制台的检索分析页面实时查看日志内容。如果检索不到日志，请检查索引配置是否正确。
步骤2：修改日志投递策略
1. 在模型路由实例的日志页签，单击修改投递。
步骤3：关闭日志投递策略
1. 在模型路由实例的日志页签，单击关闭投递。
2. 在关闭访问日志弹窗，勾选确认关闭后，单击确认。
注意：
关闭后，将无法继续记录模型路由的访问情况，请谨慎操作。
常见问题
1. 日志投递至 CLS 后检索不到数据？
日志投递至 CLS 后存在约1 - 3分钟的延迟。如果超过5分钟仍检索不到日志，请检查以下内容：
确认日志主题的索引配置是否正确，是否已开启全文索引或对应字段的键值索引。
确认检索的时间范围是否覆盖实际日志产生的时间。
确认日志投递是否处于开启状态。可以在模型路由控制台的日志页面查看投递状态。
2. CLS 日志投递是否会产生额外费用？
3. 能否将日志同时投递至多个日志主题？
每个模型路由实例仅限添加至一个日志主题。如需将日志分发至多个目的地，可以在 CLS 控制台使用日志投递功能将日志投递至 COS 或 CKafka。
相关文档
配置日志索引
管理日志集
管理日志主题
查看与分析日志