搜索

可以在几个主要的sentry视图上进行搜索：问题、事件和发布。

注意 Discover是Sentry用于聚合原始事件数据的强大查询构建器，它有自己独特的语法（这里不介绍）。有关更多信息，请参阅完整的发现文档。

语法

查询是使用key:value模式，最后是可选的原始搜索。每个key:value对是一个令牌，可选的原始搜索本身就是一个令牌。这个key:value对令牌被视为问题或事件属性。可选的原始搜索被视为单个令牌，并搜索事件标题/消息。

例如：

is:resolved user.username:"Jane Doe" server:web-8 example error

在上面的例子中，有三个键（(is:, user.username:, server:），但有四个令牌：

is:resolved
user.username:"Jane Doe"
server:web-8
example error 标记is:resolved析和 user.username:"Jane Doe" 是标准的搜索标记，因为它们都使用保留关键字。有关适当的关键字用法，请参阅问题属性和事件属性。server:web-8是指向Sentry SDK发送的自定义标记。有关如何设置标记的详细信息，请参见自定义标记。

令牌示例错误使用可选的原始搜索，并作为问题搜索查询的一部分传递（该查询使用类似于SQL的CONTAINS匹配）。当使用可选的原始搜索时，可以提供一个字符串，而查询使用整个字符串。

显式标记语法

我们建议您不要使用保留关键字（如项目id）作为标记。但如果是，则必须使用以下语法进行搜索：

tags[project_id]:tag_value

高级的

注意高级搜索可用于新开发人员、团队和业务计划的组织。

排除

默认情况下，搜索项是AND-ed在一起的；它们返回与所有搜索项匹配的问题/事件的交集。

若要更改此项，可以使用否定运算符！排除搜索参数。

is:unresolved !user.email:example@customer.com

在上面的示例中，搜索查询返回所有未解决且未影响电子邮件地址用户的问题example@customer.com。

通配符

搜索支持通配符*作为特定字符和字符串的占位符。

browser:"Safari 11*"

在上面的示例中，搜索查询将匹配浏览器值，如“Safari 11.0.2”、“Safari 11.0.3”等。

您还可以组合如下运算符：

!message:"*Timeout"

在上面的示例中，搜索查询返回的结果没有消息值，如ConnectionTimeout、ReadTimeout等。

搜索属性

在上面的示例中，我们突出显示了几个可以搜索的示例属性：is、user、server、browser等。下面是所有可用搜索词的规范列表。

问题属性

问题是一个或多个事件的集合。可搜索属性包括工作流状态、工作分配、聚合计数和期限。

以下是为sentry保留和已知的问题级别令牌的列表：

age 将结果限制为自年龄以来创建的问题。语法与Unix find命令类似：
- 最近24小时内发布的新内容：age:-24h
- 超过12小时的问题：age:+12h
- 12至24小时前产生的问题：age:+12h age:-24h
- 年龄：+12h年龄：24小时
- 支持的后缀：m->分钟h->小时d->天w->周
assigned

对分配问题的用户进行筛选。

值可以是您的用户ID（电子邮件地址）、您的“我”或“团队名称”。

bookmarks

筛选为问题添加书签的用户。

值可以是您的用户ID（电子邮件地址）或您自己的“我”。

first-release

将结果限制为在给定版本中首次看到的问题。

与发行版的版本完全匹配，或者首先-发布：最新到选择最新版本。

将结果限制为对标记具有任何值的问题。 has:user

筛选问题的状态。

值被解析、未解析、忽略、分配和未分配。(resolved, unresolved, ignored, assigned, and unassigned.)

lastSeen

限制在给定时间点之后或之前最后看到的结果。用法与age标记类似（见上文）。

上次出现在30天前或更久之前的问题：lastSeen:+30d

上次查看时间：+30d

最近两天内最后看到的问题：lastSeen:-2d

status

筛选问题的状态。

值被解析、未解析和忽略。(resolved, unresolved, and ignored.)

timesSeen

将结果限制为至少或最多某些次数看到的问题。

完全匹配：timesSeen:10

上限或下限：

timesSeen：>10

timesSeen：>=10

timesSeen：<10

timesSeen：<=10

事件属性

事件是使用Sentry sdk（读取：错误和异常）捕获的底层事件数据。

在问题搜索中搜索事件属性时，问题搜索将返回具有与提供的事件筛选器匹配的一个或多个事件的任何问题。

以下是为sentry保留和已知的事件级令牌列表：

将结果限制为由地理区域触发的事件。

geo.country_code
geo.region
geo.city

将结果限制为使用给定版本标记的事件。与版本完全匹配，或发布：最新到选择最新版本。

release

将结果限制为影响给定用户的事件。

user.id
user.email
user.username
user.ip

将结果限制为在给定时间戳发生的事件。此筛选器可以通过两次以提供范围。

event.timestamp

2016年1月2日发生的事件：event.timestamp:2016-01-02

01:00到02:00（UTC）之间的事件：event.timestamp:>=2016-01-02T01:00:00 event.timestamp:<2016-01-02T02:00:00

提供以下比较运算符：

大于（>）
大于或等于（>=）
小于（<）
小于或等于（<=）

将结果限制为使用特定设备属性标记的事件。

device.arch
device.brand
device.locale
device.model_id
device.orientation
device.uuid

将结果限制为使用特定操作系统属性标记的事件。

message
os.build
os.kernel_version

将结果限制为具有匹配堆栈属性的事件。

stack.abs_path
stack.filename
stack.function
stack.module
stack.stack_level

自定义标记

此外，可以使用指定为标记的任何标记。标记是分配给事件的各种键/值对，以后可以将它们用作查找相关事件的细分或快速访问。

大多数sdk通常通过配置作用域来支持配置标记.

标记的几种常见用途包括：

服务器的主机名
平台的版本（例如，iOS 5.0）
用户的语言

有关详细信息，请参阅有关标记事件的完整文档。

预编码搜索

预先定义的搜索是常见的搜索词，我们认为您可能会使用。预先制作的搜索将按您最近使用它们的顺序显示。

固定搜索

您可以锁定搜索，它将成为您在“问题”视图中看到的默认视图。固定搜索仅对您可见，并且与您的项目相关。

在搜索栏中键入搜索。

单击该搜索旁边的pin图标。

一旦锁定，sentry将把搜索添加到保存的搜索下拉列表中。文本中的搜索标签将显示为：我的固定搜索。

更改固定搜索

要更改固定搜索，请执行以下操作：

选择您的固定搜索。取消单击pin图标。默认搜索将返回：unresolved。
再找一次。单击pin图标。列为“My Pinned Search”的查询现在将是新的Pinned查询，而不是原来的查询。

固定预先制作的搜索

您可以像锁定任何其他搜索一样锁定预先定义的搜索。当您选择了预编码搜索，并且预编码搜索查询填充搜索栏时，请固定它。

组织范围内保存的搜索

创建组织范围内保存的搜索

所有者和管理者可以通过创建自定义保存的搜索来为其组织创建持久视图。这些保存的搜索不会与特定项目关联，而是与整个组织中的所有项目（和用户）关联。

在搜索栏中键入搜索，然后单击右侧的“添加到组织保存的搜索”图标。请记住，要使用此功能，您需要是组织内的所有者或管理者。
在结果模式中命名搜索并单击“保存”
视图将成为保存的搜索下拉列表的一部分。

删除组织范围内保存的搜索

当所有者或管理者将鼠标悬停在自定义保存的搜索上时，他们应该会看到垃圾箱图标。垃圾桶图标的功能与您预期的完全一样，并从下拉列表中删除自定义保存的搜索。

sentry 工作流和集成之搜索（翻译）

搜索

语法