> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 查询和分析日志
> 了解如何按日志类型、时间范围、关键词和过滤条件查询日志，并通过原始日志和日志聚类分析问题。
您可以在日志页面按日志类型查询日志，并通过时间范围、关键词和过滤条件定位目标日志。查询结果支持 **原始日志** 和 **日志聚类** 两种视图：前者用于查看逐条日志明细，后者用于聚合同类日志并识别高频错误模式。
如需排查 CKS 集群中的资源或工作负载，可以从集群工作台进入 **可观测 > 日志** 页面。系统会按当前集群预置查询范围，您可以继续调整日志类型、时间范围、关键词和过滤条件。
## 适用场景
查询日志适合以下场景：
* 排查资源、任务或应用运行异常。
* 根据关键词查找应用报错、任务输出或调试信息。
* 按日志字段过滤日志。
* 通过日志聚类查看相似日志的聚合结果。
* 导出查询结果，用于问题记录或技术支持排查。
## 查询日志
1. 登录 [GPU 云服务控制台](https://console.siflow.cn/gpu-cloud/home)，进入 **日志** 页面。
如需从集群入口查询，进入 **集群** 页面，单击目标集群名称进入集群工作台，再进入 **可观测 > 日志** 页面。
2. 在 **类型** 中选择日志类型，例如 `container_stdout`。
3. 选择需要查询的时间范围。
4. 在搜索框中输入日志关键词。
搜索框支持按日志内容进行全文匹配。关键词为空时，系统按当前日志类型、时间范围和过滤条件查询日志。
5. 如需进一步缩小范围，单击 **添加过滤**，添加字段过滤条件。
过滤条件与搜索条件会同时作用于 **原始日志** 和 **日志聚类** 两个视图。
6. 单击 **搜索**。
## 查看原始日志
在 **原始日志** 页签中，您可以查看匹配当前查询条件的日志记录。排查具体问题时，通常先通过时间分布定位异常集中出现的时间段，再结合字段和日志内容确认资源范围。
查看原始日志时，重点关注以下信息：
| 信息 | 说明 |
| - | - |
| 记录数量 | 当前查询条件下匹配的日志记录总数。 |
| 时间分布 | 日志在当前时间范围内的分布情况，可用于判断异常是否集中出现。 |
| 字段列表 | 可用于筛选或调整关注字段，例如 `_timestamp`、`region`、`cluster`、`namespace_name`、`pod_name`、`container_name` 和 `log`。 |
| 日志内容 | 查看具体日志文本，并结合资源字段定位对应集群、命名空间、Pod、容器或节点。 |
## 查看日志聚类
当查询结果较多，或需要快速识别高频错误时，可以切换到 **日志聚类** 页签，查看相似日志的聚合结果。
日志聚类会使用当前搜索条件、过滤条件和时间范围。您可以先通过关键词和字段过滤缩小范围，再切换到 **日志聚类** 页签查看聚合结果。
在 **日志聚类** 页签中，可以关注以下信息：
| 信息 | 说明 |
| - | - |
| **数量** | 当前聚类模式匹配的日志数量和占比。数量越高，越需要优先判断是否为共性问题。 |
| **日志分布** | 当前聚类模式在时间范围内的分布情况，可用于判断问题是否持续出现或集中爆发。 |
| **聚类模式** | 聚合后的日志模板。``、``、`