插件〉AWS IoT SiteWise

数据源

grafana

AWS IoT SiteWise

概述
安装
更新日志
相关内容

警告
我们建议客户使用 Grafana 10.4.0 或更高版本来使用 AWS IoT SiteWise 数据源。Grafana 版本低于 10.4.0 的实例无法使用 AWS IoT SiteWise 数据源 1.25.2 或更高版本。

AWS IoT SiteWise 数据源

此数据源支持从 AWS IoT SiteWise 读取数据，并在 Grafana 仪表板中显示。

添加数据源

在侧边菜单的配置链接下，点击数据源。
点击添加数据源按钮。
在工业与物联网部分选择 IoT SiteWise。

身份验证

IoT SiteWise 插件的身份验证与标准的 Cloudwatch 插件系统一致。有关身份验证选项和设置，请参阅grafana cloudwatch 文档。

配置身份验证后，点击“保存并测试”以验证服务是否正常工作。配置完成后，您可以为配置指定默认值。

查询数据

用户可以选择 UI 驱动的 Query builder 或使用 IoT SiteWise 查询语言查询以获取数据的 Query code editor。Query builder 提供了一个引导式、技术门槛较低的界面，而 Query code editor 则更具技术性，但也更强大。

Query builder

使用“查询类型”选择器选择合适的查询。

query-editor

点击“探索”按钮打开资产/模型导航界面

query-editor

单个属性可以显示多个聚合

query-editor

警报

此插件支持标准的 Grafana 警报，但请注意警报查询可能不包含模板变量。有关 Grafana 警报的更多信息，请参阅警报文档。

通过配置来配置数据源

您可以使用 Grafana 的配置系统通过配置文件配置数据源。您可以在配置文档页面上了解更多关于其工作原理以及您可以为数据源设置的所有设置。

以下是此数据源的一些配置示例。

使用凭证文件

如果您使用凭证文件身份验证类型，则应使用包含类似以下配置的凭证文件。

apiVersion: 1
datasources:

name: IoT SiteWise
type: grafana-iot-sitewise-datasource
jsonData:
authType: credentials
defaultRegion: us-east-1

使用 `accessKey` 和 `secretKey`

apiVersion: 1
datasources:

name: IoT SiteWise
type: grafana-iot-sitewise-datasource
jsonData:
authType: keys
defaultRegion: us-east-1
secureJsonData:
accessKey: ‘<your access key>’
secretKey: ‘<your secret key>’

在 Grafana Cloud 上安装 AWS IoT SiteWise

更多信息，请访问有关插件安装的文档。

更新日志

此项目的所有重要更改将记录在此文件中。

2.2.0

在 #439 中添加对列出多个资产关联资产的支持
chore: 在 #445 中重构额外的类组件
chore(deps): 在 #447 中更新所有 go 依赖项组 2 次
Chore: 在 #408 中为外部贡献添加标签
chore(deps): 在 #452 中对 1 个目录中的所有 node 依赖项组进行 14 次更新
fix: 客户端缓存开关应控制正确的查询，在 #449
fix: 客户端缓存应尊重变量更改，在 #456
chore: Grafana 实例版本支持警告，在 #457

2.1.0

chore 在 #442 中重构元数据检查器
chore 在 #443 中移除废弃代码
chore(deps-dev): 在 #438 中对所有 node dev 依赖项组进行 16 次更新
chore(deps): 在 #437 中对所有 go 依赖项组进行 2 次更新
fix: 在 #441 中移除不支持的区域
feat: 支持插值分辨率的模板变量；使 GetInterpolatedAssetPropertyValues 查询中分辨率字段的 UX 保持一致，在 #433
feat: 在 #432 中支持 modelId 的嵌套变量 UX
Feat: 添加对 15 分钟分辨率的支持；改进变量下拉菜单的 UI，并在分辨率中添加对变量的支持，在 #429
chore(deps): 在 #426 中对所有 node 依赖项组进行 16 次更新
chore(deps): 在 #427 中对所有 go 依赖项组进行 2 次更新
在 #428 中为 model id 添加变量插值
fix: listAssets 和 listAssetModels 的 isValidQuery 损坏，在 #425
chore(deps): 在 #420 中对 1 个目录中的所有 node 依赖项组进行 19 次更新
chore(deps): 在 #419 中将所有 go 依赖项组中的 github.com/grafana/grafana-plugin-sdk-go 从 0.265.0 更新到 0.266.0

