插件 〉AWS IoT TwinMaker App
AWS IoT TwinMaker App
适用于 Grafana 的 AWS IoT TwinMaker 应用程序插件
摘要
- 介绍
- 入门
- 文档
- 开发
- 许可
介绍
使用 AWS IoT TwinMaker 构建最终用户 3D 数字孪生应用程序来监控工业运营。AWS IoT TwinMaker 是一项服务,可帮助开发者更快、更轻松地创建真实世界系统的数字副本,从而帮助更多客户实现数字孪生的潜力,以优化运营。
AWS IoT TwinMaker Application Grafana 插件提供了自定义面板、Dashboard 模板和一个数据源,用于连接到您的数字孪生数据。
自定义面板
- 场景查看器
- 视频播放器
Dashboard 模板
- 告警 Dashboard
从 TwinMaker 数据源配置页面导入 Dashboard。参见“Dashboard”选项卡。
要求
- Grafana 8.2.0+
入门
快速入门
在 Grafana Play 中与演示 TwinMaker Dashboard 互动。该 Dashboard 通过可视化 3D 工厂、列出告警、绘制温度传感器历史图和播放视频流来监控曲奇饼干工厂。
安装
本地安装
使用 grafana-cli 工具从命令行安装
grafana-cli plugins install grafana-iot-twinmaker-app
本地 Docker 设置
- 安装 AWS CLI
- 运行
aws configure
并输入您的 IAM 用户凭证 - 运行以下 docker 命令
docker run -d -p 3000:3000 --name=grafana -v ~/.aws:/usr/share/grafana/.aws -e "GF_INSTALL_PLUGINS=grafana-iot-twinmaker-app" grafana/grafana
a. -v ~/.aws:/usr/share/grafana/.aws
将挂载一个包含您机器上配置的凭证的卷,以便您可以为 TwinMaker 数据源使用“AWS SDK Default”身份验证提供程序
- 从浏览器访问 https://:3000。首次登录的用户名为:
admin
,密码为:admin
。
启用应用程序插件
在浏览器中导航到 Grafana 并登录。前往插件列表,搜索 AWS IoT TwinMaker Application 并启用该插件。
配置您的 TwinMaker 数据源。
导入 Dashboard 并开始使用场景查看器和视频播放器面板。
文档
您可以在以下位置找到文档:
开发
如果您有兴趣开发和贡献此项目,请在此处查看 git 仓库中的说明 here。
许可
- Apache 许可证 2.0 版,请参阅 LICENSE。
在 Grafana Cloud 上安装 AWS IoT TwinMaker App
在 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 工具从命令行安装 AWS IoT TwinMaker App
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认为 /var/lib/grafana/plugins。有关 cli 工具的更多信息。
2. 启用
接下来,登录您的 Grafana 实例。导航到 Grafana 主菜单中的插件部分。
在插件部分中点击应用选项卡,然后选择新安装的应用。
要启用该应用,请点击配置选项卡。按照应用提供的说明操作,然后点击启用。该应用及任何新的 UI 页面现在都可以从主菜单中访问,具体取决于应用创建者的设计。
如果应用包含 Dashboard,它们将尝试自动安装。要查看 Dashboard、重新导入或删除单个 Dashboard,请点击应用页面中的Dashboard选项卡。
变更日志
2.0.1
- 杂项:在 #358 中为外部贡献添加标签
- 在 #383 中将 dashboard 工具迁移到 Scenes
- 在 #382 中移除 TwinmakerPanel 查询代码
- 在 #391 中更新 pr-commands.yml
- 在 #390 中使用 vault 生成 token
- 在 #388 中更新 github actions 文件
- 在 #365、#371、#372、#363、#360、#353 中升级 node 依赖项
- 在 #351、#354、#359、#362、#364、#368、#374 中升级 go 依赖项
2.0.0
- 在 #344 中从 grafana/experimental 迁移到 plugin-ui
- Dependabot 配置:在 #331 中忽略 react 和 react-dom 主要更新
- 在 #336 中添加端到端冒烟测试
- 依赖项更新
- 在 #346 中将 github.com/grafana/grafana-plugin-sdk-go 从 0.260.3 升级到 0.261.0 (all-go-dependencies group)
- 在 #341 中升级 all-node-dependencies group (21 次更新)
- 在 #330 中升级 npm_and_yarn group (2 次更新)
- 在 #329 中将 golang.org/x/crypto 从 0.29.0 升级到 0.31.0 (go_modules group)
- 在 #338 中升级 all-go-dependencies group (跨 1 个目录,2 次更新)
- 在 #349 中将 dompurify 升级到 3.2.3
1.18.3
- 依赖项更新
- 在 #325、#326、#315、#316、#312 中更新 Node
- actions/checkout@v3 升级到 actions/checkout@v4
- actions actions/setup-node@v3 升级到 actions/setup-node@v4
- 将 ws 从 8.13.0 升级到 8.18.0
- 将 micromatch 从 4.0.5 升级到 4.0.8
- 将 webpack 从 5.93.0 升级到 5.94.0
- 将 @emotion/css 从 11.11.2 升级到 11.13.5
- 将 @grafana/aws-sdk 从 0.4.1 升级到 0.5.0
- 将 @grafana/data 从 10.4.5 升级到 11.4.0
- 将 @grafana/experimental 从 1.7.12 升级到 2.1.4
- 将 @grafana/runtime 从 10.4.5 升级到 11.4.0
- 将 @grafana/schema 从 10.4.5 升级到 11.4.0
- 将 @grafana/ui 从 10.4.5 升级到 11.4.0
- 将 aws-sdk 从 2.1450.0 升级到 2.1692.0
- 将 cytoscape 从 3.26.0 升级到 3.30.4
- 将 react 从 18.2.0 升级到 18.3.1
- 将 react-dom 从 18.2.0 升级到 18.3.1
- 将 react-router-dom 从 5.3.4 升级到 7.0.2
- 将 react-use 从 17.5.0 升级到 17.5.1
- 将 tslib 从 2.6.3 升级到 2.8.1
- 将 uuid 从 8.3.2 升级到 11.0.3
- 将 @babel/core 从 7.24.9 升级到 7.26.0
- 将 @grafana/eslint-config 从 7.0.0 升级到 8.0.0
- 将 @grafana/tsconfig 从 1.3.0-rc1 升级到 2.0.0
- 将 @swc/core 从 1.6.13 升级到 1.10.1
- 将 @swc/helpers 从 0.5.12 升级到 0.5.15
- 将 @swc/jest 从 0.2.36 升级到 0.2.37
- 将 @testing-library/dom 从 10.3.2 升级到 10.4.0
- 将 @testing-library/jest-dom 从 6.4.6 升级到 6.6.3
- 将 @types/testing-library__jest-dom 从 5.14.9 升级到 6.0.0
- 将 @testing-library/react 从 16.0.0 升级到 16.1.0
- 将 @types/jest 从 29.5.12 升级到 29.5.14
- 将 @types/node 从 20.14.10 升级到 22.10.1
- 将 @types/three 从 0.139.0 升级到 0.170.0
- 将 @types/three 从 0.139.0 升级到 0.170.0
- 将 @types/uuid 从 8.3.4 升级到 10.0.0
- 将 cspell 从 8.11.0 升级到 8.16.1
- 将 eslint-plugin-prettier 从 5.1.3 升级到 5.2.1
- 将 prettier 从 3.3.3 升级到 3.4.2
- 将 sass 从 1.77.8 升级到 1.82.0
- 将 sass-loader 从 14.2.1 升级到 16.0.4
- 将 typescript 从 5.5.3 升级到 5.7.2
- 将 webpack 从 5.94.0 升级到 5.97.1
- 将 webpack-shell-plugin-next 从 2.3.1 升级到 2.3.2
- 将 @types/lodash 从 4.17.10 升级到 4.17.13
- 将 @grafana/plugin-sdk-go 从 v0.260.1 升级到 v0.260.2
- 在 #324、#327 中更新 Go
- 将 github.com/aws/aws-sdk-go 从 1.44.323 升级到 1.55.5
- 将 github.com/grafana/grafana-aws-sdk 从 0.20.0 升级到 0.31.4
- 将 github.com/grafana/grafana-plugin-sdk-go 从 0.240.0 升级到 0.258.0
- 将 github.com/stretchr/testify 从 1.9.0 升级到 1.10.0
- 将 github.com/grafana/grafana-plugin-sdk-go 从 0.258.0 升级到 0.260.1
- 在 #325、#326、#315、#316、#312 中更新 Node
1.18.2
- 将 IotAppKit 依赖项从 10.11.0 升级到 10.13.1
- 在 #321 中添加 basis universal 转码器以支持 DRACO 压缩瓦片
- 在 #307 中移除未使用的告警面板
- 在 #306 中移除未使用的合并 dashboard 流程
1.18.1
- 将 fast-xml-parser 依赖项从 4.2.5 升级到 4.5.0
- 将 path-to-regexp 依赖项解析到 1.9.0
1.18.0
- 将 IotAppKit 依赖项从 10.8.1 升级到 10.11.0
1.17.2
- 在 #300 中修复告警配置面板的错误路径
1.17.1
- 杂项:在 #293 中更新依赖项
1.17.0
- fix(scene-viewer):在 #291 中升级 AppKit 和 UxSDK bundle 以修复与 Grafana runtime env 的兼容性问题
- 将 IotAppKit 依赖项从 10.6.1 升级到 10.8.1
- 10.8.1 (2024-07-01)
- 10.8.0 (2024-06-24)
- 10.7.0 (2024-06-18)
1.16.0
- 在 #290 中为配置编辑器宽度使用 Grafana 主题
- 在 #289 中将配置和查询编辑器迁移到新的表单样式
- 在 #288 中向应用包含项添加嵌套插件
- 在 #282 中移除 executable 字段中的相对路径信息
1.15.0
- 支持 Dynamic Scenes
- 移除无用的 cypress 测试和依赖项
- 将 IotAppKit 依赖项从 10.2.0 升级到 10.6.1
- 10.6.1 (2024-06-13)
- 10.6.0 (2024-06-06)
- 10.5.0 (2024-05-30)
- 10.4.0 (2024-05-20)
- 10.3.0 (2024-05-10)
1.14.0
- 为 go 1.21.8 中的安全修复构建新版本
1.13.0
- 将 IotAppKit 依赖项从 9.6.0 升级到 10.2.0
1.12.0
1.11.1
1.11.0
- 数据源中支持新区域 cn-north-1 (BJS)
1.10.1
- 修复 Grafana 9.x 及以下版本的场景加载问题
1.10.0
- 配置编辑器:在 #258 中修复新表单样式下的工作空间加载问题
- 在 #256 中将 ramda 0.27.2 添加到 resolutions
- 查询编辑器:在 #249 中在 feature toggle 下迁移到新表单样式
- 配置编辑器:在 #244 中在 feature toggle 下迁移到新表单样式
1.9.3
- 将 IotAppKit 依赖项从 9.2.0 升级到 9.6.0
- 场景查看器面板中支持自动查询和标签遮挡
- 修复视频播放器面板中的播放模式切换功能并反映时间范围变化
- 与标签、自定义样式标签、覆盖和同步 Matterport 标签相关的细微 bug 修复
- 将 three-stdlib 依赖项从 2.17.3 升级到 2.23.9
- 将 fast-xml-parser 依赖项升级到 4.2.5
1.9.2
- 在 https://github.com/grafana/grafana-iot-twinmaker-app/pull/237 中,由 @dependabot 将 go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace 从 0.42.0 升级到 0.44.0
- 在 https://github.com/grafana/grafana-iot-twinmaker-app/pull/240 中,由 @fridgepoet 修复导入的告警 Dashboard 的过滤器值,从字符串改为结构体
- 在 https://github.com/grafana/grafana-iot-twinmaker-app/pull/241 中,由 @dependabot 将 @babel/traverse 从 7.22.15 升级到 7.23.2
- 在 https://github.com/grafana/grafana-iot-twinmaker-app/pull/242 中,由 @dependabot 将 google.golang.org/grpc 从 1.58.2 升级到 1.58.3
1.9.1
- 场景查看器面板中支持标签的自定义样式
- 场景查看器面板中的其他细微 bug 修复
1.9.0
- 数据源中支持新区域 ap-south-1 (BOM)、ap-northeast-1 (NRT) 和 ap-northeast-2 (ICN)
- 修复以允许自定义单元格类型显示图像
- 修复场景查看器中加载包含 Matterport 空间的场景的问题
1.8.1
- 在 #223 中,将 QueryEditor 面板插件包装在 CustomScrollbar 中以修复滚动行为
1.8.0
- 在 #212 中将插件依赖项升级到 React 18 和 iot-app-kit@7
- 将 grafana-aws-sdk 更新到 v0.19.2
1.7.1
- 更新 @grafana/aws-sdk 前端包,以修复未来功能临时凭证的一个 bug
- 修复 endpoint 为空字符串时的“无效 URL”问题
1.7.0
- 将 grafana-aws-sdk 更新到 v0.19.1
v1.6.3
- 修复父对象上数据覆盖的可见性
- 添加实体绑定支持
- 修复光线投射问题
- 添加对数据覆盖的选择事件支持
v1.6.2
- 为视频播放器设置粘性视频控件
- Matterport 场景的错误处理
- 场景查看器侧边栏自动折叠
- 修复场景查看器和视频播放器面板中使用重复模板变量的问题
- 场景查看器和视频播放器面板中的其他细微 bug 修复
1.6.1
- 更新 grafana-aws-sdk 版本。
- 安全性:将构建过程中的 Go 升级到 1.20.4
- 将 grafana-plugin-sdk-go 版本更新到 0.161.0,以避免潜在的 http 头部问题。https://github.com/grafana/athena-datasource/issues/233
v1.6.0
- 在场景查看器中启动 Matterport 集成
- 场景查看器中支持标签大小调整设置
- 场景查看器中支持数据覆盖小部件
v1.5.0
- 更新后端依赖项
v1.4.0
- 数据源中支持 GovCloud 区域 us-gov-west-1 (PDT)
v1.3.2
- 修复场景查看器中的瓦片渲染问题
v1.3.1
- 场景查看器和告警配置面板中的 Bug 修复
- 查询中支持属性显示名称
v1.3.0
- 启动告警配置面板
- 启动查询编辑器面板
- 支持通过 TwinMaker 使用 Get Property Value 查询 Athena 表格连接器
- 启动场景查看器功能:相机视图、场景层级搜索、不透明度着色器和子模型选择
- 场景查看器和视频播放器面板中的 Bug 修复
- 升级了 Go AWS SDK
- 最低 Grafana 版本现在为 >=8.4
v1.2.1
- 修复导致 Dashboard 数据不完整的分页问题
- 修复场景查看器和视频播放器面板的细微 bug
v1.2.0
- 实时时间序列历史流
- 在 Get Alarms 查询中设置要检索数据的最大告警数量
- 使用模板变量设置 propertyName
- 避免 Dashboard 上不必要的面板刷新
- 在场景查看器中显示运动指示器
- 修复场景查看器中的 Model Shader 功能
v1.1.2
- 增加标签选择图形的大小和亮度
- 将标签外圈涂成蓝色
- 使视频标签与其他标签一致
- FireFox 中标签的黑色图标问题
v1.1.1
- 修复 GetPropertyValue 查询中显示多个 LIST 属性类型的 bug
- 配置 IoT TwinMaker 数据源需要 Assume Role ARN
- 优化告警查找
v1.1.0
- 升级 Go AWS SDK。
- 更新 aws-iot-twinmaker-grafana-utils 包。
- 修复数据源配置页面的细微 bug。
v1.0.1
- 更新 aws-iot-twinmaker-grafana-utils 包。
- 修复数据源配置页面上的断开链接。
v1.0.0
- 初始版本。