插件 〉OSIsoft-PI
OSIsoft-PI
Grafana 的 PI Web API 数据源
此数据源通过 PI Web API 提供对 OSIsoft PI 和 PI-AF 数据的访问。
使用
数据源配置
从 Grafana 数据源管理页面创建新的数据源实例。
建议使用“代理”访问设置。您可能需要在 PIWebAPI 服务器配置中添加“Basic”身份验证,并在数据源设置中添加凭据。
注意:如果您正在使用 PI-Coresight,建议创建一个新的 PI Web API 实例与此插件配合使用。
查看 PI Web API 文档 以获取更多关于配置 PI Web API 的信息。
通过 PI Asset Framework 查询
- 验证
PI Point Search
开关是否为灰色(关闭状态) - 在
Element
中点击Select AF Database
并在列表中选择所需的数据库- 应出现一个新的 UI 片段:
Select AF Element
- 当前存在一个已知 bug,该新的 UI 片段会失败。在这种情况下,选择
Attributes
中的+
,它将强制创建 UI 片段
- 应出现一个新的 UI 片段:
- 点击
Select AF Element
并选择所需的 AF 元素 - 重复步骤 3 直到找到所需元素
- 在
Attributes
下点击+
图标列出所选元素中的属性;从下拉列表中选择属性- 如果属性列表未出现,开始输入属性名称,属性应出现
- 此方法也可用于过滤长属性列表
- 根据需要多次重复步骤 5
通过 PI Dataserver (PI Points) 查询
- 开启
Pi Point Search
开关 - 在
Data Server
下点击Select Dataserver
并选择所需的 PI Dataserver - 在
PI Points
下点击+
图标打开文本输入字段 - 输入所需 PI Point 的确切名称;它不区分大小写 (
sinusoid
===SINUSOID
===sInUsOiD
) - 根据需要多次重复步骤 3 - 4 以添加多个 PI Point
模板变量
仅支持子元素作为模板变量。目前,查询界面需要 JSON 查询。
配置示例如下所示。{"path": "PISERVER\\DatabaseName\\ElementNameWithChildren"}
事件帧和注释
此数据源可以使用 AF 事件帧 作为注释。
创建一个注释查询,并使用事件帧类别作为查询字符串。支持颜色和名称的正则表达式替换字符串。
例如
安装
使用 grafana-cli 工具安装,或将仓库直接克隆到您的 Grafana 插件目录中。
grafana-cli plugins install gridprotectionalliance-osisoftpi-datasource
商标
所有产品名称、标识和品牌均为其各自所有者的财产。本网站使用的所有公司、产品和服务名称仅用于识别目的。使用这些名称、标识和品牌并不意味着认可。
OSIsoft、OSIsoft 徽标和标志以及 PI Web API 均为 AVEVA Group plc 的商标。
在 Grafana Cloud 上安装 OSIsoft-PI
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
在 Grafana Cloud 实例上安装插件是一键式操作;更新也一样。很酷吧?
请注意,插件可能需要长达 1 分钟才能在您的 Grafana 中显示。
有关更多信息,请访问文档,了解 插件安装。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但在 Grafana 中有可用更新时,您将收到通知。
1. 安装数据源
使用 grafana-cli 工具从命令行安装 OSIsoft-PI
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认路径为 /var/lib/grafana/plugins。有关 CLI 工具的更多信息。
2. 配置数据源
从 Grafana 主菜单访问,“数据源”部分中可以立即添加新安装的数据源。
接下来,点击右上角的“添加数据源”按钮。数据源将在 类型 选择框中可用。
要查看已安装数据源列表,点击主菜单中的 插件 项。核心数据源和已安装数据源都会显示。
变更日志
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 失败时缓存最新响应