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

# Amazon Timestream 데이터 소스에 연결
<a name="timestream-datasource"></a>

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

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



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

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

**AWS 데이터 소스 구성을 사용하여 Timestream을 데이터 소스로 추가하려면**

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. **데이터 소스** 탭을 선택하세요. 그런 다음, **Amazon Timestream**의 확인란을 선택하고 **작업**, **서비스 관리형 정책 활성화**를 선택하세요.

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

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

1. Grafana 워크스페이스 콘솔의 왼쪽 탐색 모음에서 **앱을** 선택한 다음 **AWS 데이터 소스를** 선택합니다(Grafana v8에서 왼쪽 메뉴에서 AWS 아이콘 선택).

1. **AWS 서비스** 탭을 선택한 다음, **Timestream**을 선택하세요.

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

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

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

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

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

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

## Timestream 설정
<a name="timestream-settings"></a>


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

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

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

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

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

# Timestream 데이터 소스 사용
<a name="timestream-query-editor"></a>

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

 쿼리 편집기는 이전에 나열된 매크로와 대시보드 템플릿 변수 외에도 Timestream 구문을 허용합니다.

 **Ctrl\$1Space**를 눌러 IntelliSense 제안을 엽니다.

## 매크로
<a name="timestream-macros"></a>

 구문을 단순화하고 날짜 범위 필터와 같은 동적 부분을 허용하기 위해 쿼리에 매크로가 포함될 수 있습니다.


|  매크로 예제  |  설명  | 
| --- | --- | 
|  *\$1\$1\$1database* |  선택한 데이터베이스를 지정합니다. 이때 데이터 소스 구성의 기본값 또는 쿼리 편집기의 명시적 값을 사용합니다. | 
|  *\$1\$1\$1table*  |  선택한 데이터베이스를 지정합니다. 이때 데이터 소스 구성의 기본값 또는 쿼리 편집기의 명시적 값을 사용합니다. | 
|  *\$1\$1\$1measure*  |  선택한 측정을 지정합니다. 이때 데이터 소스 구성의 기본값 또는 쿼리 편집기의 명시적 값을 사용합니다. | 
|  *\$1\$1\$1timeFilter*  |  대시보드 범위로 시간을 제한하는 표현식으로 대체됩니다. | 
|  *\$1\$1\$1interval\$1ms*  |  그래프의 단일 픽셀에서 포함해야 하는 시간을 나타내는 숫자로 대체됩니다. |