변수 조회¶

뷰 변수 조회는 변수의 값 범위와 데이터 소스를 정의하는 데 사용되며, 값 범위가 대시보드 시간 위젯에 연동될지 여부를 구성하여 다양한 데이터 필터링 요구 사항을 충족할 수 있습니다.

값 범위 제어¶

조회를 통해 얻은 선택 가능한 값이 대시보드 시간 범위의 영향을 받을지 여부를 선택할 수 있습니다.

주요 조회 방식¶

뷰 변수는 현재 다섯 가지 조회 방식을 지원하며, 필요에 따라 선택할 수 있습니다.

DQL 조회¶

메트릭, 로그, 인프라스트럭처, 객체, 분산 추적, RUM 등 모든 데이터 유형을 지원하며 가장 포괄적인 기능을 제공합니다.

DQL 정의 및 구문에 대한 자세한 내용은 여기를 클릭하세요.

기본 구문 구조¶

데이터 유형::데이터 소스:(distinct('속성 필드 이름')){필터 조건}

예시:

# 모든 Docker 컨테이너의 호스트 이름 가져오기
O::docker_containers:(distinct(`host`))

시간 범위 지정¶

DQL은 구문 내에서 직접 시간 범위를 지정할 수 있으며, 대시보드 시간 위젯보다 우선 순위가 높습니다.

예시:

# 최근 10분 동안 데이터가 있는 호스트만 표시
O::docker_containers:(distinct(`host`)) [10m]

Show 함수 조회¶

메트릭 관련 메타데이터 정보를 조회하는 데 적합하며, 시간 범위를 지원하지 않습니다.

구문 구조¶

DQL 함수에 대한 자세한 내용은 여기를 클릭하세요.

예시:

# 모든 메저먼트 조회
SHOW METRIC_SET()

# 지정된 메저먼트의 모든 태그 조회
SHOW LABELS FROM M::cpu

PromQL 조회¶

PromQL 조회는 직접 조회문을 작성할 수 있으며, 기본적으로 대시보드 시간 위젯에서 선택한 시간을 사용하여 데이터를 조회하고 반환합니다.

PromQL 조회 관련 정보는 PromQL 빠른 시작을 참조하세요.

데이터 유형 조회¶

빠르게 구성이 필요하고 조회문을 작성하고 싶지 않은 경우, 데이터 유형을 직접 선택하고 페이지에서 필터 조건을 선택하면 됩니다.

지원되는 데이터 유형:

• 메트릭
• 기본 객체 (호스트, 컨테이너, 프로세스 등)
• 통합 카탈로그
• 로그
• APM
• RUM

이 모드에서는 시간 범위를 추가하거나 캐스케이드 조회를 구성할 수 없습니다.

외부 데이터베이스¶

조회하려는 선택 가능한 값이 외부 데이터베이스(예: MySQL, PostgreSQL)에 저장되어 있는 경우, 이 조회 방식을 선택하여 기존 데이터 시스템에 직접 연결할 수 있습니다.

1. 데이터 소스 선택;
2. 조회문 입력;
3. 정렬 방식 선택.

자세한 내용은 외부 데이터 소스를 참조하세요.

외부 함수¶

조회하려는 선택 가능한 값을 사용자 정의 함수 로직을 통해 가져와야 하는 경우, 이 조회 방식을 선택하여 워크스페이스에 등록된 외부 함수를 호출하고 후보 값 목록을 동적으로 생성할 수 있습니다.

1. 함수 선택: 현재 워크스페이스에 등록된 외부 함수 중에서 선택;
2. 필요에 따라 함수 입력 매개변수를 추가하고, 매개변수 이름과 해당 값을 입력합니다. 대시보드의 다른 뷰 변수를 참조할 수 있으며 형식은 #{변수 이름}입니다. 참조된 변수가 전환되면 시스템이 자동으로 함수를 다시 호출하고 후보 값을 새로 고칩니다.
3. 값 필드: 함수가 반환한 데이터에서 변수의 후보 값으로 사용할 필드를 지정합니다 (❗️이 필드는 필수 입력 항목이 아닙니다. 설정하지 않으면 시스템은 기본적으로 반환된 데이터의 첫 번째 필드를 사용합니다. 특정 필드 값을 반환해야 하는 경우 필드 이름을 직접 입력하세요).

이 조회 방식은 시간 범위 추가 및 캐스케이드 조회 구성을 지원하지 않습니다.

사용자 정의 조회¶

조회하려는 선택 가능한 값이 고정되어 있고 개수가 제한적이며 데이터베이스 조회가 필요하지 않은 경우, 뷰 변수에 사용할 값 집합을 직접 정의할 수 있습니다. 각 옵션은 영문 쉼표 ,로 구분합니다. 예: prod,test,dev,staging.

이 조회 방식은 시간 범위 추가 및 캐스케이드 조회 구성을 지원하지 않습니다.

캐스케이드 조회¶

여러 변수 간에 계층 관계가 있는 경우 사용합니다. 예:

• "서비스"를 선택하면 "환경" 드롭다운에 해당 서비스의 환경만 표시됩니다 (전체 환경이 아님).
• "환경"을 선택하면 "버전" 드롭다운에 해당 환경의 버전만 표시됩니다.

구성 조건¶

1. DQL 조회만 캐스케이드 구성을 지원합니다.
2. 하위 변수의 조회문에서 #{상위 변수 이름}을 사용하여 상위 변수의 현재 값을 참조합니다.

구성 예시¶

다음은 RUM의 Web 애플리케이션 개요에서 뷰 변수 캐스케이드 필터링을 예로 들어, 서비스, 환경 및 버전을 기반으로 한 연동 조회 구성 설명입니다.

대시보드에 세 개의 변수 조회문을 구성해야 합니다. 두 번째와 세 번째 조회문은 첫 번째 조회 구성의 #{변수 이름}을 사용합니다.

• 변수 1 (서비스): 모든 애플리케이션 목록 조회:

T::re(`.*`):(distinct(service))

• 변수 2 (환경): 모든 애플리케이션 목록을 조회하고, 변수 1에서 선택한 환경 목록:

T::re(`.*`):(distinct(env)) { service = '#{service}'}

• 변수 3 (버전): 모든 애플리케이션 목록을 조회하고, 변수 2에서 선택한 버전 목록:

T::re(`.*`):(distinct(version)) {service = '#{service}'}

조회 시나리오 예시¶

차트 연결¶

1. 차트 조회에서 필드 필터링 시, value 값에 해당 변수를 선택합니다.

2. 시나리오 뷰에서 변수 값을 전환하면 차트가 변수 태그에 따라 필터링되어 표시됩니다.

차트 역방향 추가¶

1. 차트에서 특정 시계열 또는 데이터 포인트를 클릭한 후;
2. 뷰 변수에 적용을 선택합니다.
3. 시스템이 자동으로 조회를 채웁니다.