搜索日志

当您配置完成日志结构化解析和索引后，就可以通过输入搜索语句，在日志数据中查找包含特定关键词的日志记录。或者根据时间范围来检索日志数据，帮助您定位特定时间段内发生的事件和问题。

搜索语句用于指定日志查询时的过滤规则，返回符合条件的日志。搜索语句可以为关键词、数值、数值范围、空格、星号（*）等。如果为空格或星号（*），表示无过滤条件。更多信息请参见LTS搜索语法介绍。

搜索日志

登录云日志服务控制台，进入“日志管理”页面。
在“日志管理”页面，单击目标日志组或日志流名称，进入日志详情页面。
在“日志搜索”页面，您可以根据自己的实际需求，在时间范围选择框，即可查看不同时间段的日志数据。

图1 时间范围

时间范围有三种方式，分别是相对时间、整点时间和自定义。您可以根据自己的实际需求，选择时间范围。
- 相对时间：表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31，设置相对时间1小时，表示查询18:20:31~19:20:31的日志数据。
- 整点时间：表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31，设置整点时间1小时，表示查询18:00:00~19:00:00的日志数据。
- 自定义：表示查询指定时间范围的日志数据。支持选择3个月的范围，白名单用户支持选择6个月的范围。如有需要，请提交工单申请。
根据LTS搜索语法介绍在搜索框输入查询条件，用于日志数据的查看、简单搜索和过滤。

图2 日志搜索
1. 在页面搜索区域中，单击搜索框，输入待搜索的关键字，或在弹出的下拉框中选择待搜索的字段和关键词，单击“查询”，开始搜索。
  - 内置保留字段有appName、category、clusterId、clusterName、collectTime等，默认简化显示，并且hostIP、hostName、pathFile默认显示在最前面。更多内置保留字段请参考创建LTS日志索引。
  - 结构化配置的字段按照key:value显示。
  - 日志搜索框内容过多时支持自动换行并多行显示。支持固定搜索框高度。
2. 在页面搜索区域，使用键盘的"↑""↓"箭头，选择待搜索的关键字或搜索语法，单击Tab键或Enter键选中后，单击“查询”，开始搜索。
3. 对已创建快速分析的字段，单击选择字段可直接将其添加到页面搜索框中，进行搜索。请参考创建LTS快速分析开启快速分析。
  通过单击字段添加到搜索框中，如果是同一字段，则将直接替换该方式添加的字段，不会进行AND搜索；如果是不同字段，则对不同字段进行AND搜索。
在“日志搜索”页签，您可以进行如下操作，更多操作请参考日志搜索的常用操作。
1. 在日志统计下方，展示不同时间段的日志总条数柱状图，柱状图旁边显示日志条数刻度。
  图3 日志统计
  
  若使用了内嵌功能，支持设置收起或展开式日志条数统计图。关于内嵌参数请参考云日志服务地址。
2. 在日志内容下方，鼠标悬浮指向日志内容中的字段，单击蓝色字体的日志内容，支持以下方式搜索日志：复制、添加到查询、从查询中排除、添加到查询（交互模式）、从查询中排除（交互模式）、新建查询、隐藏。
3. 在日志内容下方，支持选择列表或原始日志方式展示日志内容。
  日志高亮的实现原理是当查询条件命中日志后，再将日志与查询条件进行字符串匹配，相同日志部分增加高亮标签，该部分会在界面高亮展示。因此当查询条件比较复杂，尤其是存在或关系时，在界面高亮显示的内容可能会比实际查询结果显示的多。
在日志搜索页面，当搜索数据量过大时，LTS开始执行自动迭代查询日志。
- 自动迭代查询日志过程中，搜索框不支持输入，您可以单击“暂停查询”中断自动查询过程，若需要继续查询日志，单击“继续查询”恢复自动查询。建议您等待当前自动迭代查询完成后再发起新的查询任务。
- 对于较长时间的迭代查询，建议您缩小时间范围或添加过滤条件减少迭代次数。
支持设置日志数据的版面展示，主要设置字段是否显示或简化显示。
1. 在下拉框单击编辑版面，进入版面设置页面，版面列表自带默认版面、纯净版面、容器日志默认版面，可以设置字段在版面是否显示。
  图4 编辑版面
  - 云端：适用于有写权限的用户，版面配置信息保存在云端。
  - 本地缓存：适用于只有读权限的用户，版面配置信息缓存在本地浏览器。
