菜单
文档breadcrumb arrow 插件breadcrumb arrow Grafana 的 Honeycomb 数据源

Grafana 的 Honeycomb 数据源

Grafana 的 Honeycomb 数据源允许您在 Grafana 中查询和可视化 Honeycomb 指标,并链接到 Honeycomb 追踪。

要求

此插件有以下要求

已知限制

  • 此数据源所基于的 Honeycomb API 尚未普遍可用。这可能会导致数据源出现意外行为。
  • 此数据源尚不支持即席查询。
  • 由于 API 限制,变量编辑器只能返回所选列的前 1000 个唯一值。
  • 由于 API 限制,数据源只能查询最近 7 天的数据。

安装数据源插件

要安装数据源,请参阅安装页面。

符合兼容性要求

对于此插件,没有兼容性要求。

验证插件是否已安装

  1. 在 Grafana Enterprise 中,从左侧菜单导航到 Configuration > Data sources
  2. 从右上角,点击 Add data source 按钮。
  3. 在搜索字段中搜索 Honeycomb,并将鼠标悬停在 Honeycomb 搜索结果上。
  4. 点击 Honeycomb 的 Select 按钮。
    • 如果可以点击 Select 按钮,则表示已安装。
    • 如果按钮缺失或禁用,则表示插件未安装。检查您的 Grafana Enterprise 许可证是否有效,并重新安装插件。如果您仍然需要帮助,请联系 Grafana Labs

注意:在 Grafana Cloud 上,可能需要最多 15 分钟才能在 Grafana 中看到数据源插件。

从 Honeycomb 获取 API 密钥

  1. 前往https://ui.honeycomb.io/account
  2. 设置 API 密钥并复制您的应用程序密钥。

配置数据源

要添加新的 Honeycomb 数据源,请参阅添加数据源,并填写以下字段

Honeycomb 设置

字段描述
名称此特定 Honeycomb 数据源的名称。
Honeycomb API 密钥来自 Honeycomb 的 API 密钥.
URLHoneycomb API 的 URL。例如,https://api.honeycomb.io
团队与 API 密钥关联的 Honeycomb 团队
环境与 API 密钥关联的 Honeycomb 环境名称

Configuration

通过 Provisioning 配置数据源

使用配置文件通过 Grafana 的 Provisioning 系统配置 Honeycomb 数据源。要了解有关 Provisioning 系统如何工作(包括所有数据源设置)的更多信息,请参阅Provisioning Grafana

以下是此数据源的 Provisioning 示例

yaml
apiVersion: 1
datasources:
  - name: Honeycomb
    type: grafana-honeycomb-datasource
    jsonData:
      hostname: https://api.honeycomb.io
      team: Team
      environment: test
    secureJsonData:
      apiKey: API Key

查询数据源

查询编辑器允许您查询 Honeycomb 并链接到 Honeycomb。

query-editor

根据为 Returned data 下拉列表选择的值,查询将返回时序数据、结果(相当于 Honeycomb UI 中图表下方的概览)或两者兼有。

data frames

指标查询

通过在编辑器字段中输入值来查询指标。

  • 选择数据集
  • 默认查询是对所选数据集的 COUNT 操作。
  • 要优化查询,请选择以下任何剩余字段的值:VisualizationWhereConstraintGroup byOrder byLimit

SLO 查询

可以通过选择 SLO 作为查询类型来查询 Honeycomb SLO。您可以执行两种类型的 SLO 查询

  1. SLO 定义列表 (SLO List)
  2. 单个 SLO 详情 (SLO detail)
    • 此查询需要单个 SLO ID。
    • 要检索 Budget RemainingCompliance 详情,需要 Honeycomb Enterprise 计划。

要查看多个 SLO 项的 SLO 详情,请使用多个查询,然后使用合并转换将其显示在单个面板视图中。

模板和变量

要添加新的 Honeycomb 查询变量,请参阅添加查询变量。使用您的 Honeycomb 数据源作为数据源。

Screenshot from 2021-06-17 14-41-10

您可以创建包含数据集、列或列值的变量

  • 如果未选择数据集,则变量将包含数据集
  • 如果仅选择数据集,则变量将包含列名
  • 如果同时选择数据集和列,则变量将包含列值。
    • 可以使用编辑器中的 Where 字段进一步约束列值。

创建变量后,您可以在 Honeycomb 查询中使用它。有关更多信息,请参阅变量语法

有关变量的更多信息,请参阅模板和变量

在 Honeycomb UI 中查看查询

从仪表盘面板

要在仪表盘面板中 Honeycomb UI 中查看您创建的查询,请点击图表中的任意点,然后点击在 Honeycomb 中打开

Screenshot from 2021-07-22 15-38-33

从查询编辑器

要在 Honeycomb UI 中查看您创建的查询,请点击在 Honeycomb 中打开按钮。

Screenshot from 2021-06-17 14-36-42

导入 Honeycomb 仪表盘

要导入仪表盘,请参阅导入仪表盘

要查找您导入的仪表盘,请转到 Configuration > Data sources

要查看可用的预制仪表盘,请选择 Honeycomb 数据源,然后选择 Dashboards 选项卡。

了解更多