文档 插件 Grafana的Honeycomb数据源

Honeycomb 数据源用于 Grafana

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

要求

此插件有以下要求

• 有效的Honeycomb企业团队
• 以下账户类型之一
  • 适用于拥有Grafana Cloud免费、高级或试用账户或已激活的Grafana企业许可证的用户。
• 要查询SLO报告数据，需要Honeycomb企业计划。更多信息。

已知限制

• 此数据源开发所针对的Honeycomb API尚未广泛发布。这可能会在数据源中引起意外的行为。
• 此数据源尚不支持或即兴查询。
• 由于API限制，变量编辑器只能返回所选列的前1000个唯一值。
• 由于API限制，数据源只能查询过去7天的数据。

安装数据源插件

要安装数据源，请参阅安装。

遵守兼容性要求

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

验证插件已安装

1. 在Grafana企业版中，从左侧菜单导航到配置 > 数据源。
2. 从右上角点击添加数据源按钮。
3. 在搜索框中搜索Honeycomb，并将鼠标悬停在Honeycomb搜索结果上。
4. 为Honeycomb点击选择按钮。
   • 如果您可以点击选择按钮，则插件已安装。
   • 如果按钮缺失或禁用，则插件未安装。检查您的Grafana企业许可证是否有效，并重新安装插件。如果仍需要帮助，请联系Grafana Labs。

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

从Honeycomb获取API密钥

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

配置数据源

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

Honeycomb设置

使用配置设置数据源

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

以下是一个为此数据源的配置示例

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 UI中图下的概览）或两者。

指标查询

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

• 选择数据集
• 默认查询是选定数据集上的COUNT。
• 为了细化查询，选择任何剩余字段中的值：可视化、条件、约束、按组、排序或限制。

SLO查询

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

1. SLO定义列表（SLO列表）
2. 单个SLO详细信息（SLO详情）
   • 此查询需要一个SLO ID。
   • 要检索预算剩余和合规性详细信息，需要Honeycomb企业计划。

要查看多个SLO项的SLO详细信息，请使用多个查询，然后使用合并转换将它们合并到单个面板视图。

模板和变量

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

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

• 如果没有选择数据集，变量将包含数据集
• 如果只选择了一个数据集，变量将包含列名
• 如果同时选择了一个数据集和列，变量将包含列值
  • 可以使用编辑器中的条件字段进一步约束列值。

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

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

在Honeycomb UI中查看查询

从仪表板面板

要从仪表板面板中查看您在Honeycomb UI中创建的查询，请单击图表上的任何一点，然后单击在Honeycomb中打开

从查询编辑器

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

导入Honeycomb仪表板

要导入仪表板，请参阅导入仪表板。

要查找您导入的仪表板，请转到配置 > 数据源。

要查看可用的预制仪表板，请选择Honeycomb数据源，并选择仪表板选项卡。

了解更多

• 配置和使用模板和变量。
• 添加转换。