版本发布

本文档记录了我们对 Cognite Data Source for Grafana 持续进行的改进。

4.3.0 - 2025 年 4 月 24 日

特性

• 更新了插件 GUI 组件以适应 Grafana v12 的变化
• 未来启用后端数据源的初步工作

Bug 修复

• 升级了插件依赖项

4.2.1 - 2024 年 11 月 28 日

Bug 修复

• 升级插件依赖项以修复 CVE

4.2.0 - 2024 年 6 月 17 日

特性

• 增加了对聚合时间序列的时区支持，用户可以使用 Grafana 时间范围选项选择时区。

4.1.3 - 2024 年 5 月 7 日

Bug 修复

• 修复了解析器性能问题，该问题在使用相当长的自定义时间序列查询时发生。

4.1.2 - 2024 年 3 月 14 日

Bug 修复

• 修复了事件资源时间戳列的问题，之前它显示为 epoch 格式，现在显示为人类可读格式

4.1.1 - 2024 年 2 月 14 日

Bug 修复

• 修复了自定义查询中小数点后超过 7 位的浮点数导致语法错误的问题

4.1.0 - 2024 年 2 月 7 日

特性

• 添加了新的时间序列属性 unitExternalId
• 增加了在自定义查询中按 unitExternalId 和 unitQuantity 过滤时间序列的支持
• 增加了在自定义查询中查询带有单位转换的数据点的支持
• 对自定义查询选项卡中查询字段的 UI 进行了小幅改进

Bug 修复

• 修补了插件依赖项以修复弃用错误

4.0.1 - 2023 年 11 月 7 日

Bug 修复

• 修补了迁移到 React 后引入的回归问题
  • 事件表 activeAtTime 过滤现在与之前一样工作
  • 标注过滤现在与之前一样正确应用
  • 重新添加了标注查询的提示和示例
• 多个依赖项已更新以修复安全漏洞

4.0.0 - 2023 年 10 月 12 日

特性

• 将标注编辑器从 Angular 迁移到 React
• 最低 Grafana 版本要求提升至 v10
• 事件以 dataframe 格式返回

3.1.0 - 2023 年 5 月 10 日

特性

• 增加了对新版本 CDF 数据模型 (GraphQL) 的支持
• 增加了对事件表进行排序的选项

3.0.1 - 2023 年 4 月 3 日

• 修补了插件依赖项
• 修复了插件配置中 CDF 主机参数的措辞

3.0.0 - 2022 年 11 月 21 日

• 连接器依赖项已更新，现在连接器需要 Grafana v8 或更高版本。
• 灵活数据建模 (Flexible Data Modelling) 现已作为预览功能添加。您需要在数据源设置中启用它。该插件将可视化在 Cognite 新的灵活数据模型中建模的表格和时间序列
• 提取管道 (Extraction Pipelines) 已作为预览功能添加。您现在可以在 Grafana 内查看提取管道和运行的最新状态。
• 事件的高级过滤现在也支持聚合。
• 使用资产查询创建的变量现在除了 id 外，还可以返回 externalId 和 name 作为值。这在使用 FDM graphQl 查询中的变量时非常有用。

2.6.0 - 2022 年 8 月 4 日

Kubernetes grafana operator 支持

• 连接器现在支持与 Kubernetes Grafana operator 一起使用，作为 GrafanaDataSource CRD。在 operator 中，您可以在 defaultProject 参数中指定 Cognite 项目，并将 API URL 指定为 clusterUrl 参数。在 operator 中，您可以使用以下语法指定数据源

datasources:
  - access: proxy
    editable: false
    isDefault: true
    jsonData:
      clusterUrl: westeurope-1.cognitedata.com # other examples are api.cognitedata.com, az-eastus-1.cognitedata.com etc
      defaultProject: <cdf-project>
      oauthPassThru: true
    name: CDF
    type: cognitedata-datasource
name: cdf.yaml

事件的高级过滤支持 (alpha)

• 事件的高级过滤支持已作为单独的输入框添加到事件选项卡中。在数据源设置中启用此功能。
• API 文档

关系更新

• 关系选项卡中的所有下拉菜单现在均已排序且可搜索

2.5.0 - 2022 年 6 月 1 日

关系支持

• 连接器现在支持 CDF 关系资源类型。有关关系的更多信息，请参阅关系文档。
• 通过关系支持，您现在可以在“来自资产的时间序列”选项卡中根据关系获取时间序列。可以根据 Grafana 中选择的时间过滤器，按数据集、标签和活动关系过滤关系。
• 新增了一个关系选项卡，可用于利用 Grafana 的节点图可视化插件，或一个新的 (alpha) 自定义可视化插件，可在cognite-grafana-relationships-visualization 找到

