As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectar-se a uma fonte de dados Honeycomb
<a name="honeycomb-AMG-datasource"></a>

A fonte de dados Honeycomb permite que você consulte e visualize as métricas do Honeycomb e vincule os rastreamentos do Honeycomb no Amazon Managed Grafana.

**nota**  
Essa fonte de dados é somente para o Grafana Enterprise. Para obter mais informações, consulte [Gerenciar o acesso aos plug-ins do Enterprise](upgrade-to-enterprise-plugins.md).  
Além disso, em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode requerer a instalação do plug-in apropriado. Para obter mais informações, consulte [Ampliar o espaço de trabalho com plug-ins](grafana-plugins.md).

## Limitações conhecidas
<a name="honeycomb-known-limitations"></a>
+  Essa fonte de dados não é compatível com consultas ad hoc. 
+  Devido às limitações da API, o editor de variáveis só pode retornar os primeiros mil valores exclusivos de uma coluna selecionada. 
+  Devido às limitações da API, a fonte de dados pode consultar apenas os últimos sete dias de dados. 

## Adicionar a fonte de dados
<a name="honeycomb-adding-the-data-source"></a>

1.  Abra o console do Grafana no espaço de trabalho do Amazon Managed Grafana e verifique se está logado. 

1.  No menu lateral, em **Configuração** (o ícone de engrenagem), escolha **Fontes de dados**. 

1.  Escolha **Adicionar fonte de dados**. 

1.  Selecione **Honeycomb** na lista de fontes de dados. 

**nota**  
 Se você não vir o link **Fontes de dados** no menu lateral, isso significa que seu usuário atual não tem o perfil de `Admin`. 

**Configurações do Honeycomb**


|  Name (Nome)  |  Description  | 
| --- | --- | 
|  Name  |  O nome da fonte de dados. É assim que você vê a fonte de dados em painéis, consultas e no Explore.  | 
|  Honeycomb API key  |  A chave de API que você obteve do Honeycomb.  | 
|  URL  |  O URL da API do Honeycomb. Por exemplo, .https://api.honeycomb.io  | 
|  Team  |  A equipe do Honeycomb associada à chave de API.  | 

## Consultar a fonte de dados Honeycomb
<a name="honeycomb-query"></a>

Para consultar métricas, insira valores nos campos do editor:
+  Selecione um conjunto de dados. 
+  A consulta padrão é uma `COUNT` no conjunto de dados selecionado. 
+  Para refinar a consulta, selecione valores para qualquer um dos campos restantes, como **Visualização**, **Visualização**, **Onde**, **Restrição**, **Agrupar por**, **Ordenar por** ou **Limite**. 

## Modelos e variáveis
<a name="honeycomb-templates"></a>

Para adicionar uma nova variável de consulta do Honeycomb, consulte [Adicionar uma variável de consulta.](variables-types.md#add-a-query-variable).

YOu pode criar variáveis contendo conjuntos de dados, colunas ou valores de colunas.
+  Se nenhum conjunto de dados for selecionado, a variável conterá conjuntos de dados. 
+  Se apenas um conjunto de dados for selecionado, a variável conterá nomes de colunas. 
+  Se um conjunto de dados e uma coluna forem selecionados, a variável conterá os valores da coluna. Os valores das colunas podem ser ainda mais restringidos usando os campos **Onde** no editor. 

## Visualizar consulta na interface de usuário do Honeycomb
<a name="honeycomb-view"></a>

Para ver a consulta que você criou na interface de usuário do Honeycomb no painel do dashboard, escolha qualquer ponto no grafo e depois **Abrir no Honeycomb**. 

Para ver a consulta que você criou na interface de usuário do Honeycomb no Editor de consultas, escolha **Abrir no Honeycomb**. 

## Importar um dashboard para o Honeycomb
<a name="honeycomb-import"></a>

Para importar um dashboard, consulte [Importar um dashboard](dashboard-export-and-import.md#importing-a-dashboard). 

Para encontrar os dashboards importados, escolha **Configuração**, **Fontes de dados**. 

Para ver os dashboards predefinidos disponíveis, escolha a fonte de dados Honeycomb e depois a guia **Dashboards**.