查看器的强大之处¶

观测云的查看器可以在基础设施、事件、日志、应用性能监测、用户访问监测、CI 可视化、可用性监测、安全巡检等功能模块内使用。作为数据可观测的重要工具之一，查看器提供多种搜索和筛选方式，并支持以组合的方式搭配使用获取最终数据结果。本文将详细介绍查看器功能，帮助您快速、精准地检索数据，定位故障问题。

搜索¶

文本搜索¶

搜索一般由术语和运算符两部分组成。支持通配符查询，* 表示匹配 0 或多个任意字符，? 表示匹配 1 个任意字符；若要将多个术语组合到一个复杂查询中，可以使用布尔运算符（AND/OR/NOT）连接。其中查看器搜索使用的是 query_string() 查询语法

术语可以是单词或者短语。比如：

• 单个单词：guance；
• 多个单词：guance test；（等同于 guance AND test）
• 短语："guance test"； (使用双引号可以将一组单词转换为短语)

搜索查询示例：

JSON 搜索¶

使用前提：

1. 支持的站点有 中国区 1（杭州）、中国区 3（张家口）、以及 中国区 4（广州）；
2. 工作空间在 2022年6月23日 后创建；
3. 日志查看器中使用。

默认对 message 的内容进行精确检索，同时需要 message 是 JSON 格式，其他格式的日志内容不支持该检索方式。搜索格式为： @key:value，若为多层级 JSON 可用 “.” 承接，即 @key1.key2:value，如图所示。

JSON 搜索示例：

message 信息如下：
{
    __namespace:tracing,
    cluster_name_k8s:k8s-demo,
    meta:{    
        service:ruoyi-mysql-k8s,
        name:mysql.query,
        resource:select dict_code, dict_sort, dict_label, dict_value, dict_type, css_class, list_class, is_default, status, create_by, create_time, remark 
                from sys_dict_data
 }
}

# 查询 cluster_name_k8s = k8s-demo
@cluster_name_k8s:k8s-demo     // 精准匹配
@cluster_name_k8s:k?s*        // 模糊匹配

# 查询 meta 下 service = ruoyi-mysql-k8s
@meta.service:ruoyi-mysql-k8s   // 精准匹配
@meta.service:ruoyi?mysql*   // 模糊匹配

筛选¶

在查看器中，可针对 字段名 和 字段值 进行筛选查询数据。

注意：筛选跟搜索的最大区别是输入内容中是否存在 : 冒号间隔符，若存在则判断作为筛选过滤条件，若不存在即为搜索条件。

运算符说明¶

不同类型的字段支持的运算符有差异，如下所示：

• 字符串字段运算符：=、≠、match、not match、wildcard、not wildcard、exist、not exist、regexp、not regexp；
• 数值字段运算符：=、≠、>、>=、<、<=、[xx TO xx]、exist、not exist。

Wildcard 说明¶

支持 * 或 ? 通配查询, * 表示匹配 0 或多个任意字符，? 表示匹配 1 个任意字符。

值：guanceyun

# 仅使用后缀*匹配，此场景适用于某个值前缀的字符串固定精确，后半部动态变化的情况
attribute:guance*    // * 匹配 yun

# 仅使用 ? 匹配，此场景适用于仅存在个别固定位置字符动态更新情况
attribute:gua?ceyun   // ? 匹配 n

# ? * 叠加使用
attribute:gua?ce*   // ? 匹配 n ,* 匹配 yun

# * 混合使用
attribute:gua*e*   // 第一个 * 匹配 nc ,第二个 * 匹配 yun

特殊字符检索处理¶

在查看器中部分字符具有特殊意义，例如 空格 用于分隔多个单词，所以若检索的内容中包含以下字符需要做特殊处理：空格、:、"、“、\、(、)、[、]、{、}、!。

将文本变成短语¶

1. 在文本两侧加 " 双引号，可以将文本变为短语；
2. 此写法下双引号的内容会作为一个整体发起匹配搜索，通配符不会生效；
3. 若文本中含有 \、"，该方式无法检索，请使用方式二查询。

举例说明：检索的字段名 cmdline，字段值 nginx: worker process：

• 搜索

"nginx: worker process"   //检索成功，精准匹配单词

"nginx * process"   //检索失败，因为双引号中 * 不会被认为是通配符

• 筛选

cmdline:"nginx: worker process"   //检索成功，精准匹配单词

cmdline:"nginx: worker*"  //检索失败，因为双引号中 * 不会被认为是通配符

对字符进行转义¶

1. 需要在特殊字符前添加 \；
2. 若检索的文本中本身有 \ ，搜索和筛选对应的处理方式不同：搜索需要在字符前再加三个 \ 进行转义；筛选只需要加一个 \ 即可。

