本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連接至新的 Relic 資料來源
<a name="new-relic-data-source"></a>

 本節涵蓋 Grafana 的新版本 [APM](https://newrelic.com/products/application-monitoring) 和[洞見](https://newrelic.com/products/insights)。

**注意**  
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。  
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。

## 功能
<a name="newrelic-features"></a>
+  範本變數 
  +  指標名稱 
  +  指標值 
+  註釋 
+  別名 
  +  指標名稱 
  +  指標值 
+  臨機操作篩選條件 
  +  目前不支援 
+  提醒 

## Configuration
<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) 的欄位。

## Usage
<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 APM。
+  **Insights**； 用於透過 [NRQL](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions) 查詢新的 Relic Insights。

### 別名
<a name="newrelic-aliases"></a>

 您可以結合純文字與下列變數來產生自訂輸出。


|  變數  |  Description  |  範例值  | 
| --- | --- | --- | 
|  \$1\$1\$1nr\$1metric  |  指標名稱  |  CPU/使用者時間  | 
|  \$1\$1\$1nr\$1metric\$1value  |  指標值  |  average\$1value  | 

例如：

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

### 範本和變數
<a name="newrelic-templates-and-variables"></a>

1.  為您的儀表板建立範本變數。如需詳細資訊，請參閱[範本和變數](templates-and-variables.md)。

1.  選取「查詢」類型。

1.  選取「新複本」資料來源。

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>

 為了改善建立新複本查詢語言 (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>

 選取您的新複本資料來源，並設定其他篩選條件。如果未設定任何篩選條件，則會傳回所有事件。

 如果您想要依*實體 ID* 篩選事件，請使用範本變數，因為您可以選取實體名稱而非 ID。例如，若要篩選特定應用程式的事件，請建立可`_$app_`擷取應用程式清單並將其用作*實體 ID* 篩選條件的變數。

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

 *應用程式 ID* 是必要欄位。