콘텐츠로 이동

QueryHub

QueryHub는 Guance에 내장된 외부 데이터 쿼리 기능입니다. 연결을 구성하면 외부 데이터 소스를 지원하는 쿼리 진입점에서 데이터베이스, 메트릭 서비스 또는 문서 저장소의 데이터를 읽어 분석 및 차트 표시에 사용할 수 있으며, 이러한 데이터를 먼저 워크스페이스로 수집할 필요가 없습니다.

QueryHub는 네이티브 쿼리와 DQL Like 두 가지 쿼리 방식을 제공합니다. 두 방식 모두 입력란에 직접 내용을 작성하며, 선택한 인스턴스에서 실제로 제공되는 쿼리 모드를 기준으로 합니다.

네이티브 쿼리에서 MySQL, PostgreSQL은 SQL을 입력하고, Prometheus, Elasticsearch, MongoDB는 전체 쿼리 JSON을 입력합니다. DQL Like에서는 전체 QueryHub 표현식을 입력합니다. DQL Like는 QueryHub의 쿼리 구문이며, 워크스페이스 내 로그와 메트릭을 쿼리할 때 사용하는 일반 DQL과 다릅니다.

데이터 소스 유형 선택

유형 쿼리 대상 구성 및 쿼리 가이드
MySQL 데이터베이스의 테이블 MySQL
PostgreSQL 지정된 Schema의 테이블 PostgreSQL
Prometheus 메트릭 및 샘플 레이블 Prometheus
Elasticsearch 구성된 범위 내의 인덱스 및 문서 Elasticsearch
MongoDB 구성된 데이터베이스, 컬렉션 및 문서 MongoDB

쿼리 액세스 범위는 선택한 데이터 소스의 연결 구성, 계정 읽기 권한 및 워크스페이스 권한에 의해 함께 결정됩니다.

연결 추가

1. 연결 방식 및 데이터 소스 유형 선택

대상 워크스페이스로 전환한 후 통합 > 외부 데이터 소스로 이동하여 데이터 소스 추가를 클릭하고 QueryHub 연결 방식과 데이터 소스 유형을 선택합니다.

2. 연결 속성 입력

모든 유형에서 다음 공통 필드를 먼저 입력해야 합니다. 인증 필드는 선택한 인증 방식에 따라 표시되며, 구체적인 필수 조건은 해당 데이터 소스 유형의 설명을 참조하십시오. 인증서 필드는 TLS 요구 사항에 따라 입력합니다.

구성 항목 필수 의미 및 입력 방식
데이터 소스 ID 예 이 연결의 식별자를 직접 입력합니다(예: mysql-orders). 최대 100자입니다. DQL Like 표현식의 datasource에는 이 값을 사용하며, 데이터베이스에서 가져온 계정 또는 데이터베이스 이름이 아닙니다
이름 예 쿼리 페이지에서 연결을 식별하기 쉬운 이름입니다(예: "프로덕션 주문 데이터베이스"). 최대 100자입니다
설명 아니요 연결 용도 또는 데이터 범위를 보충 설명합니다. 최대 256자입니다

데이터 소스 구성 및 쿼리 예시에서 해당 유형에 따라 주소, 데이터베이스 또는 리소스 범위 및 인증 정보를 입력합니다. 주소, 계정, 비밀번호 또는 토큰은 데이터 소스 관리자, 운영 담당자 또는 클라우드 서비스의 연결 정보 페이지에서 제공되며, Guance의 로그인 계정이 아닙니다.

TLS 모드와 인증서 등의 필드는 공통 TLS 구성을 참조하고 서버 요구 사항에 따라 입력합니다.

계정에는 대상 데이터에 대한 읽기 전용 쿼리 권한이 있어야 합니다. 연결 구성은 Guance에 데이터 소스 액세스 방법을 알려주는 것으로, 데이터베이스에 쿼리 문을 미리 저장할 필요가 없으며 데이터베이스 계정의 권한을 대신 추가하지도 않습니다.

3. 연결 테스트

연결 정보를 입력한 후 연결 테스트를 클릭하고 결과에 따라 다음 작업을 진행합니다.

결과 처리 방법
연결 성공 구성을 계속 저장합니다. 적용된 후 실제 쿼리를 통해 대상 데이터의 읽기 권한을 검증합니다
주소, 네트워크 또는 시간 초과 오류 주소와 포트를 확인합니다. 필요한 경우 운영 담당자에게 네트워크, 허용 목록 및 서비스 상태 점검을 요청합니다
인증 실패 데이터 소스 관리자에게 사용자 이름, 비밀번호, 인증 데이터베이스 또는 토큰이 올바른지 확인합니다
권한 부족 계정에 대상 데이터베이스, 테이블, 인덱스, 컬렉션 또는 메트릭에 대한 읽기 권한이 있는지 확인합니다

연결 테스트 통과가 모든 객체를 쿼리할 수 있음을 의미하지는 않습니다. 연결 주소, 리소스 범위 또는 인증 정보를 수정한 후에는 다시 테스트해야 합니다.

4. 쿼리 설정 및 권한

쿼리 설정은 기본적으로 접혀 있으며, 펼친 후 필요에 따라 페이지에서 제공하는 옵션을 입력할 수 있습니다. 구체적인 필드, 기본값 및 최대값은 펼친 후의 페이지를 기준으로 합니다. 이 설정은 연결 테스트에만 사용되는 것이 아니라 저장 후 실제 쿼리에 사용됩니다.

권한 영역에서 사용자 지정 작업 권한을 설정합니다.

  • 비활성화: "외부 데이터 소스"의 기본 권한을 따릅니다.
  • 활성화: 펼쳐진 권한 옵션에 따라 이 연결의 작업 권한을 설정합니다.

이러한 권한은 워크스페이스 멤버의 연결 작업을 제어하며, 데이터베이스 계정 자체의 읽기 권한은 변경하지 않습니다.

5. 저장 및 쿼리 검증

페이지 하단의 저장을 클릭한 후 데이터 소스 목록으로 돌아가 구성을 확인하고, 쿼리 페이지로 이동하여 해당 연결을 선택한 뒤 읽기 전용 쿼리를 실행하여 사용 가능 여부를 검증합니다.

DQL Like를 사용할 때는 구성 시 입력한 데이터 소스 ID를 표현식의 datasource에 작성하고, 쿼리 페이지에서 선택한 인스턴스와 일치시킵니다. ID는 데이터 소스 목록 또는 상세에서 확인하고 복사할 수 있습니다.

쿼리 시작

  • 임시 쿼리 및 분석: 메트릭 > 메트릭 분석으로 이동하여 + 데이터 소스 추가를 클릭하고 연결과 쿼리 방식을 선택한 후 쿼리를 입력하고 오른쪽 상단의 새로고침을 클릭합니다. 전체 단계는 메트릭 분석에서 쿼리를 참조하십시오.
  • 차트에 저장: 대시보드의 차트 편집 페이지로 이동하여 쿼리 영역에 데이터 소스를 추가하고 쿼리를 구성한 후 미리보기 결과를 확인하고 저장합니다. 전체 단계는 대시보드 차트에서 쿼리를 참조하십시오.

각 유형의 네이티브 쿼리, DQL Like, 소스 및 필드 조회 예시는 데이터 소스 구성 및 쿼리 예시를 참조하십시오.

문서 평가

이 페이지가 도움이 되었나요?