模板支持（预览）

• 新增了一个模板选项卡，支持 CDF 模板功能（预览）。在数据源设置中启用此功能。
• 使用 Grafana 的模板，您可以在添加设备时动态扩展仪表盘。
• 文档：https://docs.cognite.com/dev/concepts/resource_types/templates

2.4.0 - 2021 年 8 月 20 日

特性

• OAuth 2.0 客户端凭据授权流程，用于对 CDF 进行身份验证和授权。

2.3.0 - 2021 年 6 月 1 日

特性

• 能够链接变量，以便将一个变量的值用作另一个变量的输入。

2.2.0 - 2021 年 4 月 6 日

特性

• 事件数据的表格表示。
• 事件标注查询默认显示未完成的事件。
• 支持使用 OAuth 对 CDF 进行身份验证。
• 选择仅获取时间序列的最新数据点。

2.1.1 - 2020 年 11 月 23 日

Bug 修复

• 在 time series by asset 查询中支持变量。在版本 2.1.0 中，用作 Asset tag 的 $variable 适用于先前创建的仪表盘，但无法创建具有相同功能的新面板。

2.1.0 - 2020 年 11 月 19 日

• 数据源需要 Grafana 版本 7.0.6 或更高。
• 时间序列现在尽可能按其 externalId 保存到仪表盘中。这使您可以在包含具有匹配 externalIds 的时间序列的 CDF 项目之间切换。
• 支持合成时间序列对齐。
• 将数据源 GUI 重写为 React。
• 更新了 CDF 徽标以匹配明亮/黑暗主题。

2.0.1 - 2020 年 8 月 25 日

Bug 修复

• [自定义查询] 选项可将图例标签显示为纯文本而不是表达式

  查询示例：ts{id=1} + ts{id=2} + 1

  • 用户标签 custom name 结果为 custom name 标签。（标签中未引用特定时间序列）
  • 用户标签 {{name}} 结果为 timeseries_name_1 + timeseries_name_2 + 1 标签。（这与之前的工作方式相同）

• [自定义查询] 改进了错误处理

  • HTTP 500 错误消息在 GUI 中可见

• [自定义查询] 如果提供较短的值，默认粒度将回退到 1 秒

  • 以前，选择小于 10 分钟的时间跨度会导致 HTTP 400 错误。

2.0.0 - 2020 年 6 月 29 日

通用改进

• 受 PromQL 启发并与 CDF 中的合成时间序列兼容的新查询语言。了解更多。
• 支持 CDF API v1 中针对各自资源类型（资产、事件、时间序列）提供的所有过滤功能。
• 未来添加到 CDF API v1 中的任何过滤功能都将由数据源自动支持（过滤器直接传递给 CDF）。
• 导致错误的查询表达式现在在 UI 中显示错误消息。
• 正则表达式过滤可作为查询表达式的一部分使用。过滤器字段已移除。
• 支持 CDF API v1，不依赖旧版 API。
• 连接器新文档部分，涵盖安装和管理、升级、功能文档以及入门信息。
• 与 Grafana 7.0 兼容。在此了解更多关于新功能的信息。

时间序列和自定义查询

• 您现在可以访问那些在数据源中未填充 legacyName 属性的时间序列。
• 在自定义查询选项卡中设置 Root Asset 不再是必需的。此过滤器已从 UI 中移除，现在作为自定义查询表达式的一部分可用。例如：ts{rootAssetIds=[12335453, 3455566]}。
• 自定义查询聚合请求不太可能触发 CDF API 中的速率限制。
• 函数
  • 通过新的 map 函数支持字符串时间序列，允许您将字符串值转换为数值，然后由 Grafana 绘制。例如：map(ts{externalId='pump_29'}, ['OPEN', 'CLOSED'], [1, 0], -1)。
  • 使用 on_error 函数可以控制包含错误的查询计算，例如除以 0。该函数允许您为出现错误的单个数据点设置默认值。如果不使用 on_error 函数，图表将在这些位置显示空白。示例：on_error(1/ts{externalId='canBeZero'}, 0)。
  • 可变长度函数：max(x1, x2, ...)、min(...)、avg(...)。
  • power 函数已重命名为 pow。
  • 以下函数不再受支持：acos、asin、atan、ceil、celing、cot、degrees、floor、log、log2、log10、radians、sign、tan、atan2、mod、truncate、rand、crc32、conv、div。