2. 在版本设置页面的版本列表下方，单击“+”新增自定义版面，设置版面名称和版面字段的可见性。
  图5 版面设置
3. 设置完成后，单击“确定”，返回下拉框显示新增的自定义版面。
在“日志搜索”页面，选择列表，支持设置显示列。
1. 选择列表展示日志时，鼠标悬浮在按钮上，单击“显示列设置”，在弹出的日志折叠设置页面中，设置显示列的信息。
2. 时间列、content默认开启显示，在显示列下方，全量显示可见的字段名称，支持设置字段名称的别名，合理设置字段别名可以显著提高日志的可读性、可维护性和查询效率。设置完成后，单击“确定”。
3. 您可以通过创建快速分析或7显示或隐藏字段。

交互模式

使用交互模式之前，请确保日志正常上报，且已经完成结构化分析和索引配置。详细请参考使用ICAgent插件采集主机日志和创建LTS日志索引。

若用户在日志接入LTS时没有配置ICAgent结构化解析，可以单独给目标日志流配置ICAgent结构化解析或云端结构化解析。推荐使用ICAgent结构化解析的方式，更多内容请参考配置ICAgent结构化解析。

交互式搜索适用于生成简单的搜索语句，操作简单，通过在界面上设置搜索条件和指定日志查询时的过滤规则，从而筛选日志中满足条件的记录。如果您需要使用更多的函数或者嵌套查询，请手动输入SQL语句。详细请参考SQL分析语法介绍。

单击搜索框前面的“交互模式”，进入交互式搜索页面。

图6 交互模式
在下拉框选择日志搜索的字段和条件，搜索框则会展示对应字段的值。根据业务需要，用户可以自定义设置搜索方式，添加关联关系或添加组进行搜索。
- 下拉框显示的字段为索引配置字段、结构化字段、内置保留字段。
- 且（AND）表示在多个条件中需要同时满足所有条件才能成立。
- 或（OR）表示在多个条件中只需满足其中一个条件即可。
例如在界面上选择content、collectTime、category字段，设置不同的条件，随时可以预览搜索语句，如有问题，可以修改搜索条件，操作简单。

（截图仅供参考，请以实际搜索结果为准）
```
(content:"{\"write_traffic\":11,\"index_traffic\":133,\"storage\":17107}" AND collectTime=1728631667089) OR category:LTS
```
设置完成后，单击“确定”，LTS根据搜索语句进行日志搜索，在日志搜索下方即可查看搜索结果。（截图仅供参考，请以实际搜索结果为准）

日志搜索的常用操作

在日志内容展示区域，支持分享日志、查看上下文、下载日志等操作，具体参考表1。

如果出现服务网络不稳定、系统负载过高或其他不可预见的因素时，日志上报到LTS可能会出现极少日志的重复或丢失的情况。

