显示事件

设置并筛选关于 CDF 事件的查询，并在 Grafana 仪表板上的图表中注释事件。你可以根据自己的需要自定义时间范围、要显示的事件以及列。

处理表格中的事件

在 Grafana 中打开事件选项卡，以处理表格中的事件。

定义查询

events 查询使用 events/list 端点检索数据。

格式：events{someFilter=number, otherFilter="string"}

示例：

events{externalIdPrefix='WORKORDER', assetSubtreeIds=[{id=12}, {externalId='ext_id'}]}

你可以使用这些属性进行筛选： externalIdPrefix、metadata、assetIds、assetExternalIds、rootAssetIds、assetSubtreeIds、dataSetIds、source、type 和 subtype。

默认情况下，查询会返回该时间范围内的活动事件，但是你可以使用以下附加时间筛选器自定义查询：startTime、endTime、activeAtTime、createdTime 和 lastUpdatedTime。

此示例返回在当前时间范围内开始的所有已完成事件：

events{startTime={min=$__from}, endTime={isNull=false}}

此示例仅返回已完成事件：

events{endTime={isNull=false}}

客户端筛选

使用 =~、!~ 和 != 运算符指定更多客户端筛选。多个筛选器之间的逗号充当逻辑 AND。

格式：

• =~ - 正则表达式等式。返回满足正则表达式的结果。

• !~ - 正则表达式不等式。排除满足正则表达式的结果。

• != - 严格不等式。返回其属性不等于指定值的项。

示例：

events{type='WORKORDER', subtype=~'SUB.*'}

注意

切勿使用客户端筛选器作为主要筛选方法。 从 CDF 返回项之后 Grafana 应用筛选器，如果 CDF 返回了最大数量的项 (1000)，你可能不会看到全部数据。

创建模板

使用 $variable_name 语法创建模板。

示例：

events{type='WORKORDER', subtype=$variable}

重命名和组织字段

选择转换选项卡以重命名和组织字段。

用事件注释图表

在 Grafana 中使用注释覆盖来自图上 CDF 的富事件信息。

1. 导航到仪表板的设置，然后选择注释。
2. 在数据来源字段中选择你的 CDF 项目。

1. 指定查询以从 CDF 获取和筛选事件。例如：

   events{type="some", subtype=~"sub.*"}

   上面的查询请求包含参数 type="some" 的事件，并按匹配 sub.* 的 subtype 筛选结果。

   • 如需有效参数的完整列表，请参阅 API 文档。

   • 学习如何筛选结果。