콘텐츠로 이동

QueryHub 쿼리 및 활용

통합 > 외부 데이터 소스에서 QueryHub 설정을 완료하고 적용되었는지 확인한 후, 메트릭 분석 또는 대시보드 차트에서 해당 데이터 소스를 선택할 수 있습니다. 현재 사용자에게 해당 쿼리 권한이 있어야 하며, 사용 가능한 쿼리 모드는 선택한 인스턴스에서 실제로 개방된 모드를 기준으로 합니다.

메트릭 분석에서 쿼리

  1. 메트릭 > 메트릭 분석으로 이동합니다.
  2. 쿼리 영역 아래의 + 데이터 소스 추가를 클릭하여 데이터 소스 쿼리 행을 추가합니다.
  3. 해당 행의 데이터 소스 드롭다운에서 연결 이름을 기준으로 설정된 QueryHub 데이터 소스를 선택합니다.
  4. 데이터 소스 오른쪽에서 네이티브 쿼리 또는 DQL Like를 선택하고, 입력 상자에 해당 쿼리 문 또는 표현식을 직접 작성합니다.
  5. 페이지 오른쪽 상단의 새로고침 버튼을 클릭하고, 아래에서 쿼리 결과를 확인한 후 결과 구조에 적합한 표시 방식을 선택합니다.

여기의 + 데이터 소스 추가는 쿼리 행을 추가하는 데 사용됩니다. 연결 정보의 추가 또는 수정은 여전히 통합 > 외부 데이터 소스에서 수행합니다.

대시보드 차트에서 쿼리

  1. 시나리오 > 대시보드로 이동하여 대상 대시보드를 엽니다.
  2. 새 차트를 추가하거나, 기존 차트 메뉴에서 수정을 선택하여 차트 편집 페이지로 이동합니다.
  3. 외부 데이터 소스를 지원하는 차트 쿼리 영역에서 데이터 소스 추가를 클릭하고, 설정된 QueryHub 데이터 소스를 선택합니다.
  4. 네이티브 쿼리 또는 DQL Like를 선택하고 쿼리 내용을 입력한 후 미리보기 결과를 확인합니다.
  5. 결과에 따라 차트의 차원, 값 등 표시 항목을 설정하고 확인 후 차트를 저장합니다.

저장 후 차트는 선택한 데이터 소스와 쿼리 구성을 유지합니다. 이후 새로고침 시에도 해당 데이터 소스의 쿼리 권한을 충족해야 합니다. 차트의 일반적인 작업은 차트 추가를 참조하세요.

쿼리 방식 선택

네이티브 쿼리

네이티브 쿼리를 선택한 후 데이터 소스 유형에 따라 입력 상자에 SQL 또는 전체 쿼리 JSON을 입력합니다:

데이터 소스 네이티브 쿼리 편집기 내용 소스 및 필드 확인 방법
MySQL SQL 문, 한 번에 하나 SHOW TABLES, SHOW COLUMNS를 수동으로 실행
PostgreSQL SQL 문, 구성된 Schema 사용 information_schema의 테이블, 열 정보를 수동으로 쿼리
Prometheus 전체 JSON: operation은 query 또는 query_range이고, PromQL은 statement에 둡니다 범위를 제한한 쿼리로 현재 샘플의 시계열 이름과 레이블을 확인
Elasticsearch 전체 JSON: operation은 search이고, 요청 본문은 arguments.body에 둡니다 인덱스 범위는 인스턴스 설정에서 확인하고, 필드는 일치하는 문서 샘플에서 확인합니다. 전체 mapping은 데이터 소스 측에서 확인합니다
MongoDB 전체 JSON: operation은 find이고, 필터, 프로젝션 등의 파라미터는 arguments에 둡니다 데이터베이스, 컬렉션은 인스턴스 설정에서 확인하고, 필드는 샘플 문서에서 확인합니다

네이티브 쿼리와 소스, 필드 확인 예시는 위의 해당 유형 절에 있습니다. 예시의 쿼리 대상, 필드를 실제 값으로 바꾼 뒤 입력 상자에 입력하고, 오른쪽 상단의 새로고침을 클릭합니다.

DQL Like

DQL Like를 선택한 후 입력 상자에 전체 표현식을 직접 작성하여 쿼리 대상, 반환 필드, 필터 조건을 지정합니다.

  1. 데이터 소스를 선택한 후 DQL Like로 전환합니다.
  2. 입력 상자에 전체 DQL Like 표현식을 입력합니다.
  3. source에는 해당 데이터 소스 유형을, datasource에는 현재 선택한 인스턴스의 ID를 입력한 다음 실제 데이터에 맞게 쿼리 대상, 필드, 조건을 수정합니다. 인스턴스 ID는 통합 > 외부 데이터 소스의 목록 또는 상세에서 확인하고 복사할 수 있습니다.
  4. 페이지 오른쪽 상단의 새로고침을 클릭하여 결과를 확인합니다.

