기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Dynatrace 데이터 소스에 연결
[https://www.dynatrace.com/](https://www.dynatrace.com)에 대한 데이터 소스. 이 데이터 소스를 사용하려면 Dynatrace 계정이 있어야 합니다.
**참고**
이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 내용은 [Enterprise 플러그인에 대한 액세스 관리](upgrade-to-enterprise-plugins.md) 단원을 참조하십시오.
또한 버전 9 이상을 지원하는 워크스페이스에서 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 내용은 [플러그인을 사용하여 워크스페이스 확장](grafana-plugins.md) 단원을 참조하십시오.
**알려진 제한 사항**
템플릿 변수는 여러 개를 선택할 수 없습니다. 한 개만 선택할 수 있습니다.
v2 지표 API만 지원됩니다.
## 특성
### 핵심 기능
+ 템플릿 변수
+ 지표 이름
+ 단일 선택만(**다중 선택 없음**)
+ 임시 필터
+ Annotations
+ 현재 지원되지 않음
+ 별칭
+ 지표 이름
+ 집계
+ 표시 이름
+ Host
+ 설명
+ 알림
+ 전체 알림 지원
### Dynatrace 특정 기능
Dynatrace 지표 v2 API를 사용하여 기본 제공 지표와 사용자 지정 지표를 모두 지원합니다. 자세한 내용은 Dynatrace 설명서: [Metrics API v2](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/) 및 [Metric ingestion](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/)을 참조하세요.
지표에 따라 API에서 추가 변환 옵션을 지원할 수 있습니다.
## Dynatrace 권한
Dynatrace에서 다음 권한이 필요합니다. - API V2(metrics.read) 권한을 사용하여 지표 읽기 - API V2(entities.read) 권한을 사용하여 엔터티 읽기
## Dynatrace에서 API 키 가져오기
API 토큰을 설정하려면 [Dynatrace API - Tokens and authentication](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token)을 참조하세요.
API 토큰에 대한 `metrics.read` 및 `entities.read` 권한을 설정합니다.
### 구성
1. 논리적 Grafana 서버 UI에서 **설정/데이터 소스**를 선택하고 **데이터 소스 추가**를 선택하세요.
1. **데이터 소스 추가** 페이지에서 **Dynatrace**를 필터링하고 Dynatrace 플러그인을 선택하세요.
1. Dynatrace 데이터 소스를 구성하려면 다음 파라미터가 필요합니다.
+ `Name` - Dynatrace 데이터 소스에 적용할 이름(기본값: Dynatrace).
+ `Dynatrace API Type` - 연결하려는 Dynatrace 인스턴스의 유형. `SaaS` 와 `Managed Cluster` 중에 하나입니다.
+ `Dynatrace API Token` - 이전 단계에서 생성한 API 토큰입니다.
다음 두 설정은 Dynatrace SaaS인지 아니면 관리형인지에 따라 달라집니다.
+ `yfc55578.live.dynatrace.com`의 SaaS 예제에서 **환경 ID**는 `yfc55578`입니다.
+ `yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`의 관리형 예제에서 **환경 ID**는 `abc99984-3af2-55tt-72kl-0672983gc45`이고 **도메인**은 `yd8888.managed-sprint.dynalabs.io`입니다.
1. 모든 구성 값을 설정한 후 **저장 및 테스트**를 선택하여 구성을 검증하고 변경 사항을 저장하세요.
### 데이터 소스 쿼리
쿼리 편집기를 사용하여 Dynatrace 지표 및 문제를 쿼리합니다. 쿼리 유형은 `metric` 또는 `problem`일 수 있습니다.
**지표 쿼리 유형**
+ `Metric` - 확인할 지표를 선택합니다. Dynatrace에서 지표 목록을 다시 가져오려면 **새로 고침** 버튼을 선택하세요.
+ `Aggregations` - 특정 지표에 사용할 집계를 선택합니다. 집계 값을 선택하여 집계 유형을 변경하거나 **\+**를 선택하여 다른 집계를 추가합니다.
+ `Transformations` - 쿼리 편집기에서는 변환을 선택할 수 있습니다. 그런 다음, 선택한 변환에 여러 파라미터를 입력하세요. 현재는 병합 변환만 지원됩니다. 병합 변환에 대한 자세한 내용은 [Merge transformation](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)을 참조하세요.
+ `Filters` - Dynatrace 데이터 소스는 각 지표에 적합한 필터를 동적으로 쿼리합니다. 필터를 추가하려면 Dynatrace 쿼리 편집기의 **필터** 레이블 옆에 있는 **\+** 기호를 선택하고 필터링할 필드를 선택한 다음, 사용할 연산자를 선택하고 필터링할 값을 선택합니다. Dynatrace 데이터 소스를 사용하면 복잡한 논리적 비교를 생성하기 위해 함께 결합할 수 있는 필터 그룹을 생성할 수 있습니다. 대부분의 사용 사례에서 필터 그룹은 필요하지 않습니다. 태그와 함게 필터를 생성할 때 선택한 연결과 관계없이 Dynatrace는 항상 AND를 사용합니다. Dynatrace는 태그가 있는 OR 필터를 지원하지 않습니다.
+ `Alias` - Dynatrace 데이터 소스를 사용하는 동안 두 가지 유형의 별칭이 나타납니다. 첫 번째는 정적 별칭입니다. 이 유형의 별칭은 빌드하는 모든 쿼리에서 사용할 수 있으며 별칭의 이름은 소문자로 시작합니다. 두 번째 별칭은 동적 별칭으로, 쿼리에서 사용 중인 지표에 따라 변경되며 별칭의 이름은 대문자로 시작합니다. Dynatrace 플러그인은 `Metric Names`, `Aggregation`, `Display Name`, `Host`, `Description`과 같은 여러 별칭을 지원합니다.
| 이름 | 값 |
| --- | --- |
| $name | builtin:apps.other.keyUserActions.reportedErrorCount.os |
| $aggregation | auto,value |
| $displayName | 보고된 오류 수(키 사용자 작업, OS별) [mobile, custom] |
**문제 쿼리 유형**
+ `Problem Query Type` - 문제 쿼리 유형을 선택합니다. 현재, 피드 문제 쿼리 유형만 지원됩니다. 피드 문제 쿼리 유형에 대한 자세한 내용은 [병합 변환](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)을 참조하세요.
+ `Status Filter` - 상태별로 결과 문제를 필터링합니다.
+ `Impact Filter` - 영향 수준별로 결과 문제를 필터링합니다.
+ `Severity Filter` - 심각도 수준별로 결과 문제를 필터링합니다.
+ `Expand Details` - 설정된 경우 응답에 관련 이벤트를 포함합니다.
#### 템플릿 변수 사용
새 Dynatrace 쿼리 변수를 추가하려면 [새 템플릿 변수 추가](variables-types.md#add-a-query-variable)를 참조하세요. Dynatrace 데이터 소스를 다음과 같은 사용 가능한 쿼리에 대한 데이터 소스로 사용합니다.
+ `Query type` - 쿼리 유형을 선택합니다. 쿼리 유형은 일부 데이터를 일부 키 또는 설명자와 연결합니다.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex` - (선택 사항) 정규식을 사용해 쿼리에서 반환된 값을 필터링합니다.
**참고**
`Multi-value` 및 `Include All option`은 현재 Dynatrace 데이터 소스에서 지원되지 않습니다.
변수를 생성한 후에는 **지표** 드롭다운 메뉴에서 찾을 수 있습니다.
##### Dynatrace에 대한 대시보드 가져오기
대시보드를 가져오려면 [대시보드 가져오기](dashboard-export-and-import.md#importing-a-dashboard) 섹션을 참조하세요. 가져온 대시보드는 **구성** > **데이터 소스** > Dynatrace 데이터 소스 선택 > **대시보드** 탭을 선택하여 확인할 수 있습니다(사전에 만든 사용 가능한 대시보드 표시).