日志列表¶

日志查看器是您进行日志分析和问题排查的核心工具之一。面对观测云采集并上报的海量日志数据，您可以通过搜索、过滤、导出等多个操作，实现高效管理日志信息。

日志统计¶

观测云会根据选择的时间范围自动划分若干时间点，通过堆积柱状图展示不同日志状态的数量，帮助进行统计分析。若对日志进行了筛选过滤，柱状图同步展示筛选后结果。

• 日志统计图支持通过鼠标悬浮至图表，点击导出按钮，即可导出到仪表板、笔记或粘贴板；
• 日志统计图支持自定义选择时间间隔。

时间控件¶

观测云查看器默认展示最近 15 分钟的日志数据。您可以自定义数据展示的时间范围。

日志索引¶

您可以设置日志多索引，筛选符合条件的日志保存在不同的日志索引中，并通过为日志索引选择不同的数据存储策略，从而节约日志数据存储费用。

设置索引后，即可在查看器选择切换不同的索引查看对应的日志内容。

搜索与筛选¶

在日志查看器搜索栏，支持多种搜索方式和筛选方式。

输入搜索或筛选条件后，可查看查询的预览效果。您可以复制该条件，直接用于图表或查询工具。

DQL 搜索¶

前提：DQL 搜索功能目前仅支持日志查看器使用。

在日志查看器，您可以通过点击搜索框内的切换按钮 ，切换到 DQL 手动输入查询模式，可自定义输入筛选条件和搜索条件。

• 筛选条件：支持 and / or 任意组合，支持使用 () 括号表示执行搜索的优先级，支持 = 、!= 等操作符；
• 搜索条件：支持使用 DQL 函数 query_string() 字符串查询，如输入 message = query_string() 对日志内容进行搜索。

更多 DQL 语法，可参考 DQL 定义。

快捷筛选¶

在日志查看器左侧，可对快捷筛选进行编辑。

注意：若快捷筛选的列出值受采样影响，显示采样率，并支持用户临时关闭采样。

自定义显示列¶

日志查看器默认显示 time 和 message 字段，其中 time 字段为固定字段无法删除。当 hover 在查看器显示列上时，点击设置按钮，即可对显示列进行升序、降序、向左移动列、向右移动列、向左添加列、向右添加列、替换列、添加到快捷筛选、添加到分组、移除列等操作。

更多详情，可参考 显示列说明。

JSON 字段返回¶

注意：该功能仅适用于拥有 DQL 查询权限的用户角色。

观测云 DQL 查询支持从日志数据的 JSON 字段中提取内嵌的值，通过在 DQL 查询语句中添加带有 @ 符号的字段，系统会识别该配置并将其作为独立字段在查询结果中展示。如：

• 正常查询：

• 期待提取内嵌字段后的查询：

在日志查看器，若想直接在数据列表中指定查看从每条日志 message 的 JSON 文本中提取出的值，在显示列处添加格式为 @targer_fieldname 的字段。如下图，我们在显示列中添加 DQL 查询语句中已配置的 @fail_reason：

新建监控器¶

在进行日志数据筛选时，若您希望对系统过滤出的数据实施进一步的告警监控，可以通过一键设置监控器来实现。观测云将自动应用您选定的索引、数据来源和搜索条件，简化配置流程。

注意：

1. 若查看器左上角选择了其它工作空间，搜索条件不会被同步，监控器配置页为默认置空状态。
2. 普通商业版默认开启了站点级别的 左* 查询，您只需开启工作空间级别的 左* 查询，即可支持监控器 左* 查询；针对部署版，您可以自主开启或关闭站点级别的 左* 查询，只有站点和工作级别的 左* 查询都开启后，监控器才可进行 左* 查询。否则日志查看器若配置 左* 查询，跳转到监控器会查询报错。

Copy as cURL¶

日志查看器支持通过命令行形式来获取日志数据。在日志数据列表右侧设置，点击 Copy as cURL 即可复制 cURL 命令行，前往主机终端执行该命令，从可获取当前时间段内相关筛选及搜索条件下的日志数据。

示例

复制 cURL 命令行后，如下图所示：其中 <Endpoint> 需替换为域名，<DF-API-KEY> 需前往 API 管理 更换为 Key ID。

关于更多相关参数说明，可参考 DQL 数据查询。

关于 API 更多信息，可参考 Open API。

curl '<Endpoint>/api/v1/df/query_data?search_after=\[1680226330509,8572,"L_1680226330509_cgj4hqbrhi85kl1m6os0"\]&queries_body=%7B%22queries%22:\[%7B%22uuid%22:%222eb41760-cf6e-11ed-a983-7d559044c3fc%22,%22qtype%22:%22dql%22,%22query%22:%7B%22q%22:%22L::re(%60.*%60):(%60*%60)%7B+%60index%60+IN+\[%27default%27\]+%7D%22,%22highlight%22:true,%22limit%22:50,%22orderby%22:\[%7B%22time%22:%22desc%22%7D\],%22_funcList%22:\[\],%22funcList%22:\[\],%22disableMultipleField%22:false,%22disable_slimit%22:false,%22is_optimized%22:true,%22offset%22:0,%22search_after%22:\[1680226330509,8572,%22L_1680226330509_cgj4hqbrhi85kl1m6os0%22\],%22timeRange%22:\[1680187562081,1680230762081\],%22tz%22:%22Asia%2FShanghai%22%7D%7D\]%7D' \
- H 'DF-API-KEY: <DF-API-KEY>' \
- -compressed \
- -insecure

注意：仅标准成员及以上可进行复制命令行操作。

除该导出路径外，您还可采用其他日志数据导出方式。

设置状态颜色¶

观测云为状态值已经设置了系统默认颜色。如您需要修改不同的状态下，对应数据在查看器中显示的颜色，可通过点击设置状态颜色进行修改。

格式化配置¶

注意：仅管理员及以上可进行查看器格式化配置。

格式化配置可以让您隐藏敏感日志数据内容或者突出需要查看的日志数据内容，还可以通过替换原有日志内容进行快速筛选。

点击查看器列表右上角的设置，点击格式化配置，即可添加映射，输入以下内容，点击保存，即可把含 “DEGUB” 的原日志内容替换成您想显示的格式。

• 字段：如内容
• 匹配方式：如 match（目前支持=、!=、match、not match）
• 匹配内容：如 DEBUG
• 显示为内容：如 ******

日志数据导出¶

在日志中，您可以先筛选出想要的日志数据，再通过 导出后进行查看和分析，支持导出到 CSV 文件或者仪表板和笔记。

如果需要导出某条日志数据，打开该条日志详情页，点击右上角 图标即可。

日志颜色高亮¶

为了让您能更快的的获取日志的重点数据信息，观测云采用不同的颜色高亮日志的不同内容，分成浅色和深色两种主题颜色。

注意：如果在搜索栏对日志进行搜索时，返回的列表仅保留匹配到的关键词的高亮显示。

日志单行展开复制¶

点击 至某条日志内容，可展开查看日志的全部内容；

点击 按钮可复制整条日志内容。日志内容展开时，若支持 JSON 展示，会将该条日志以 JSON 格式展示，若不支持则正常展示该日志内容。

日志多行浏览¶

观测云的日志数据列表默认为您展示日志的触发时间和内容。您可以在查看器显示列中选择日志显示 “1 行”、“3 行”、“10 行”和全部来查看完整的日志内容。