互联网技术 / 互联网资讯 · 2024年3月11日

Discover 数据查询分析引擎概览

Discover 查询、预置查询、已保存查询、构建新查询、搜索查询、排序查询、编辑查询、共享查询、删除查询、查询结果、事件详情、查询生成器等功能构成了完整的查询工作流。按全局选择、标题过滤、按搜索条件过滤、按字段筛选、按表列过滤以及叠加函数等选项帮助您精确定位数据并快速得到所需视图。

Discover 通过构建和丰富错误数据,提供跨环境的数据可见性。您可以查询系统健康状况的洞察,并在一个地方获得关键业务问题的答案。

Discover 数据查询分析引擎概览

主页视图聚合了所有已保存和预构建查询,便于快速定位关注区域。例如若在最近 24 小时内出现错误查询的峰值,用户可以先进行调查。每个查询以卡片形式呈现,显示数据摘要。

显示名称、搜索条件、创建者、图表快照、日期范围、最后编辑、预置查询等信息在卡片中展示。

带有图标的查询卡通常为预构建,不能移除。

All Events 提供跨项目的原始错误流查看能力这一特性取代了早期的事件功能,允许添加列并调整分组以实现所需细分。Errors by TITle 按原始错误总数和受影响用户数显示最常见错误。Errors by URL 展示产生最多错误和问题类型的页面。提醒:问题是一组指纹事件。相关指纹文档可供参考。

已保存查询显示了经用户保存的查询条目。带有头像的查询卡表示来自创建者的保存查询,组织内的任何人都可查看并使用,且与帐户无关。

构建新查询的方式在 Discover 主页提供三种路径。点击 Build a new query,通过现有查询卡的省略号进入 Duplicate,打开任一现有查询,点击右上角 Save as 输入显示名称 点击 Save 即可。

应用新的搜索条件或表列来修改查询结果。保存查询并分配自定义显示名称。关于查询生成器的更多信息,请参阅相关文档。

搜索查询 需要查找特定查询时可使用主页上的搜索栏来定位查询名称。

排序查询 右上角的下拉菜单允许按属性进行排序。

最近编辑 Recently Edited、我的查询 My Queries、查询名称 Query Name、创建日期 Created、最过时 Most outdated 等字段一并呈现。

编辑查询 时如需对现有查询进行修改,请进入查询后在右上角保存或更新查询,编辑条件不会自动保存。

分享查询 你可以随时分享你的查询。与同一组织内有权限的其他用户共享 URL,查询结果和 URL 会随查询构建而更新,便于通过邮件、聊天等方式传播。

删除查询 在 Discover 主页的查询卡上有省略号可打开上下文菜单,执行删除操作此动作不可逆。也可在查询结果视图中通过右上角垃圾桶删除查询。

查询结果

Discover 数据查询分析引擎概览

要查看查询结果,单击任一查询卡。您将看到图表、表格以及可切换的摘要标签。顶部的搜索栏显示输入的搜索条件,表格展示具备可排序列的事件数据。

每个表格单元格都有一个动态上下文菜单,您可通过该菜单在搜索栏或表格列中继续探索数据的细分。您可以添加或排除过滤值、查看底层问题堆栈等操作。

Discover 数据查询分析引擎概览

若第一列显示图标表示事件已堆叠,点击图标可展开完整事件列表。每个事件有一个 event ID 可点击了解更多信息。关于查询构建的更多信息,请参阅查询生成器文档。

事件详情

Discover 数据查询分析引擎概览

从 Discover 导航至事件详情页面,您将看到关于单个事件的所有相关信息。对每个事件,您会看到 ID、时间戳及查看 Sentry 收到的规范化 JSON payload 的链接。

事件详情视图因事件类型而异,事务事件可能与错误事件展示完全不同。某些情况下错误会在侧栏显示相关问题,您可以快速浏览问题的事件量,并导航到相关问题。视图中还包含堆栈跟踪、面包屑等信息。

查询生成器

从 Discover 主页可通过三种方式构建查询。点击 Build a new query、进入现有查询并 Duplicate、使用 Save as 保存为新查询。

有四个主要构建块会影响已保存查询的结果,组合使用可缩小搜索范围。

