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 New Relic
<a name="new-relic-data-source"></a>

 Esta seção aborda o New Relic [APM](https://newrelic.com/products/application-monitoring) e [Insights](https://newrelic.com/products/insights) para 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).

## Recursos
<a name="newrelic-features"></a>
+  Variáveis de modelo 
  +  Nomes de métricas 
  +  Valores da métrica 
+  Anotações 
+  Aliases 
  +  Nomes de métricas 
  +  Valores da métrica 
+  Ad-hoc filtros 
  +  Nenhum suporte no momento. 
+  Geração de alertas 

## Configuração
<a name="newrelic-configuration"></a>

 Adicione a fonte de dados, preenchendo os campos da [chave de API de administrador](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#admin), [chave de API pessoal](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key) e [ID da conta](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/account-id). 

## Usage
<a name="newrelic-usage"></a>

### Tipos de serviço
<a name="newrelic-service-types"></a>
+  **Métricas**; para consultar o New Relic APM por meio da [API REST](https://docs.newrelic.com/docs/apis/rest-api-v2) da New Relic. 
+  **Insights**; para consultar o New Relic Insights por meio do [NRQL](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions). 

### Aliases
<a name="newrelic-aliases"></a>

 Você pode combinar texto simples com as variáveis a seguir para produzir uma saída personalizada. 


|  Variável  |  Description  |  Valor de exemplo  | 
| --- | --- | --- | 
|  $\_\_nr\_metric  |  Nome da métrica  |  CPU/User hora  | 
|  $\_\_nr\_metric\_value  |  Valores da métrica  |  average\_value  | 

Por exemplo:

```
    <para>
      Server: $__nr_server Metric: $__nr_metric
    </para>
    <programlisting>
```

### Modelos e variáveis
<a name="newrelic-templates-and-variables"></a>

1.  Crie uma variável de modelo para o dashboard. Para obter mais informações, consulte [Modelos e variáveis](templates-and-variables.md). 

1.  Selecione o tipo “Consulta”. 

1.  Selecione a fonte de dados “New Relic”. 

1.  Formule uma consulta usando endpoints relativos da [API REST](https://docs.newrelic.com/docs/apis/rest-api-v2) (excluindo extensões de arquivo). 

Lista de aplicações disponíveis:

```
    <para>
      applications
    </para>
    <programlisting>
```

Lista de métricas disponíveis para uma aplicação:

```
    <para>
      applications/{application_id}/metrics
    </para>
    <programlisting>
```

### Macros NRQL
<a name="nrql-macros"></a>

 Para melhorar a experiência de escrita ao criar consultas New Relic Query Language (NRQL), o editor é compatível com macros predefinidos: 
+  `$__timeFilter` (ou `[[timeFilter]]`) será interpolado como `SINCE &lt;from&gt; UNTIL &lt;to&gt;` com base no intervalo de tempo do dashboard. 

Exemplo:

```
    <para>
      SELECT average(value) FROM $event_template_variable
      $__timeFilter TIMESERIES
    </para>
    <programlisting>
```

 Para obter mais dicas sobre como usar macros e variáveis de modelo, consulte a seção de ajuda do editor. 

### Eventos de alerta
<a name="newrelic-alert-events"></a>

 Selecione a fonte de dados New Relic e defina filtros adicionais. Sem nenhum filtro definido, todos os eventos serão retornados. 

 Se quiser filtrar eventos por *ID de entidade*, use variáveis de modelo porque você poderá selecionar o nome da entidade em vez do ID. Por exemplo, para filtrar eventos para uma aplicação específica, crie uma variável `_$app_` que recupere uma lista de aplicações e use-a como um filtro de *ID de entidade*. 

### Eventos de implantação
<a name="newrelic-deployment-events"></a>

 *ID da aplicação* é um campo obrigatório.