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

# 连接到 New Relic 数据来源
<a name="new-relic-data-source"></a>

 本节介绍了 New Relic [APM](https://newrelic.com/products/application-monitoring) 和 Grafana 的[见解](https://newrelic.com/products/insights)。

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

## 功能
<a name="newrelic-features"></a>
+  模板变量 
  +  指标名称 
  +  指标值 
+  Annotations 
+  别名 
  +  指标名称 
  +  指标值 
+  Ad-hoc 过滤器 
  +  当前不支持 
+  警报 

## 配置
<a name="newrelic-configuration"></a>

 添加数据来源，填写您的[管理员 API 密钥](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#admin)、[个人 API 密钥](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key)和[账户 ID](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/account-id) 的字段。

## 用法
<a name="newrelic-usage"></a>

### 服务类型
<a name="newrelic-service-types"></a>
+  **指标**；用于通过 New Relic 的 [REST API](https://docs.newrelic.com/docs/apis/rest-api-v2) 查询 New Relic API。
+  **见解**；用于通过 [NRQL](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions) 查询 New Relic 见解。

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

 您可以将纯文本与以下变量组合以生成自定义输出。


|  变量  |  说明  |  示例值  | 
| --- | --- | --- | 
|  $\_\_nr\_metric  |  指标名称  |  CPU/User 时间  | 
|  $\_\_nr\_metric\_value  |  指标值  |  average\_value  | 

例如：

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

### 模板和变量
<a name="newrelic-templates-and-variables"></a>

1.  为控制面板创建模板变量。有关更多信息，请参阅 [模板和变量](templates-and-variables.md)。

1.  选择“查询”类型。

1.  选择“New Relic”数据来源。

1.  使用相对 [REST API](https://docs.newrelic.com/docs/apis/rest-api-v2) 端点（不包括文件扩展名）制定查询。

可用应用程序列表：

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

应用程序的可用指标列表：

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

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

 为了改善创建 New Relic Query Language（NRQL）查询时的编写体验，编辑器支持预定义的宏：
+  `$__timeFilter`（或 `[[timeFilter]]`）将根据您的控制面板时间范围对 `SINCE &lt;from&gt; UNTIL &lt;to&gt;` 进行插值。

示例：

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

 有关如何使用宏和模板变量的更多提示，请参阅编辑器的帮助部分。

### 警报事件
<a name="newrelic-alert-events"></a>

 选择您的 New Relic 数据来源并设置其他筛选器。如果未设置任何筛选器，则将返回所有事件。

 如果要按*实体 ID* 筛选事件，请使用模板变量，因为您可以选择实体名称而不是 ID。例如，要筛选特定应用程序的事件，请创建一个变量 `_$app_`，该变量用于检索应用程序列表并将其用作*实体 ID* 筛选器。

### 部署事件
<a name="newrelic-deployment-events"></a>

 *应用程序 ID* 是必填字段。