插件 〉OSIsoft-PI


开发者

Grid Protection Alliance

注册接收不定期产品新闻和更新



数据源
社区

OSIsoft-PI

  • 概览
  • 安装
  • 变更日志
  • 相关内容

Grafana 的 PI Web API 数据源

此数据源通过 PI Web API 提供对 OSIsoft PI 和 PI-AF 数据的访问。

display

使用

数据源配置

从 Grafana 数据源管理页面创建新的数据源实例。

建议使用“代理”访问设置。您可能需要在 PIWebAPI 服务器配置中添加“Basic”身份验证,并在数据源设置中添加凭据。

注意:如果您正在使用 PI-Coresight,建议创建一个新的 PI Web API 实例与此插件配合使用。

查看 PI Web API 文档 以获取更多关于配置 PI Web API 的信息。

通过 PI Asset Framework 查询

elements_and_attributes.png

  1. 验证 PI Point Search 开关是否为灰色(关闭状态)
  2. Element 中点击 Select AF Database 并在列表中选择所需的数据库
    • 应出现一个新的 UI 片段:Select AF Element
    • 当前存在一个已知 bug,该新的 UI 片段会失败。在这种情况下,选择 Attributes 中的 +,它将强制创建 UI 片段
  3. 点击 Select AF Element 并选择所需的 AF 元素
  4. 重复步骤 3 直到找到所需元素
  5. Attributes 下点击 + 图标列出所选元素中的属性;从下拉列表中选择属性
    • 如果属性列表未出现,开始输入属性名称,属性应出现
    • 此方法也可用于过滤长属性列表
  6. 根据需要多次重复步骤 5

通过 PI Dataserver (PI Points) 查询

pi_point_query.png

  1. 开启 Pi Point Search 开关
  2. Data Server 下点击 Select Dataserver 并选择所需的 PI Dataserver
  3. PI Points 下点击 + 图标打开文本输入字段
  4. 输入所需 PI Point 的确切名称;它不区分大小写 (sinusoid === SINUSOID === sInUsOiD)
  5. 根据需要多次重复步骤 3 - 4 以添加多个 PI Point

模板变量

仅支持子元素作为模板变量。目前,查询界面需要 JSON 查询。

配置示例如下所示。
{"path": "PISERVER\\DatabaseName\\ElementNameWithChildren"}

template_setup_1.png

事件帧和注释

此数据源可以使用 AF 事件帧 作为注释。

event-frame

创建一个注释查询,并使用事件帧类别作为查询字符串。支持颜色和名称的正则表达式替换字符串。

例如
annotations

安装

使用 grafana-cli 工具安装,或将仓库直接克隆到您的 Grafana 插件目录中。

grafana-cli plugins install gridprotectionalliance-osisoftpi-datasource

商标

所有产品名称、标识和品牌均为其各自所有者的财产。本网站使用的所有公司、产品和服务名称仅用于识别目的。使用这些名称、标识和品牌并不意味着认可。

OSIsoft、OSIsoft 徽标和标志以及 PI Web API 均为 AVEVA Group plc 的商标。

在 Grafana Cloud 上安装 OSIsoft-PI

有关更多信息,请访问文档,了解 插件安装

变更日志

1.0.0

  • 首次发布。

2.0.0

  • 迁移到基于 React 的框架。

3.1.0

  • 为 PI Points 添加了计算功能
  • 添加了 PI point 配置(感谢 @TheFern2)
  • 添加了使用 PiWebAPI 返回的最后值选项
  • 更新到 Grafana plugin SDK v9.3.6

4.0.0

  • 添加了新的 dataframe 标签格式。可以在配置页面中禁用以实现向后兼容性
  • 为 Dataframe 字段添加了工程单位。可以在配置页面中全局禁用此功能
  • 使用 PIWebAPI 批量端点优化了查询
  • 改进了原始查询处理
  • 在原始查询中添加了变量支持
  • 修复了注释支持
  • 更新到 Grafana plugin SDK v9.4.7
  • 修复了 PI AF 计算
  • 添加了插件截图

4.1.0

  • 修改了选择计算时使用的 PI Webapi 控制器端点
  • 选择最后一个值选项时允许计算
  • 选择计算时,将标签从 Interpolated 更改为 Interval
  • 修复了 Element Path 中变量的问题

4.2.0

  • 修复了仅显示奇数属性的问题
  • 修复了获取 afServerWebId 时的问题

5.0.0

  • 后端迁移到 Go 语言
  • 更改了查询编辑器布局
  • 支持 Grafana 11 版本
  • 放弃对 Grafana 8.x 和 9.x 的支持

5.1.0

  • 为新格式添加了单位和描述 - 问题 #154

  • 修复了数字状态 - 问题 #159

  • 修复了摘要数据 - 问题 #160

  • 修复了记录最大点数中的错误 - 问题 #162

  • 修复了从旧版本迁移时摘要数据的问题 - 问题 $160

  • 更新了查询编辑器布局

  • 在记录值中添加了边界类型支持

  • 识别元素中变量的部分使用

  • 添加了在面板中隐藏 API 错误的配置

  • 将 grafana 日期时间选择器的时间截断到秒

  • 修复了部署期间的警告

  • 修复了 LICENSE 文件

5.2.0

  • 通过将面板中的所有查询合并到一个批量请求中,提高了对 PiWebAPI 的查询性能

  • 更改了查询编辑器布局

  • 将 WebID 缓存从 1 小时增加到 12 小时并使其可配置

  • 添加了实验性功能,可在请求 PiWebAPI 失败时缓存最新响应