对象存储 设置日志检索

三、开通日志检索

1. 登录 对象存储控制台。

2. 在左侧导航栏中，单击存储桶列表，进入存储桶列表管理页面。

3. 找到需要开启日志检索的存储桶，单击该存储桶名称，进入该存储桶管理页面。

4. 在左侧导航栏中，选择日志管理 > 日志检索。

5. 在日志检索页面，若当前存储桶未开通实时日志功能，请单击立即开通进行使用。

注意：说明：

四、开启字段统计分析

索引配置是进行检索分析的必要条件，只有开启索引才能对日志进行检索分析。索引配置较为复杂，建议你使用 CLS 编辑索引配置 中的推荐配置，能够满足大多数使用需求。更多相关信息请参见 CLS 索引配置。

日志检索支持按照字段进行快速统计分析，无需填写查询语句。COS 默认支持字段请参见 日志字段说明，更多信息请参见 CLS 快速分析。

注意：若你希望对日志按照某字段进行统计分析，请提前为该字段开启统计，可通过以下两种方式快速开启。

五、方式一：在索引配置开启

注意：说明：

注意：通过该方式，可以对已开启统计的字段进行关闭。

1. 单击索引配置，进入索引配置页。

2. 在索引配置页面单击右上角的编辑，找到希望开启统计的字段，打开开关，确认无误后单击确定完成配置。

注意：索引规则编辑后仅对新写入的日志生效，已有数据不会更新。如需更新已有数据，需在保存索引配置后，对已有历史数据重建索引。

3. 开启成功后，单击对应字段可查看该字段对应的TOP5日志情况。单击某一数字，可选择在统计图表中查看或查看变化趋势，同时将自动生成对应的检索分析语句和图表。单击更多值可查看在某个时间段（默认为近15分钟）的统计数据。

六、方式二：在原始日志页开启

1. 进入原始日志页。

2. 找到希望开启统计分析的字段，单击立即开启。

注意：说明：

注意：如需关闭已开启统计的字段，请使用上方的索引配置。

七、输入检索分析语句

注意：检索分析语句的使用介绍可参见 语法规则，存储桶访问日志分析方法详见 COS 访问日志分析最佳实践。

检索分析语句由检索条件和 SQL 语句组成，输入检索分析语句，对访问日志进行检索和统计分析。

·检索条件：指定日志需要匹配的条件，返回符合该条件的日志。例如使用resHttpCode:"404"检索响应状态码为404的应用请求日志。检索条件为空或*时代表无检索条件，即检索所有日志。更多语法规则和示例信息请参见 检索条件语法。

·SQL 语句：针对符合检索条件的日志进行统计分析，返回统计分析结果。例如使用resHttpCode="404" | select count(*) as logCounts limit 10000统计响应状态码为404的日志数量。更多语法使用和示例信息请参见 SQL语句语法。

检索分析语句输入模式，支持交互模式、语句模式两种。可单击下拉选择输入模式，进行切换。检索条件支持两种语法规则：CQL 和 Lucene，更多语法规则和示例信息请参见 检索条件语法。

·交互模式：通过鼠标点击指定检索条件及统计分析规则，自动生成检索分析语句，易用性高。

·语句模式：直接输入检索分析语句，需符合语法规则，灵活度高。

八、操作步骤

·交互模式下，选择指定字段，然后配置统计分析指标，选择时间范围，单击搜索按钮即可检索该存储桶上报到 CLS 的访问日志。

·语句模式下，输入检索分析语句，选择时间范围，单击搜索按钮即可检索该存储桶上报到 CLS 的访问日志。

九、查看日志检索结果、统计分析结果

检索成功后，在日志检索页面可查看访问日志的检索结果、统计分析结果。分别对应原始日志和统计图表，支持快捷切换。详细说明如下：

·原始日志：当仅通过包含检索条件时，可在原始日志中查看匹配检索条件的日志，默认按日志时间倒排。

·统计图表：当检索分析语句包含 SQL 语句时，可在统计图表中查看分析结果，同时还可在原始日志中查看符合检索条件的日志，以便于对比分析统计结果及原始日志。

十、原始日志

·支持查看当前检索条件下，指定时间范围内的日志统计情况，以柱状图展示。

·默认以原始形式展示日志数据，支持切换表格、换行等自定义配置。

·日志数据下仅展示“显示字段”，若你希望查看更多或者隐藏日志对应的字段信息，可通过下述三种方式实现：

·列表操作：在原始日志下，左侧面板快速找到该字段，单击显示或隐藏即可完成配置。