정렬, 집계 또는 그룹화를 사용할 때는 DQL Like 문법에 따라 작성하고, 쿼리 대상과 필드가 선택한 데이터 소스의 요구 사항을 충족하는지 확인합니다.

DQL Like는 QueryHub의 쿼리 문법이며, 워크스페이스에서 로그, 메트릭을 쿼리할 때 사용하는 일반 DQL과 다릅니다. 표현식의 source, datasource는 페이지에서 선택한 데이터 소스 유형 및 인스턴스와 일치해야 합니다.

모든 예시는 읽기 전용입니다. 데이터베이스 계정 자체에도 쿼리 대상에 대한 읽기 권한이 필요합니다.

시간 범위 적용 방식

  • MySQL, PostgreSQL 등의 네이티브 쿼리는 문에 있는 조건에 따라 실행됩니다. 시간을 제한해야 하는 경우 실제 시간 필드를 사용하여 필터 조건을 작성합니다.
  • Prometheus 범위 쿼리는 JSON의 arguments.start, arguments.end에서 #{startTime}, #{endTime}을 참조하며, 프런트엔드가 차트 시간을 자동으로 초 단위로 변환합니다. arguments.step도 초 단위입니다. 즉시 쿼리와 범위 쿼리는 결과의 의미가 다릅니다.
  • DQL Like 쿼리는 표현식에 지정된 시간 조건에 따라 실행됩니다.

Prometheus 범위 쿼리는 위 차트 시간 변수를 참조한 후 페이지 시간 범위에 따라 변경됩니다. MySQL, PostgreSQL의 SQL에는 여전히 해당 시간 필터 조건을 작성해야 합니다.

쿼리 결과 표시 방식

반환 내용 확인 방법
MySQL, PostgreSQL의 일반 행과 열 서버에서 반환된 열, 유형, 행 순서에 따라 표시되며, 먼저 표를 사용하여 상세를 확인할 수 있습니다
Prometheus 샘플 Studio 표의 “이름”, “레이블”은 시계열의 name, tags에서 가져옵니다. 시간 열은 time이며, 인터페이스는 Unix 밀리초를 사용하고 페이지에서는 형식화하여 표시합니다. 값 열 이름은 메트릭 이름 또는 표현식에 따라 달라집니다
Elasticsearch, MongoDB 문서 표 차트를 사용하고 document JSON을 펼쳐 확인합니다. JSON 필드는 중첩을 유지하며, 프로젝션 필드 선택으로 인해 자동으로 독립된 열이 되지 않습니다
빈 결과 쿼리는 성공했을 수 있지만 일치하는 레코드가 없습니다. 시간, 필터 조건 및 설정 범위를 확인합니다
잘린 결과 일부 데이터만 반환되었습니다. 페이지 안내에 따라 범위를 줄이고 반환량을 낮춘 후 다시 시도하며, 전체 결과로 간주하여 통계를 내지 않습니다
쿼리 실패 입력을 유지하고 마스킹된 오류에 따라 수정한 뒤 다시 시도합니다. 중단되었거나 완전히 종료되지 않은 반환은 성공 결과로 간주하지 않습니다

표시할 때는 서버에서 반환된 유형과 NULL의 의미를 유지하며, NULL을 자동으로 0으로 바꾸지 않고, 고정밀 값을 임의로 저정밀 숫자로 변환하지 않습니다.

차트를 선택할 때는 먼저 결과 구조를 확인해야 합니다. 상세 데이터는 먼저 표로 확인할 수 있고, 추세 차트에는 식별 가능한 시간과 값이 필요하며, 그룹화 통계 결과는 실제 차원과 값에 맞게 표시를 구성합니다. 선택 가능한 차트 범위는 현재 쿼리 진입점을 기준으로 합니다.

자주 묻는 질문

인스턴스를 찾을 수 없거나 쿼리할 수 없으면 어떻게 해야 하나요?

현재 워크스페이스, 설정 적용 상태 및 쿼리 권한을 확인합니다.

인스턴스가 일치하지 않는다는 메시지가 표시되면 어떻게 해야 하나요?

DQL Like 표현식의 datasource와 source를 확인하여 각각 페이지에서 선택한 인스턴스 ID, 데이터 소스 유형과 일치하는지 확인합니다. 데이터 소스를 전환한 후에는 표현식의 해당 값도 함께 수정해야 합니다.

테이블, 인덱스 또는 컬렉션이 보이지 않는 이유는 무엇인가요?

인스턴스 구성 범위와 데이터 소스 계정 권한을 확인합니다. 소스를 조회하는 쿼리도 이러한 제한을 받습니다.

쿼리에서 반환된 문서에 특정 필드가 없으면 어떻게 해야 하나요?

샘플 문서에 해당 필드가 포함되어 있는지 확인하고, 필요한 경우 제한된 수의 샘플을 추가로 읽습니다.

쿼리가 너무 느리거나 결과가 제한되면 어떻게 해야 하나요?

쿼리 범위를 줄이고 필터 조건을 추가하며, SQL LIMIT, Elasticsearch size 또는 MongoDB limit를 사용하여 반환량을 제어합니다.

문서 평가

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