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

# AWS X-Ray 데이터 소스에 연결
<a name="x-ray-data-source"></a>

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

 를 데이터 소스 AWS X-Ray 로 추가한 다음 대시보드를 빌드하거나 X-Ray로 탐색을 사용하여 트레이스, 분석 또는 인사이트를 살펴봅니다.

 Amazon Managed Grafana를 사용하면 Grafana 워크스페이스 콘솔의 데이터 소스 구성 옵션을 사용하여 X-Ray를 AWS 데이터 소스로 추가할 수 있습니다. 이 기능은 기존 X-Ray 계정을 검색하여 X-Ray를 데이터 소스로 추가하는 작업을 간소화하고 X-Ray에 액세스하는 데 필요한 인증 자격 증명의 구성을 관리합니다. 이 방법을 사용하여 인증을 설정하고 X-Ray를 데이터 소스로 추가하거나 자체 관리형 Grafana 서버에서와 동일한 방법을 사용하여 데이터 소스와 필요한 인증 자격 증명을 수동으로 설정할 수 있습니다.

**Topics**
+ [AWS 데이터 소스 구성을 사용하여 X-Ray를 데이터 소스로 추가](xray-adding-AWS-config.md)
+ [수동으로 X-Ray 데이터 소스 추가](xray-add-the-data-source.md)
+ [X-Ray 설정](#xray-settings)
+ [X-Ray 데이터 소스 사용](xray-using.md)

# AWS 데이터 소스 구성을 사용하여 X-Ray를 데이터 소스로 추가
<a name="xray-adding-AWS-config"></a>

 AWS 데이터 소스 구성을 사용하려면 먼저 Amazon Managed Grafana 콘솔을 사용하여 계정 또는 전체 조직 단위에서 X-Ray 리소스를 읽는 데 필요한 IAM 정책을 워크스페이스에 부여하는 서비스 관리형 IAM 역할을 활성화합니다. 그런 다음, Amazon Managed Grafana 워크스페이스 콘솔을 사용하여 X-Ray를 데이터 소스로 추가합니다.

**AWS 데이터 소스 구성을 사용하여 X-Ray를 데이터 소스로 추가하려면**

1. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)에서 Amazon Managed Grafana 콘솔을 엽니다.

1. 페이지 왼쪽 상단에서 메뉴 아이콘을 선택한 다음, **모든 워크스페이스**를 선택합니다.

1. 워크스페이스 이름을 선택하세요.

1. 이 워크스페이스를 생성할 때이 워크스페이스에 서비스 관리형 권한을 사용하도록 선택하지 않은 경우 Grafana 워크스페이스 콘솔에서 AWS 데이터 소스 구성 옵션을 사용할 수 있도록 적절한 IAM 역할 및 정책이 활성화되도록 고객 관리형 권한을 사용하여 서비스 관리형 권한을 사용하는 것으로 변경합니다. 이를 수행하려면 **IAM 역할** 옆의 편집 아이콘을 선택하고 **서비스 관리형**, **변경 사항 저장**을 선택하세요. 자세한 내용은 [AWS 데이터 소스에 대한 Amazon Managed Grafana 권한 및 정책](AMG-manage-permissions.md) 단원을 참조하십시오.

1. **데이터 소스** 탭을 선택하세요. 그런 다음 **AWS X-Ray**의 확인란을 선택하고 **작업**, **서비스 관리형 정책 활성화**를 선택하세요.

1. **데이터 소스** 탭을 다시 선택한 다음, **AWS X-Ray** 행에서 **Grafana에서 구성**을 선택하세요.

1. 필요한 경우 IAM Identity Center를 사용하여 Grafana 워크스페이스 콘솔에 로그인합니다.

1. Grafana 워크스페이스 콘솔의 왼쪽 탐색 모음에서 AWS 아이콘을 선택한 다음**AWS services**, **X-Ray**를 선택합니다.

1. X-Ray 데이터 소스가 쿼리할 기본 리전을 선택하고 계정을 선택한 다음, **데이터 소스 추가**를 선택하세요.

# 수동으로 X-Ray 데이터 소스 추가
<a name="xray-add-the-data-source"></a>

**수동으로 X-Ray 데이터 소스를 추가하는 방법**

1.  Grafana 콘솔 사이드 메뉴에서 **구성**(톱니) 아이콘에서 일시 중지하고 **데이터 소스**를 선택하세요.

1. **데이터 소스 추가**를 선택합니다.

1. **X-Ray** 데이터 소스를 선택하세요. 필요한 경우 검색 상자에 **X-Ray**를 찾을 수 있습니다.

## X-Ray 설정
<a name="xray-settings"></a>


