Grafana

Timestream for InfluxDB 인스턴스의 데이터를 시각화하려면 Amazon Managed Grafana, Grafana 또는 Grafana Cloud를 사용합니다.

Grafana에 연결

중요

이 가이드의 지침을 따르려면 Grafana Cloud 또는 Grafana 10.3 이상이 필요합니다.

1. Timestream for InfluxDB DB 인스턴스나 Timestream for InfluxDB DB 클러스터를 생성합니다.

2. Amazon Managed Grafana 워크스페이스를 생성하거나, Grafana Cloud에 가입하거나, Grafana를 다운로드하여 설치합니다.

3. Amazon Managed Grafana 또는 Grafana Cloud 사용자 인터페이스(UI)를 방문합니다. 또는 Grafana를 로컬에서 실행 중인 경우 Grafana를 시작하고 브라우저에서 http://localhost:3000을 방문합니다.

4. Grafana UI의 왼쪽 탐색 창에서 연결 섹션을 열고 새 연결 추가를 선택합니다.

5. 사용 가능한 데이터 소스 목록에서 InfluxDB를 선택하고 새 데이터 소스 추가를 클릭합니다.

6. 데이터 소스 구성 페이지에서 InfluxDB 데이터 소스의 이름을 입력합니다.

7. 쿼리 언어 드롭다운 목록에서 InfluxDB 2.7(Flux 또는 InfluxQL)에서 지원하는 쿼리 언어 중 하나를 선택합니다.

중요

SQL은 InfluxDB 3에서만 지원됩니다.

Flux를 사용하도록 Grafana 구성

InfluxDB 데이터 소스에서 쿼리 언어로 Flux를 선택한 상태에서 InfluxDB 연결을 구성합니다.

1. HTTP 섹션의 URL 필드에 InfluxDB URL을 입력합니다.

   https://your-timestream-for-influxdb-endpoint:8086

2. InfluxDB 세부 정보 섹션에서 다음 작업을 수행합니다.

   • 조직: InfluxDB 조직 이름 또는 ID

   • 토큰: InfluxDB API 토큰

   • 기본 버킷: Flux 쿼리에 사용할 기본 버킷

   • 최소 시간 간격: Grafana 최소 시간 간격 기본값은 10초입니다.

   • 최대 계열: Grafana가 처리할 최대 계열 또는 테이블 수 기본값은 1,000입니다.

   

3. 저장 및 테스트를 클릭합니다. Grafana는 InfluxDB 2.7 데이터 소스에 연결을 시도하고 테스트 결과를 반환합니다.

InfluxQL을 사용하도록 Grafana 구성

InfluxQL을 사용하여 InfluxDB 2.7을 쿼리하려면 아래에서 사용 사례를 찾은 다음 Grafana 구성 지침을 완료하세요.

InfluxDB 2.7 새로 설치:

InfluxDB 2.7을 새로 설치한 환경에서 Grafana가 InfluxQL을 사용하도록 구성하려면 다음을 수행하세요.

1. InfluxDB 2.7 토큰으로 인증합니다.

2. DBRP 매핑을 수동으로 생성합니다.

InfluxDB 1.x에서 2.7로 수동 마이그레이션:

InfluxDB 1.x에서 InfluxDB 2.7로 수동으로 마이그레이션한 경우 Grafana가 InfluxQL을 사용하도록 구성하려면 다음을 수행하세요.

1. InfluxDB 1.x 인스턴스에 인증이 필요한 경우 이전 1.x 사용자 이름 및 암호와 일치하도록 v1 호환 인증 자격 증명을 생성합니다. 그렇지 않으면 InfluxDB v2 토큰 인증을 사용합니다.

2. DBRP 매핑을 수동으로 생성합니다.

InfluxDB 데이터 소스에서 쿼리 언어로 InfluxQL을 선택한 상태에서 InfluxDB 연결을 구성합니다.

1. HTTP 섹션의 URL 필드에 InfluxDB URL을 입력합니다.

   https://your-timestream-for-influxdb-endpoint:8086

2. 사용자 지정 HTTP 헤더 섹션에 다음을 입력합니다.

   • 헤더 추가를 선택합니다. InfluxDB API 토큰을 제공합니다.

     • 헤더에 권한 부여를 입력합니다.

     • 값에서 Token 스키마를 사용하고 InfluxDB API 토큰을 제공합니다. 예를 들어 Token y0uR5uP3rSecr3tT0k3n입니다.

3. InfluxDB 세부 정보 섹션에서 다음 작업을 수행합니다.

   • 데이터베이스: InfluxDB 2.7 버킷에 매핑된 데이터베이스 이름입니다.

   • 사용자 및 암호: InfluxDB 1.x 호환성 권한 부여와 연결된 사용자 이름 및 암호입니다.

   • HTTP 메서드: GET을 선택합니다.

   

4. 저장 및 테스트를 클릭합니다. Grafana는 InfluxDB 2.7 데이터 소스에 연결을 시도하고 테스트 결과를 반환합니다.

데이터 쿼리 및 시각화

InfluxDB 연결을 구성한 후 Grafana와 Flux를 사용하여 InfluxDB 인스턴스에 저장된 시계열 데이터를 쿼리하고 시각화할 수 있습니다.

Grafana 사용에 대한 자세한 내용은 Grafana 기술 설명서를 참조하세요. Flux를 처음 배우는 경우 Get started with Flux를 참조하세요.