举例说明：检索的字段名 cmdline，字段值 E:\software_installer\vm\vmware-authd.exe：

• 搜索

E\:\\\\software_installer\\\\vm\\\\vmware-authd.exe     //检索成功，精准匹配单词

E\:\\\\software_installer*exe     //检索成功，通配符模糊匹配

• 筛选

cmdline:E\:\\software_installer\\vm\\vmware-authd.exe    //检索成功，精准匹配单词

cmdline:E\:\\software_installer*exe    //检索成功，通配符模糊匹配

布尔运算符¶

支持以 AND/OR/NOT 的形式进一步组合关联搜索与筛选。

搜索/筛选注意事项¶

分组¶

使用括号 () 提高数据查询条件的优先级，即查询中若存在 () 选中部分搜索、筛选条件则 () 内的查询逻辑优先执行。() 内部的查询优先级仍然按照 NOT > AND > OR 执行。

手写模式¶

支持切换搜索框至「手写模式」 本次手写模式上线覆盖所有查看器（仪表板/自定义查看器除外），新模式下支持 UI 交互添加搜索、筛选条件和手写模式自由切换，不会针对模式切换前的内容做任何变更，真正实现 UI 和手写输入的实时切换还原。

分析模式¶

在查看器分析栏，支持基于数据进行多维度聚合查询分析统计，以反映出数据在不同的维度下，不同时间的分布特征与趋势。

点击分析，即可进入数据图表分析方式，包括时序图、排行榜、饼图和矩形树图。还可选择不同的时间间隔显示数据。

数据显示说明：

• 数据点：数据点是指数据值所在的坐标点。时序图的折线图和面积图将依据所您所选择的时间范围自动聚合为数据点，数据点数量不超过 360 个点；柱状图的数据点数量不超过 60 个；
• 数据范围：数据范围指每一个数据点的取值范围，即以当前数据点的坐标点向前推送至上一个数据点的坐标点为间隔范围，取该范围内数据的值。

图表分析模式下，可参考 操作 来管理图表。

快捷筛选¶

在查看器中支持编辑快捷筛选添加新的筛选字段。支持两种配置方式：空间级筛选项和个人级筛选项。

在快捷筛选支持预设字段，新添加的字段默认为字段管理中的字段类型，若字段管理中没有，则默认为文本格式。

• 点击图示图标，既可收起快捷筛选列：

• 点击下图图标，即可快速添加该字段至数据列表，再次点击即可移除。

相关操作¶

筛选历史¶

观测云支持在筛选历史查看筛选、搜索历史，且能应用于当前工作空间不同的查看器。

• 打开筛选历史：支持通过点击查看器上方搜索栏右侧的图标，或者直接通过快捷键 (Mac OS: shift+cmd+k / Windows: shift+ctrl+k) 快速打开筛选历史；
• 收起筛选历史：点击关闭按钮 x 或者使用 esc 按键可收起筛选历史。

注意：筛选历史仅支持在本地浏览器查看当前用户的筛选、搜索条件。

操作说明¶

在查看器筛选历史最多查看 100 条筛选、搜索条件，支持通过键盘上下切换键（↑ ↓），切换选择筛选、搜索条件，点击键盘 enter 可添加到筛选。

• 固定到筛选：鼠标放在筛选历史，可通过右侧 “固定到筛选” 按钮置顶筛选、搜索条件；
• 添加到筛选：点击筛选、搜索条件，即可添加到查看器进行筛选，支持多选；
• 取消筛选：添加到筛选后，再次点击筛选、搜索条件，即可取消筛选；

• 在不同查看器应用筛选历史：当您在日志 > 查看器浏览了 -source: default 筛选历史（如上图），可在链路等其他查看器的筛选、搜索直接使用。

自动刷新¶

为快速获得实时的查看器数据，观测云在查看器内提供刷新功能。您可进行以下操作：

• 停止自动刷新时，支持点击 手动刷新；

• 开启自动刷新时：
  • 支持选择自动刷新时间，包含 5s/10s/30s/1m/5m/30m/1h；默认选中 30s；
  • 支持点击 手动刷新。

注意：此处的刷新功能的设置与查看器自动刷新互不冲突。

时间控件¶

观测云支持通过时间控件控制当前查看器的数据展示范围，用户可以手动输入时间范围，或快速选择当前查看器的内置时间范围，或通过自定义设置时间范围。

手动输入时间范围¶

时间控件默认支持区间显示，支持点击时间控件查看手动输入时间范围的格式，包括动态时间和静态时间，输入完成后回车或者点击任意空白区域即可按照输入的时间范围筛选查看对应的数据。

