openHistorian 的 Grafana 数据源插件

此 Grafana 数据源插件提供对 openHistorian 的访问权限——这是一个为快速高效存储和检索而优化的、高性能时间序列数据存储。它由 GridProtectionAlliance 构建，openHistorian 是一个用于过程控制数据（如 SCADA、同步相量、数字故障记录仪和其他重要时间序列数据）的归档和可视化平台。

新特性

从插件的先前版本升级到 v2.1.0 可能会导致各种仪表盘中断。我们建议按照以下流程来维持全部功能。

1. 识别所有使用 openHistorian 数据源的查询。
2. 将识别出的查询切换到“文本模式”。
3. 将文本框的内容复制到文本编辑器中。
4. 更新插件。
5. 将查询切换为使用新的数据源。
6. 将模式切换到文本。
7. 粘贴第 (3) 步中的相应内容。
   请注意，先前版本中的所有功能在 v2.1.0 中也可用。

• 简化查询构建：我们将 Element List Builder 和 Filter Expression Query Builder 合并到一个直观的界面中，可通过 Query Wizard 访问。查询向导模式提供了一个引导式体验，用于通过信号搜索或过滤器表达式构建来创建查询，包含带有详细参数分解的函数选择器，以及用于包含峰值、丢弃空序列等的有用开关。
• 元数据选择：元数据现在可以与查询到的数据结合使用，以支持自定义面板，例如 Geomap 插件。
• 多种数据源值类型：现在支持多种数据源值类型。除了标准的 DataSourceValue 类型（由 Value 和 Times 组成）之外，自定义类型（如 PhasorValue 类型，由 Magnitude 和 Angle 值以及一个 Time 组成）也可用了。
• 可扩展函数：openHistorian 的后端 Grafana 适配器现在支持用户定义的自定义函数。
• 性能改进：所有操作，包括数据查询和函数处理，都采用异步方式处理。

用法

使用 openHistorian Grafana 数据源构建指标查询首先需要在两种模式之间进行选择：“查询向导模式”或“文本编辑器模式”。

查询向导模式

“查询向导”模式用于选择要趋势化的序列。此引导式向导允许通过直接标签选择或使用 FILTER 表达式以及用户友好界面来构建指标选择查询，并提供控制查询数据粒度和细节的选项。行为查询设置包括 Drop Empty Series、Include Peaks、Full Resolution Data 和 Radial Geo Distribution。此外，向导还允许选择可用函数，并提供所有必需和可选参数的详细说明。

文本编辑器模式

对于更直接的方式，“文本编辑器”模式允许直接输入查询表达式，您可以自由地以原始形式编写和编辑查询。

注意：在 Query Wizard 和 Text Editor 模式之间的切换是无缝的，切换时会保留您的表达式。但是，在 Text Editor 模式下所做的手动编辑不会反映回 Query Wizard 模式。

手动查询

• 直接标签指定：直接输入点标签、GUID 或测量键。
• 过滤器表达式：利用类似 SQL 的语法进行动态和复杂查询。
• 组合表达式：将直接指定与过滤器表达式混合搭配，实现精细控制。

过滤器表达式

过滤器表达式使用类似 SQL 的语法。例如，以下表达式将选择名称以 *SHELBY* 开头的任何设备的前 5 个遇到的时间序列指标

FILTER TOP 5 ActiveMeasurements WHERE Device LIKE 'SHELBY%'

查询向导中的过滤器构建器

序列函数

一系列函数，例如 Average、StandardDeviation 等，可用于对选定的数据序列执行计算。函数可以轻松地在 Query Wizard 模式或 Text Editor 模式下应用。此外，许多函数支持按时间片或对整个序列集进行分组操作。

详情请参阅 GSF Grafana 函数，了解更多详情和可用函数的完整列表。

查询向导中的函数选择

元数据选择

查询结果现在可以轻松与元数据结合。例如，选择 Longitude 和 Latitude 元数据将为地图提供地理坐标

告警注释

时间序列告警可以通过注释查询进行可视化，以便立即了解 #ClearedAlarms 和 #RaisedAlarms（或仅 #Alarms 表示已清除和已触发的告警），从而提供对序列数据质量的洞察。

还支持配置的时间序列告警的过滤器表达式，例如

FILTER TOP 10 ClearedAlarms WHERE Severity >= 500 AND TagName LIKE '%DEVICE1%'

或

FILTER RaisedAlarms WHERE Description LIKE '%High Frequency%'

参见 Alarms 表定义，了解 ClearedAlarms 和 RaisedAlarms 数据集中的可用查询字段。请注意，目前用户指定的告警注释查询不支持序列函数。

所有注释查询在内部都作为来自数据源的未抽样、全分辨率数据执行，以确保指定查询范围内不会跳过任何告警值。尽管此操作产生最准确的查询结果，但其使用增加了数据源的查询负担 – 因此，使用告警注释进行长时间范围的查询可能会影响整体仪表盘性能。

配置

配置您的数据源非常简单，支持 openHistorian 2.0 及更高版本。与 Grafana 的无缝集成使得易于设置、身份验证和数据标志排除，以在可视化中获得所需的数据质量。

openHistorian Grafana 数据源既适用于独立的 openHistorian 2.0，也适用于嵌入在 openPDC 等产品中的 openHistorian 1.0。

配置 openHistorian Grafana 数据源通常只需指定 URL 和适当的身份验证选项。所需的身份验证选项取决于 openHistorian Web API 的配置，它可以设置为匿名访问或需要身份验证和/或 SSL。

排除的数据标志

存储在 openHistorian 中的所有时间序列数据都包含 测量状态标志，用于描述归档值的数据质量状态。openHistorian Grafana 数据源具有通过排除指定数据标志来过滤查询数据至所需数据质量状态的功能。

数据源类型

作为数据源配置的一部分，现在可以选择数据源值类型

安装

部署 openHistorian Grafana 数据源非常简单，openHistorian 2.4 及更高版本支持自动启动和用户安全同步。对于独立的 Grafana 实例，可通过 Grafana CLI 工具或直接克隆仓库进行安装。

有关详细安装步骤，请访问官方安装指南。