插件 〉AWS IoT TwinMaker App


开发者

AWS IoT TwinMaker

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



应用程序
Grafana

AWS IoT TwinMaker App

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

适用于 Grafana 的 AWS IoT TwinMaker 应用程序插件

dashboard

摘要

  • 介绍
  • 入门
  • 文档
  • 开发
  • 许可

介绍

使用 AWS IoT TwinMaker 构建最终用户 3D 数字孪生应用程序来监控工业运营。AWS IoT TwinMaker 是一项服务,可帮助开发者更快、更轻松地创建真实世界系统的数字副本,从而帮助更多客户实现数字孪生的潜力,以优化运营。

AWS IoT TwinMaker Application Grafana 插件提供了自定义面板、Dashboard 模板和一个数据源,用于连接到您的数字孪生数据。

自定义面板

  • 场景查看器
  • 视频播放器

Dashboard 模板

  • 告警 Dashboard

从 TwinMaker 数据源配置页面导入 Dashboard。参见“Dashboard”选项卡。

dashboard-tab

要求

  • Grafana 8.2.0+

入门

快速入门

在 Grafana Play 中与演示 TwinMaker Dashboard 互动。该 Dashboard 通过可视化 3D 工厂、列出告警、绘制温度传感器历史图和播放视频流来监控曲奇饼干工厂。

安装

本地安装

使用 grafana-cli 工具从命令行安装

grafana-cli plugins install grafana-iot-twinmaker-app

本地 Docker 设置

  1. 安装 AWS CLI
  2. 运行 aws configure 并输入您的 IAM 用户凭证
  3. 运行以下 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”身份验证提供程序

  1. 从浏览器访问 https://:3000。首次登录的用户名为:admin,密码为:admin

启用应用程序插件

在浏览器中导航到 Grafana 并登录。前往插件列表,搜索 AWS IoT TwinMaker Application 并启用该插件。

app-plugin

配置您的 TwinMaker 数据源

导入 Dashboard 并开始使用场景查看器和视频播放器面板。

文档

您可以在以下位置找到文档:

开发

如果您有兴趣开发和贡献此项目,请在此处查看 git 仓库中的说明 here

许可

  • Apache 许可证 2.0 版,请参阅 LICENSE

在 Grafana Cloud 上安装 AWS IoT TwinMaker App

如需更多信息,请访问关于插件安装的文档。

变更日志

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

1.18.2

  • 将 IotAppKit 依赖项从 10.11.0 升级到 10.13.1
  • #321 中添加 basis universal 转码器以支持 DRACO 压缩瓦片
  • #307 中移除未使用的告警面板
  • #306 中移除未使用的合并 dashboard 流程

1.18.1

1.18.0

1.17.2

  • #300 中修复告警配置面板的错误路径

1.17.1

  • 杂项:在 #293 中更新依赖项

1.17.0

1.16.0

  • #290 中为配置编辑器宽度使用 Grafana 主题
  • #289 中将配置和查询编辑器迁移到新的表单样式
  • #288 中向应用包含项添加嵌套插件
  • #282 中移除 executable 字段中的相对路径信息

1.15.0

1.14.0

1.13.0

1.12.0

  • #273 中将 grafana/aws-sdk-go 更新到 0.20.0
  • #272 中升级 UxSDK 以添加查询编辑器的路径查询功能

1.11.1

  • 查询编辑器:在 #268 中禁用仅有一个过滤器的删除按钮,修复 tooltip(新表单样式)
  • GetPropertyValueHistory:在 #264 中将时间对象转换为具有纳秒精度的字符串

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

  • 初始版本。