• 自定义查询不再支持以下聚合：max、min、count、sum、continuousVariance、discreteVariance、totalVariation。
• 不再支持聚合函数的短名称。请改用全名称：average、interpolation、stepInterpolation。
• timeseries{options} 函数已重命名为 ts{options}。
• 过滤
  • 新选项：isString=false、externalId='my_id'、id=123、externalIdPrefix='my_'
  • 关联资产树：assetSubtreeIds=[{id=754173880412890},{externalId="23-TE-96148"}]、assetIds=[123, 234]、assetExternalIds=['pump_1', 'pump_2']、rootAssetIds=[123, 234]
  • 新建时间和更新时间的新范围过滤器：createdTime={min=0, max= 1593018651}、lastUpdatedTime={min=1493018651, max= 1593018651}
  • 根据 dataSet 成员选择时间序列：dataSetIds=[{externalId='Prediction Model A'},{id=123}]
  • 不再支持 path
  • 查看 ts{} 表达式的支持过滤器完整列表。

标注

• 新过滤器：assetExternalIds、rootAssetIds、dataSetIds、externalIdPrefix、source。
• 使用 activeAtTime 过滤器查找范围内的活动事件。如果 endTime 为空，则事件从 startTime 开始活动。activeAtTime 过滤器将匹配在 min 到 max 范围内的某个时间点活动的任何事件。示例：activeAtTime={min=1591018651, max= 1593018651}。
• description 仅支持正则表达式运算符 =~、!~ 和 !=。
• minStartTime/maxStartTime 已被 startTime={min=0, max= 1593018651} 过滤器取代。
• minEndTime/maxEndTime 已被 endTime={min=0, max= 1593018651} 过滤器取代，您也可以使用此过滤器过滤没有设置 endTime 的事件：endTime={isNull=true}。
• minCreatedTime/maxCreatedTime 已被 createdTime={min=0, max= 1593018651} 过滤器取代。
• minLastUpdatedTime/maxLastUpdatedTime 已被 lastUpdatedTime={min=0, max= 1593018651} 过滤器取代。
• assetSubtrees 已被 assetSubtreeIds=[{id=754173880412890},{externalId="23-TE-96148"}] 过滤器取代，该过滤器支持 Id/ExternalId 输入。
• 以下过滤器不再受支持：sort、dir、limit、offset、sourceId。
• 查看 events{} 表达式的支持过滤器完整列表。

模板化

• 新过滤器：parentIds、parentExternalIds、rootIds、dataSetIds、externalIdPrefix、root。
• description 字段仅支持正则表达式运算符 =~、!~ 和 !=。
• 根据标签选择资产：labels={contains={externalId="pump"}}、labels={containsAny=[{externalId="pump_type_A"},{externalId="pump_type_B"}]}、labels={containsAll=[{externalId="pump"},{externalId="rust_detected"}]}
• assetSubtrees 被 assetSubtreeIds=[{id=754173880412890},{externalId="23-TE-96148"}] 过滤器取代，该过滤器支持 Id/ExternalId 输入。
• minCreatedTime/maxCreatedTime 已被 createdTime={min=0, max= 1593018651} 过滤器取代。
• minLastUpdatedTime/maxLastUpdatedTime 已被 lastUpdatedTime={min=1592222651, max= 1593018651} 过滤器取代。
• 以下选项不再受支持：query、sort、dir、offset、boostname、path、depth、sourceId。
• 查看 assets{} 表达式的支持过滤器完整列表。

其他

Cognite Data Source for Grafana 2.0.0 与 CDF API v1 兼容。

Cognite Data Source for Grafana 2.0.0 不向后兼容使用旧版连接器创建的仪表盘。请遵循升级指南中的步骤来升级您现有的安装。

1.0.1 - 2019 年 5 月 27 日

• 将 Cognite Data Platform 重命名为 Cognite Data Fusion。
• 允许在自定义查询的任何地方使用模板化变量。
• 允许在添加新数据源时修改基本 URL。

其他

Cognite Data Source for Grafana 1.0.1 与 CDF API 0.5 兼容。

1.0.0 - 2019 年 3 月 26 日

• 修复模板化问题，使重复的面板/行正常工作。
• 将复选框更改为 Grafana 复选框并添加全选选项。
• 修复数据源配置以验证项目名称。
• 重大变更：timeseries{ ... } 内的 function= 对于自定义查询不再有效。相反，函数现在应用于 timeseries{}[] 之外，例如
  • (timeseries{description=~".*TEMP.*"}[avg] - 32) * 5/9
  • sum(timeseries{name=~".*VALUE"}[count,1d])
  • max(timeseries{metadata.on="True"}[count,5m]) - min(timeseries{metadata.on="True"}[count,5m])

其他

Cognite Data Source for Grafana 1.0.0 与 CDF API 0.5 兼容