|  이름  |  설명  | 
| --- | --- | 
|  이름  |  데이터 소스 이름. 패널 및 쿼리에서 데이터 소스를 보는 방법입니다. | 
|  기본값  |  기본 데이터 소스는 새 패널에 대해 미리 선택됨을 의미합니다. | 
|  기본 리전  |  쿼리 편집기에서 리전을 설정하는 데 사용됩니다(쿼리별로 변경 가능). | 
|  인증 제공업체  |  자격 증명을 가져올 제공업체를 지정합니다. | 
|  자격 증명 프로파일 이름  |  사용할 프로파일의 이름을 지정합니다(\$1/.aws/credentials 파일을 사용하는 경우). 기본값을 사용하려면 비워 둡니다. | 
|  역할 ARN 수임  |  수임할 역할의 ARN을 지정합니다. | 
|  외부 ID  |  외부 ID로 생성된 다른 계정에서 역할을 수임하는 경우 여기에 외부 ID를 지정합니다. | 

### Authentication
<a name="xray-authentication"></a>

이 섹션에서는 X-Ray 데이터 소스에 대해 사용할 수 있는 다양한 유형의 인증을 다룹니다.

#### IAM 역할
<a name="xray-iam-roles"></a>

 현재 X-Ray에 대한 모든 액세스는 공식 AWS SDK를 사용하여 Grafana 워크스페이스 백엔드에서 서버 측에서 수행됩니다. Grafana 서버가 실행 중인 경우 IAM 역할을 사용할 AWS수 있으며 인증이 자동으로 처리됩니다.

 자세한 내용은 [IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)을 참조하세요.

### IAM 정책
<a name="xray-iam-policies"></a>

 Grafana에는 X-Ray 데이터 및 EC2 태그/인스턴스/리전을 읽을 수 있도록 IAM을 통해 부여된 권한이 필요합니다. 이러한 권한을 IAM 역할에 연결하고 역할 수임을 위해 기본 제공 Grafana 지원을 사용할 수 있습니다.

 다음 코드 예제에서는 최소 정책을 보여줍니다.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:BatchGetTraces",
                "xray:GetTraceSummaries",
                "xray:GetTraceGraph",
                "xray:GetGroups",
                "xray:GetTimeSeriesServiceStatistics",
                "xray:GetInsightSummaries",
                "xray:GetInsight",
                "ec2:DescribeRegions"
            ],
            "Resource": "*"
        }
    ]
}
```

------

#### 자격 AWS 증명 예
<a name="xray-example-aws-credentials"></a>

 Amazon Managed Grafana에서는 자격 증명 파일 방법을 사용할 수 없습니다.

# X-Ray 데이터 소스 사용
<a name="xray-using"></a>

## 쿼리 편집기
<a name="xray-query-editor"></a>

 편집기에서 가장 중요한 필드는 쿼리 유형입니다. 다음과 같은 네 가지 쿼리 유형이 있습니다.
+  트레이스 목록(의 트레이스 AWS) 
+  추적 통계 
+  추적 분석(의 분석 AWS) 
+  인사이트 

## 추적 목록
<a name="xray-trace-list"></a>

 추적 목록 유형을 사용하면 테이블에 표시되는 추적을 검색할 수 있습니다. 첫 번째 열에서 추적 ID를 선택하면 오른쪽에 추적이 열립니다. 편집기에서 쿼리 필드를 확인합니다. 쿼리를 작성하거나 표현식을 필터링하거나 추적 보기에 표시되는 단일 추적 ID를 삽입할 수 있습니다. 필터 표현식에 대한 자세한 내용은 [AWS X-Ray 설명서](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html)를 참조하세요.

**참고**  
 추적 목록에는 처음 1,000개의 추적만 표시됩니다.

## 추적 통계
<a name="xray-trace-statistics"></a>

 추적 통계에서는 오류, 결함, 스로틀, 성공 및 총 개수에 대한 정보를 보여주는 그래프 및 테이블을 볼 수 있습니다. 쿼리 편집기의 열 필드를 사용하여 지정된 열만 볼 수 있습니다.

## Trace Analytics
<a name="xray-trace-analytics"></a>

 추적 분석에서 다음 테이블을 시각화할 수 있습니다.
+  근본 원인 
  +  응답 시간 
    +  근본 원인 서비스(경로의 마지막 서비스) 
    +  경로(여러 경로) 
  +  오류 
    +  근본 원인 서비스(경로의 마지막 서비스) 
    +  경로 
    +  오류 메시지 
  +  결함 
    +  근본 원인 서비스(경로의 마지막 서비스) 
    +  경로 
    +  오류 메시지 
+  최종 사용자 영향 
+  URL 
+  HTTP 상태 코드 

## 인사이트
<a name="xray-insights"></a>

 인사이트에서는 인사에트에 대한 요약 테이블을 볼 수 있습니다. InsightId를 선택하면 AWS 관리 콘솔로 이동합니다.

## 알림
<a name="xray-alerting"></a>

 X-Ray 쿼리는 숫자 데이터를 반환할 수 있으므로 알림이 지원됩니다. 자세한 내용은 [Grafana 알림](alerts-overview.md) 단원을 참조하십시오.