DQL 语法

概述

本文档介绍如何在 RUM 探索器中使用搜索语法构建查询，以分析用户会话、性能数据和其他关键指标。

基本搜索语法

RUM 探索器的搜索查询由关键词和操作符组成，用于筛选事件数据。

1. 单一关键词

定义: 一个单一关键词是一个独立的单词，例如 error 或 login。

用法: 输入单一关键词将在所有 RUM 事件中搜索包含该词的事件。

示例: 输入 error 将返回所有描述中包含 "error" 的事件。

2. 短语搜索

定义: 使用双引号括起来的词组，例如 "page load"。

用法: 搜索完全匹配的短语。

示例: "page load" 将返回描述中包含完整 "page load" 短语的事件。

3. 属性搜索

用法: 属性名:值，属性搜索对大小写敏感。

示例: url:https://example.com 将筛选出 URL 为 "https://example.com" 的事件。

布尔操作符

使用布尔操作符组合多个条件，支持以下操作符（需大写）：

AND: 表示两个条件必须同时满足。

示例: error AND @status:500 返回状态码为 500 且包含 "error" 的事件。

OR: 表示满足任一条件即可。

示例: error OR warning 返回包含 "error" 或 "warning" 的事件。

NOT: 排除符合条件的项。

示例: error NOT @env:prod 返回包含 "error" 但环境不是 "prod" 的事件。

通配符

*: 表示多字符通配符。

示例: serv* 匹配 "service"、"server" 等。

注意: 通配符仅在非双引号文本中有效，且对属性搜索也适用，如 @url:*example.com。

数值范围搜索

用法: 使用方括号 [ ] 或大括号 { } 指定范围。

[a TO b]: 包含边界值。

{a TO b}: 不包含边界值。

示例: @duration:[100 TO 500] 筛选持续时间在 100 到 500 毫秒之间的事件。

示例查询

查找特定应用的错误事件:

app:shop error

返回应用 "shop" 中包含 "error" 的事件。

筛选特定用户的会话:

usr_id:12345

返回用户 ID 为 "12345" 的所有会话事件。

复杂查询:

url:*datadoghq.com error NOT env:dev

返回 URL 包含 "datadoghq.com" 且包含 "error" 但不是开发环境的事件。

注意事项

大小写敏感: 属性值搜索区分大小写，自由文本搜索不区分。

特殊字符: 如 + - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ #，需使用 \ 转义。

时间范围: 在探索器顶部调整时间范围以限定查询范围。

DQL 语法

DQL 语法#

概述#

基本搜索语法#

1. 单一关键词#

2. 短语搜索#

3. 属性搜索#

布尔操作符#

通配符#

数值范围搜索#

示例查询#

注意事项#

DQL 语法

概述

基本搜索语法

1. 单一关键词

2. 短语搜索

3. 属性搜索

布尔操作符

通配符

数值范围搜索

示例查询

注意事项