表1 常用操作
操作	说明
创建快速查询	单击按钮，创建快速查询。
查看仪表盘	单击按钮，在弹出来的仪表盘页面中，可查看已创建的仪表盘。
添加告警	单击按钮，在弹出的页面中，支持新建告警规则。
分享日志	单击复制当前日志搜索页面的链接，用于分享搜索日志。
刷新日志	单击对日志进行刷新，有两种方式刷新方式：手动刷新和自动刷新。手动刷新：单击“手动刷新”，可直接对日志进行刷新。自动刷新：选择自动刷新的间隔时间，将对日志进行自动刷新。间隔时间范围为15秒、30秒、1分钟和5分钟。
复制	单击复制日志内容。
查看上下文	单击查看日志上下文。支持选择简洁模式查看日志上下文。支持下载上下文内容。
更多操作	单击进入该时间段的日志详情页，查看更多日志信息。在“扩展字段”页签，查看字段名称、字段值，在对应字段操作列，支持对该字段进行添加到查询、从查询中排除、字段存在、字段不存在、隐藏的方式搜索日志。在“json格式”页签，查看日志的json格式。在“上下文日志”页签，支持设置查询行数、过滤字段、下载日志、简洁模式等操作。
换行/取消换行	单击按钮，搜索的日志内容将换行显示，默认开启换行按钮。若不需要换行，单击按钮，取消换行。
下载日志	说明：该功能仅支持白名单用户使用，如有需要，请提交工单申请开通。请确保当前日志流上传了原始日志，否则下载后文件将没有内容。鼠标悬浮在按钮上，单击“下载日志”，在弹出的下载日志页面中支持“本地下载”和“前往创建转储”。开通一次性转储后才能看到“前往创建转储”功能。本地下载：将日志文件直接下载到本地，白名单用户单次下载支持最大2000万条日志。非白名单用户单次下载支持最大5,000条日志。在下拉框中选择“.csv”或“.txt”，单击“开始下载日志”，可将日志导出至本地。前往创建转储（白名单功能）：通过OBS转储任务下载日志文件，单次下载支持最大2,000万条日志。单击“前往创建转储”，跳转至配置转储页面，详细请参考日志转储至OBS。鼠标悬浮在按钮上，单击“日志下载历史”，在日志下载历史页面，支持查看、下载、复制日志下载链接、删除日志下载记录。
全部折叠/全部展开	单击设置日志内容展示的行数。若不需要展示日志内容，再单击一次按钮即可关闭展示的日志内容。
JSON设置	鼠标悬浮在按钮上，单击“JSON设置”，在弹出的JSON设置页面中，设置格式化显示。默认开启格式化，JSON默认展开层级为2层。若日志包含多个反斜杠，当日志展示为json格式时，会丢失一个反斜杠，因为json解析会将第一个反斜杠作为转义符处理。开启格式化按钮：设置JSON默认展开层级，最大设置为10层。关闭格式化按钮：对于JSON格式的日志，将不会格式化层级显示。
日志折叠设置	鼠标悬浮在按钮上，单击“日志折叠设置”，在弹出的日志折叠设置页面中，设置长日志字符个数。日志超过设置的长日志字符个数时，超出字符将被隐藏，单击“展开”按钮可查看全部内容。默认开启自动折叠长日志，字符个数默认为400个。
日志时间展示	鼠标悬浮在按钮上，单击“日志时间展示”，在弹出的日志折叠设置页面中，默认开启展示毫秒，设置是否展示毫秒、是否展示时区。
虚拟滚动设置	鼠标悬浮在按钮上，单击“虚拟滚动设置”，在弹出的虚拟滚动设置页面中，设置是否开启虚拟滚动、填写缓冲区大小。虚拟滚动可以避免或减少滚动时卡顿的情况，提升操作体验，防止页面卡死。滚动时数据会重新渲染，一定程度上影响数据流畅性。缓冲区决定同时加载的数据量大小，缓冲区越大，同时加载的数据越多，但滚动性能会越差。
不可见字段列表	该列表展示版面设置中配置的不可见性字段。当日志流未配置版面设置时，将不显示按钮。当日志内容为“CONFIG_FILE”且未配置版面设置时，不可见字段默认有appName、clusterId、clusterName、containerName、hostIPv6、NameSpace、podName和serviceID。

跨流搜索

在当前日志流详情页面，支持跨流搜索日志，即无需退出当前日志搜索页面，即可选择其他日志流搜索日志。

在当前日志流详情页面，单击。
在弹出的跨流搜索页面，选择需要搜索的目标日志流。
单击“确定”。
进入目标日志流详情页，根据业务需要参考搜索语法介绍进行搜索日志。

若需要更换日志流，单击左上角跨流搜索旁边，在弹出的页面重新选择日志流进行搜索。
搜索完成后，单击右上角的“退出跨流搜索”，即可返回当前日志流搜索页面。
- 当跨流搜索的日志流的分词配置不同时，会导致跨流日志关键词高亮不一致。
- 最多可同时搜索50个日志流。
- 仅支持搜索原始日志，暂不支持使用SQL进行统计分析。
- 支持跨日志组选择日志流，但不支持跨区域选择日志流。
- 跨流搜索选择多个索引配置不一致的日志流，例如A日志流配置了字段索引Key1，B日志流没有配置该字段，使用搜索语句Key1:xxx搜索日志时，仅能查看A日志流的相关日志，B日志流搜索日志失败，请根据界面报错提示修改后再重新搜索日志。