本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接到 Honeycomb 数据来源
<a name="honeycomb-AMG-datasource"></a>

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

**注意**  
此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 [管理对 Enterprise 插件的访问](upgrade-to-enterprise-plugins.md)。  
此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。

## 已知限制条件
<a name="honeycomb-known-limitations"></a>
+  此数据来源不支持临时查询。
+  由于 API 的限制，变量编辑器只能返回选定列的前 1000 个唯一值。
+  由于 API 限制，数据来源只能查询最近 7 天的数据。

## 添加数据来源
<a name="honeycomb-adding-the-data-source"></a>

1.  在 Amazon Managed Grafana 工作区中打开 Grafana 控制台，并确保您已登录。

1.  在**配置**（齿轮图标）下的侧边菜单中，选择**数据来源**。

1.  选择**添加数据来源**。

1.  从数据来源列表中选择 **Honeycomb**。

**注意**  
 如果您在侧边菜单中看不到**数据来源**链接，则表示您当前的用户没有 `Admin` 角色。

**Honeycomb 设置**


|  Name  |  说明  | 
| --- | --- | 
|  Name  |  数据来源名称。您将在面板、查询和 Explore 中通过其名称查看数据来源。 | 
|  Honeycomb API key  |  您从 Honeycomb 获得的 API 密钥。 | 
|  URL  |  Honeycomb API 的 URL。例如 https://api.honeycomb.io。 | 
|  Team  |  与 API 密钥关联的 Honeycomb 团队。 | 

## 查询 Honeycomb 数据来源
<a name="honeycomb-query"></a>

要查询指标，请在编辑器字段中输入值：
+  选择数据集。
+  默认查询是对所选数据集的 `COUNT`。
+  要优化查询，请为其余任何字段选择值，例如**可视化**、**可视化**、**位置**、**限制**、**分组依据**、**排序依据**或**限制**。

## 模板和变量
<a name="honeycomb-templates"></a>

要添加新的 Honeycomb 查询变量，请参阅 [添加查询变量](variables-types.md#add-a-query-variable)。

您可以创建包含数据集、列或列值的变量。
+  如果未选择任何数据集，则该变量将包含数据集。
+  如果仅选择数据集，则该变量将包含列名。
+  如果同时选择了数据集和列，则该变量将包含列值。使用编辑器中的**位置**字段可以进一步限制列值。

## 在 Honeycomb UI 中查看查询
<a name="honeycomb-view"></a>

要从控制面板的面板查看您在 Honeycomb UI 中创建的查询，请选择图形中的任意点，然后选择**在 Honeycomb 中打开**。

要通过查询编辑器查看您在 Honeycomb UI 中创建的查询，请选择**在 Honeycomb 中打开**。

## 导入 Honeycomb 的控制面板
<a name="honeycomb-import"></a>

要导入控制面板，请参阅 [导入控制面板](dashboard-export-and-import.md#importing-a-dashboard)。

要查找导入的控制面板，请选择**配置**、**数据来源**。

要查看可用的预制控制面板，请选择 Honeycomb 数据来源并选择**控制面板**选项卡。