2.0.0

(破坏性变更：) 在 #384 中从 grafana/experimental 迁移到 plugin-ui
chore(deps): 在 #413 中对 1 个目录中的所有 go 依赖项组进行 2 次更新
chore(deps): 在 [#405](https://github.com/grafana/iot-sitewise-datasource/pull/ 405) 中对 1 个目录中的所有 node 依赖项组进行 20 次更新
Bugfix: 在 #399 中在变量编辑器中过滤掉无效查询
Chore: 在 #397 中更新 docker compose 以支持改进的后端开发
在 #396 中对所有 node 依赖项组进行 7 次更新
fix: 在 #394 中列出关联资产的查询字段
feat: 在 #390 中支持按外部 ID 选择资产

1.25.2

在 #389 中对 1 个目录中的所有 node 依赖项组进行 17 次更新
在 #388 中对所有 go 依赖项组进行 3 次更新
在 #385 中将所有 go 依赖项组中的 github.com/grafana/grafana-plugin-sdk-go 从 0.260.3 更新到 0.261.0
在 #382 中对 1 个目录中的所有 node 依赖项组进行 20 次更新
在 #379 中对 1 个目录中的所有 go 依赖项组进行 2 次更新

1.25.1

Chore: 更新 plugin.json 关键词 #359
对所有 github action 依赖项组进行 3 次更新 #372
对所有 go 依赖项组进行 4 次更新 #373
对所有 node 依赖项组进行 30 次更新 #374

1.25.0

Fix: 在 #355 中按 API 中指定的限制批处理条目

1.24.0

fix: 在 #352 中添加对属性值 nil 的检查
Fix golangci-lint 错误 #353
fix: 在 #350 中在查询编辑器中迁移前端资产 ID
在 #347 中移除 "ANY" 作为查询质量选项
Chore: 在 #344 中重命名数据源文件
添加 precommit hook #338
在 #343 中移除 Get property value 查询编辑器中的未使用字段
在 #342 中移除插值属性质量的 ANY 选项

1.23.0

Feat: @ssjagad 在 #336 中向查询编辑器添加列出时间序列功能
Chore: 在 #337 中更新依赖项
在配置和查询编辑器中迁移到新的表单样式 #332

1.22.1

Fix: 在 #333 中使用 ReadAuthSettings 获取 authSettings

1.22.0

更新以使用 GetSessionWithAuthSettings #330

1.21.0

重构 Paginator #313
修复 e2e 测试 #316
添加了 Stalebot #314
添加了 lint 规则 #319
为相对时间范围查询添加前端缓存 #318
从插值查询中移除了不支持的时间排序，并修复了缓存 aggregates 查询的问题 #323

1.20.0

Perf: 在 (#310)[https://github.com/grafana/iot-sitewise-datasource/pull/310] 中更新批量 API 查询以请求最大数量的依赖项

1.19.0

在 (#307)[https://github.com/grafana/iot-sitewise-datasource/pull/307] 中使用 AssetId 和 AssetIds 获取属性
在 (#304)[https://github.com/grafana/iot-sitewise-datasource/pull/304] 中迁移到 CustomVariableSupport

1.18.0

在 (#302)[https://github.com/grafana/iot-sitewise-datasource/pull/302] 中修复获取资产属性的问题
Feature: 在 (#300)[https://github.com/grafana/iot-sitewise-datasource/pull/300] 中支持 L4E struct
响应处理：在 (#297)[https://github.com/grafana/iot-sitewise-datasource/pull/297] 中添加结构数据类型处理
查询编辑器：在 (#292)[https://github.com/grafana/iot-sitewise-datasource/pull/292] 中改进下拉菜单的菜单位置
在 (#291)[https://github.com/grafana/iot-sitewise-datasource/pull/291] 中添加关键词
E2E: 在 (#290)[https://github.com/grafana/iot-sitewise-datasource/pull/290] 中添加 happy path playwright 查询测试
查询编辑器：在 (#274)[https://github.com/grafana/iot-sitewise-datasource/pull/274] 中停止在每次更改时运行查询

1.17.0

在 (#282)[https://github.com/grafana/iot-sitewise-datasource/pull/282] 中将 grafana-aws-sdk 更新到 0.21.0 并准备 1.16.2
fix: 在移除资产时清除选定属性 (#278)[https://github.com/grafana/iot-sitewise-datasource/pull/278]
E2E 测试 (#285)[https://github.com/grafana/iot-sitewise-datasource/pull/285]
添加对复合模型属性的支持 (#279)[https://github.com/grafana/iot-sitewise-datasource/pull/279]
在边缘使用非批量 API (#281)[https://github.com/grafana/iot-sitewise-datasource/pull/281]

1.16.1

将 aws-sdk-go 升级到 v1.49.6 以访问 ExecuteQuery API (#266)
Fix: 通过别名推断解除关联流的属性值查询数据类型 (#275)

1.16.0

使用查询区域获取客户端进行查询 (#258)
Feat: 为列出关联资产查询实现“全部”选项 (#261)

1.15.0

在 (#256)[https://github.com/grafana/iot-sitewise-datasource/pull/256] 中支持插值查询的多个资产

1.14.0

查询和配置编辑器：在 (#244)[https://github.com/grafana/iot-sitewise-datasource/pull/244] 中的 feature toggle 下迁移到新的表单样式

1.13.0

@idastambuk 在 https://github.com/grafana/iot-sitewise-datasource/pull/243 中更新依赖项和 create-plugin 配置
属性聚合处理：@idastambuk 在 https://github.com/grafana/iot-sitewise-datasource/pull/240 中将 ErrorEntries 处理移出 SuccessEntries 块
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/241 中将 go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace 从 0.37.0 更新到 0.44.0
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/245 中将 @babel/traverse 从 7.17.10 更新到 7.23.2
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/248 中将 loader-utils 从 2.0.2 更新到 2.0.4
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/247 中将 semver 从 5.7.1 更新到 5.7.2
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/246 中将 google.golang.org/grpc 从 1.58.2 更新到 1.58.3
@fridgepoet 在 https://github.com/grafana/iot-sitewise-datasource/pull/249 中升级 yaml 包
@fridgepoet 在 https://github.com/grafana/iot-sitewise-datasource/pull/252 中升级 underscore, debug 依赖项
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/253 中将 yaml 从 2.2.1 更新到 2.3.4
@dependabot 在 https://github.com/grafana/iot-sitewise-datasource/pull/254 中将 json5 从 2.2.1 更新到 2.2.3

完整更新日志: https://github.com/grafana/iot-sitewise-datasource/compare/v1.12.1...v1.13.0

v1.12.1

解除关联流：哈希 entryId 以修复属性别名长于 64 个字符的问题，在 #239

v1.12.0

按属性别名查询：在 #231 中添加对未关联流的支持

v1.11.1

在 #229 中回退“将废弃的 setVariableQueryEditor 替换为 CustomVariableSupport”

v1.11.0

将后端 grafana-aws-sdk 更新到 v0.19.1，以便将 il-central-1 添加到可选加入区域列表
将前端 grafana/aws-sdk 更新到 v0.1.2，以便将 grafana_assume_role 仅限于启用的数据源

v1.10.3

更新 grafana/aws-sdk-react 依赖项 https://github.com/grafana/iot-sitewise-datasource/pull/20

v1.10.2

Fix: @ahom 修复了重复面板等 assetids 中的作用域变量替换问题 https://github.com/grafana/iot-sitewise-datasource/pull/205

v1.10.1

Fix: 属性聚合查询返回重复数据 https://github.com/grafana/iot-sitewise-datasource/pull/203
Fix: 仅包含表达式的查询只返回部分数据 https://github.com/grafana/iot-sitewise-datasource/pull/206

v1.10.0

对于“原始”查询，在数据帧名称中包含 propertyName https://github.com/grafana/iot-sitewise-datasource/pull/199

v1.9.2

如果资产 ID 和属性 ID 可用，则获取资产属性信息 https://github.com/grafana/iot-sitewise-datasource/pull/192
处理数据点超过 250 个的表达式查询 https://github.com/grafana/iot-sitewise-datasource/pull/194

v1.9.1

在 https://github.com/grafana/iot-sitewise-datasource/pull/184 中将废弃的 setVariableQueryEditor 替换为 CustomVariableSupport

v1.9.0

添加仅指定属性别名即可执行属性查询的功能 (#179)

1.8.1

更新 grafana-aws-sdk 版本以在可选加入区域列表中包含新区域 https://github.com/grafana/grafana-aws-sdk/pull/80
安全：构建过程中将 Go 升级到 1.20.4
将 grafana-plugin-sdk-go 版本更新到 0.161.0，以避免潜在的 HTTP 头部问题。 https://github.com/grafana/athena-datasource/issues/233