文档 插件 Grafana 的 Honeycomb 数据源

Grafana 的 Honeycomb 数据源

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

需求

此插件具有以下需求

• 一个活跃的 Honeycomb Enterprise 团队
• 以下帐户类型之一
  • 适用于具有 Grafana Cloud 免费版、高级版或试用版帐户或已 激活 Grafana Enterprise 许可证 的用户。
• 要查询 SLO 报告数据，需要 Honeycomb 企业版计划 required。

已知限制

• 此数据源开发所针对的 Honeycomb API 尚未普遍可用。它可能会导致数据源出现意外行为。
• 此数据源尚不支持或即席查询。
• 由于 API 限制，变量编辑器只能返回所选列的前 1000 个唯一值。
• 由于 API 限制，数据源只能查询过去 7 天的数据。

安装数据源插件

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

符合兼容性要求

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

验证插件是否已安装

1. 在 Grafana Enterprise 中，从左侧菜单导航到**配置** > **数据源**。
2. 从右上角，点击**添加数据源**按钮。
3. 在搜索字段中搜索 Honeycomb，并将鼠标悬停在 Honeycomb 搜索结果上。
4. 点击 Honeycomb 的**选择**按钮。
   • 如果您可以点击**选择**按钮，则表示它已安装。
   • 如果按钮丢失或禁用，则表示插件未安装。检查您的 Grafana Enterprise 许可证是否有效，然后重新安装插件。如果您仍然需要帮助，请 联系 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。

指标查询

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

• 选择数据集
• 默认查询是对所选数据集执行的 COUNT 操作。
• 要细化查询，请选择任何剩余字段的值：可视化、Where、约束、分组依据、排序依据或限制。

SLO 查询

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

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

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

模板和变量

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

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

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

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

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

在 Honeycomb UI 中查看查询

从仪表盘面板

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

从查询编辑器

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

导入 Honeycomb 的仪表盘

要导入仪表盘，请参考 导入仪表盘。

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

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

了解更多

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