기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# New Relic 데이터 소스에 연결
<a name="new-relic-data-source"></a>

 이 섹션에서는 Grafana에 대한 New Relic [APM](https://newrelic.com/products/application-monitoring) 및 [Insights](https://newrelic.com/products/insights)를 다룹니다.

**참고**  
이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 내용은 [Enterprise 플러그인에 대한 액세스 관리](upgrade-to-enterprise-plugins.md) 단원을 참조하십시오.  
또한 버전 9 이상을 지원하는 워크스페이스에서 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 내용은 [플러그인을 사용하여 워크스페이스 확장](grafana-plugins.md) 단원을 참조하십시오.

## 특성
<a name="newrelic-features"></a>
+  템플릿 변수 
  +  지표 이름 
  +  지표 값 
+  Annotations 
+  별칭 
  +  지표 이름 
  +  지표 값 
+  임시 필터 
  +  현재 지원되지 않음 
+  알림 

## 구성
<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 APM을 쿼리합니다.
+  **인사이트** - [NRQL](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions)을 통해 New Relic Insights를 쿼리합니다.

### 별칭
<a name="newrelic-aliases"></a>

 일반 텍스트와 다음 변수를 결합하여 사용자 지정 출력을 생성할 수 있습니다.


|  변수  |  설명  |  예시 값  | 
| --- | --- | --- | 
|  \$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.  '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*는 필수 필드입니다.