·日志详情：展开某条日志查看详情，单击查看图标，即可快速隐藏或者显示某字段。针对每条日志，你还可以查看 JSON 格式的数据，并支持一键复制。除此之外，单击字段值还可以进行自定义跳转，详情参见 自定义跳转。

·显示指定字段：你可以切换显示原始日志或者指定字段；此外可切换默认版面和保存当前版面。

单击管理配置，可以调整默认配置的字段、日志排序，或新建版面。最后单击应用即可。

十一、统计图表

统计图表默认以表格类型展示分析结果，你可以通过右侧的图表配置自定义设置图表类型和相关信息。若要进一步对存储桶访问日志进行可视化与告警的配置， 请前往 CLS 控制台。

十三、下载日志

1. 在原始日志页面，单击右侧下载按钮，选择下载日志。

2. 在弹出的窗口中，按需配置如下信息，确认无误后，单击导出。

3. 进入下载记录页面，可以查看当前任务进度，支持删除和下载操作。在等待过程中，你可以退出当前页面，从右侧下载按钮中单击下载记录，即可再次进入该页面。

十四、导出分析结果

在统计图表页面，单击右侧导出分析数据，将会下载分析结果至本地。

十五、关闭日志检索

若你不希望继续使用某存储桶的日志检索功能，可单击关闭日志检索。

注意：关闭存储桶的日志检索功能后，请前往 日志服务 CLS 日志主题控制台 检查存储桶所在地域下是否存在空日志主题。若存在，建议及时删除操作，避免产生额外计费。关于日志服务 CLS 的计费标准请参见日志服务 计费概述 文档。

十六、日志字段说明

十七、常用示例

以下为你提供几个常用的示例，后续会补充更多案例，请关注产品动态。更多相关信息请参考 SQL 案例、场景示例。

十八、案例一：查询访问量在TOP50的 IP

1. 选择语句模式，输入以下SQL语句。

* | select count(*) as PV, remoteIp as IP group by IP order by PV desc limit 50

·count(*) as PV：统计所有日志条数，即 PV。

·group by IP：按 IP 分组，统计每个 IP 对应的 PV。

·order by PV desc：按照 PV 降序排序，优先展示 PV 高的 IP。

·limit 50：只返回查询结果中的前50条，即 PV 排名前50的 IP。

2. 选择时间范围（例如近30分钟），单击搜索查询，进入统计图表页面，即可查询仅30分钟内的统计分析结果，右侧支持切换图表类型。

注意：说明：

注意：若查询语句运行失败，建议你检查报错信息中指出的错误位置，错误原因可参考 CLS 检索分析报错。

十九、案例二：查询近90天请求的文件路径

1. 选择语句模式，输入以下 SQL 语句。

* | select reqPath group by reqPath limit 1000000

2. 选择时间范围为近90天，单击搜索查询，进入统计图表页面，即可查询统计分析结果，右侧支持切换图表类型。

20、案例三：统计指定前缀的请求数、流量及存储量

例如，存储桶内有以下文件均产生日志请求，希望统计指定前缀为ap的对象（即文件路径为"/ap"、"/ap1"的对象）的请求数、流量及存储量。

1. 选择交互模式，单击添加检索条件，指定 reqPath 包含 /ap* ，筛选出前缀为ap的对象请求日志，其中*为通配符。

2. 在输入框里输入以下语句。

SELECT count(*) as "请求数",sum(resBytesSent) as "流量",SUM(CAST(objectSize AS INT)) AS "存储量" WHERE objectSize != '-'

3. 或者在步骤1选择语句模式，直接输入以下SQL语句。

reqPath:"/ap*" | SELECT count(*) as "请求数",sum(resBytesSent) as "流量",SUM(CAST(objectSize AS INT)) AS "存储量" WHERE objectSize != '-'

4. 选择时间范围，单击搜索查询，进入统计图表页面，即可查询统计分析结果，右侧支持切换图表类型。

21、案例四：某个文件访问不了，定位原因

1. 选择交互模式，单击添加检索条件。指定需要查找的文件名，并选择时间范围，单击搜索查询日志。

2. 单击左侧字段名称，打开快速分析，按 resHttpCode 字段进行统计分析。查看异常状态码的日志信息，例如403状态码、204状态码等。

3. 针对异常状态码，可以单击状态码，选择添加到本次检索筛选日志。在日志详情可查看其他字段的情况，建议重点关注 reqMethod 字段等。

如下所示，该文件被执行了删除操作，导致对象访问失败。