快捷筛选时间范围¶

您可以在时间控件点击更多快速选择对应的时间范围进行数据查看。时间控件中预设了多种快捷筛选时间范围，包括下拉列表的 “最近 15 分钟、最近 1 小时、最近 1 天等” 和动态时间的 “30s、45m、3d 等”。

鼠标放在动态时间上，即可和输入框内容进行实时联动，点击即可查看对应时间范围的数据内容。

自定义时间范围¶

除了预设的时间范围以外，您可以在时间控件点击自定义时间选择时间范围，包括日期和具体的时间，点击应用，即可按照自定义的时间范围进行数据筛选。

URL 的时间范围¶

除了时间控件提供的时间范围选择以外，观测云还支持在浏览器的 URL 中直接修改当前工作空间查看器的 time 参数的时间范围进行数据查询，支持秒、分、时、天 4 种单位，如 time=30s、time=20m、time=6h、time=2d 等，如下图所示在浏览器修改 time=2h ，查看器展示最近 2 小时的数据。

锁定时间范围¶

观测云支持在时间控件通过点击 锁定图标，设置固定的查询时间范围，设置完成后，所有的查看器/仪表板均默认显示当前的时间范围。

如下图所示，若锁定时间为 “最近 45 分钟”，则所有的的查看器/仪表板均按照当前锁定时间查询显示 “最近 45 分钟” 的数据。

设置时区¶

观测云支持在时间控件设置当前显示时区，从而切换到对应的工作空间时区查看数据。

进入时间控件 > 时区设置，在修改时区窗口：

• 默认显示 “浏览器时间”，即本地浏览器检测到的时间；
• 在拥有者或管理员设置 “工作空间时区” 后，成员可选择配置好的工作空间时区。

您也可以在 账号管理 进行修改。

查看器自动刷新¶

在观测云工作空间，点击账号，可开启 / 关闭查看器自动刷新。

• 开启：查看器的数据按照时间控件的默认数据刷新时间 30 秒进行自动刷新，如选择最近 15 分钟，按照 30 秒刷新一次显示最近 15 分钟的数据；
• 关闭：查看器的时间控件进入时关闭 30 秒自动刷新，如选择最近 15 分钟，即显示该15分钟绝对时间的内容数据且不再自动刷新，可点击 按钮刷新查看最近 15 分钟的数据。

注意：查看器自动刷新仅对本地浏览器生效。

点击暂停按钮，退出实时数据刷新模式，锁定当前时间范围为绝对时间。

例如：时间范围选择了“最近 15 分钟”，那么当点击 按钮后，查看器的时间范围整体向前调节为 15 分钟。

显示列¶

查看器支持选择显示行数来展开查看日志 message 数据：

• 支持点击显示列自定义添加、编辑、删除、拖动显示列；
• 支持通过键盘上下切换键（↑ ↓ ）选择添加显示列；
• 支持在显示列进行关键字搜索；
• 支持在显示列自定义显示列作为预设字段，后续通过 Pipeline 切割字段并上报数据后可直接显示上报的数据。

时间列¶

若查看器存在时间列，您可以在显示列配置下直接勾选：

添加显示列¶

在查看器显示列，支持输入字段进行匹配搜索，默认选中搜索到的第一个字段，支持通过键盘上下切换键（↑ ↓ ）选择添加显示列。

若输入的字段不存在，支持通过 “分割线” 进行区分，并提示创建并添加显示列，创建后作为预设字段，后续通过 Pipeline 切割字段并上报数据后可直接显示上报的数据。

相关操作¶

在查看器列表，当鼠标放在显示列上时，可点击显示列的 ，您可以对显示列进行以下操作。

若显示列的内容显示不完整，您可拉动右侧分割线来展开该列内容：

保存快照¶

您可以对当前展示的数据进行搜索和筛选、选择时间范围、增加查看列等操作，然后点击查看器左上角的快照小图标，点击保存快照即可保存当前查看器所展示的数据内容。

更多快照使用详情，可参考 快照。

导出¶

在查看器，您可以对当前展示的数据进行搜索和筛选、选择时间范围、增加查看列等操作，然后点击查看器右侧的 ，导出当前查看器所展示的数据内容。您可以导出到 CSV 文件、导出到仪表板以及导出到笔记进行数据查看和分析。

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

导出到 CSV 文件¶

您可以选择导出 1k、5k、10k、50k、100k 的数据数量。

图表¶

• 图表导出：在查看器图表，您可以通过鼠标悬浮至图表，点击导出即可导出或复制图表到仪表板、笔记进行展示和分析；
• 图表时间间隔：在查看器图表，您可以选择图表的时间间隔查看对应的图表数据。

• 收起/展开图表：