Global Selection Header、Search Conditions、Interactive Graph、Table Columns 等元素构成按全局选择过滤的核心。页面顶部可指定放大项环境与日期范围,这在 Sentry 的其他部分也有顶级过滤器。

按搜索条件过滤 所有事件都带有内置字段或自定义标签,使用搜索栏输入键并分配值以过滤事件列表。这些是内置的 key fields。

General 字段包括 id、Issue.id、Message、project.id、Release、Release.package、Release.version、Release.build、tITle、platform.name、environment、event.type、location、timestamp、timeStamp.to_hour、timeStamp.to_day、Device 等字段以及设备相关信息、Geo、HTTP、OS、SDK、Stack、Error、User、User.attributes、User.email、User.id、User.name、User.username、User.IP 等项以及语法字段。

查询生成器语法与 Sentry 的搜索语法一致。输入字段后可使用引用的语法,例如 count() 表示事件发生次数。示例写法如下: count():99

完全匹配等于、上限、小于等不同边界的用法可通过 count():>99、count():>=99、count():<20 等形式表达,多个边界之间使用 AND/OR 条件。注意 OR 不能用于聚合与非聚合过滤器之间。

也可以通过将值放在列表中来搜索同一 key 的多个值,例如 x:[value1, value2] 将返回 x:value1 OR x:value2 的结果。更多信息请参阅同键多值的内容。

tag SuMMaRy 过滤 每个事件都带有标签值列表,标签摘要可视化为按频率排序的前 10 个 key。最常见的标签值直接显示在说明和百分比区域。将鼠标悬停可查看该标签的确切分布。

单击上述区域中的任意部分以进一步优化搜索,例如单击浏览器栏中的 Chrome 部分即可将 Chrome 添加到搜索条件中的 tag SuMMaRy。

Discover 数据查询分析引擎概览

按交互式图表过滤 每个查询都带有交互式图表,可放大调查区域。您还可以自定义显示选项和 Y 轴设置,相关选项会与查询一起保存。

显示选项 TOTAl Period、Previous Period、Release Markers、Top 5 Period、Total Daily、Top 5 Daily、Y 轴选项、Count、Average、Transaction Duration、p75、p95、Unique User Count 等。

按表列过滤 在表格顶部点击列名可打开模态框,显示结果表中的所有列,您可以添加、删除、移动列以及堆叠字段。若开启堆叠,按相同值将事件进行分组显示。

叠加函数 avg(…)、count(…)、count_unique(…)、Max(…)、Min(…)、sum(…) 等允许对列进行聚合。需要为函数分配参数,某些参数为必需。未应用任何函数时,事件将逐条列出。完成列编辑后点击应用,结果在查询结果中更新。列若过多可能导致表格横向滚动。

单元格过滤 表格中每个单元格在悬停时会显示省略号,打开上下文菜单后可以进行附加过滤。例如可通过点击将某些交易定位到搜索条件栏。

Discover 数据查询分析引擎概览

添加方程式 你还可以使用表列作为方程式变量来扩展查询结果,更多信息见添加查询方程式的文档。

https://docs.sentry.io/ProdUCt/discOVeR-queRies/queRy-builder/queRy-equations/

排序列 单击要排序的列标题,向下箭头表示降序,向上箭头表示升序,表格可能因此刷新。

其他查询操作 编辑查询 如需修改请进入查询并保存更新,查询条件编辑不会自动保存。

要重命名已保存的查询,请单击标题旁的铅笔图标输入显示名称,按 Enter 或区域外确认。

分享查询 随时分享您的疑问,与同一组织中有权限的其他用户共享 URL,查询各部分构建过程中的结果和 URL 将更新,方便在邮件、聊天等中分享正在进行的搜索。

导出 CSV 如需导出数据,请点击 ExporT 以获取 CSV 文件。对于较大导出,准备就绪后您将收到包含下载链接的邮件,并在下载页面完成验证。验证过程包括文件的 SHA1 校验和,您可以使用相应命令进行校验,例如 echo | sha1sum -c -。数据量大小会影响等待时间,结果通常限于 1000 万行或 1GB 以先到者为准。