차트 설정¶
차트에서 공통으로 사용하는 일반 설정과 고급 설정을 포함합니다.
일반 설정¶
제목¶
-
제목: 차트에 제목 이름을 설정하며, 설정이 완료되면 차트 왼쪽 상단에 표시되고 숨길 수 있습니다.
-
설명: 차트에 설명 정보를 추가하며, 설정하면 차트 제목 뒤에
i안내가 표시되고, 설정하지 않으면 표시되지 않습니다.
Guance에 탑재된 대규모 언어 모델의 자연어 생성 기능을 기반으로 "자동 생성" 기능을 사용하여 의미에 맞는 제목과 설명을 빠르게 생성할 수 있습니다.
단위¶
데이터 크기, 시간 간격, 타임스탬프 등 다양한 차원의 범용 단위 형식을 포함합니다.
드롭다운 상자에서 사용자 지정 단위를 입력할 수 있습니다.
현재 쿼리 조건에 포함된 메트릭을 선택하고 사용자 지정 단위를 입력합니다.
메트릭 데이터의 단위 표시에 대하여
-
기본 단위 표시:
-
쿼리한 데이터가 메트릭 데이터이고 메트릭 관리에서 해당 메트릭의 단위를 설정한 경우, 기본적으로 해당 메트릭의 단위에 따라 단위를 변환하여 표시합니다.
-
메트릭 관리에 관련 단위 설정이 없는 경우, 천 단위 쉼표로 구분된 숫자 형식으로 표시합니다.
-
-
단위 설정 후: 사용자 지정 설정한 단위를 우선 적용하여 표시합니다. 메트릭 데이터는 숫자 값에 대해 두 가지 옵션을 제공합니다.
-
기본 단위 변환: 단위는 만, 백만이며, 예를 들어 10,000은 1만, 1,000,000은 100만으로 표시됩니다. 소수점 두 자리까지 유지합니다.
-
단축 단위 체계: 단위는 K, M, B입니다. 즉, thousand, million, billion, trillion 등으로 중국어권 문맥의 천, 백만, 십억, 조 등에 해당하는 단위를 순서대로 나타냅니다. 예를 들어 1,000은 1 k, 10,000은 10 k, 1,000,000은 1 million입니다. 소수점 두 자리까지 유지합니다.
-
워크스페이스 통화 따르기¶
대시보드 차트를 직접 생성할 때 클라우드 청구서 금액을 환산해야 하는 경우, 먼저 쿼리에서 클라우드 청구서 데이터 소스를 선택한 다음 일반 설정 > 단위 > 통화에서 워크스페이스 통화 따르기를 선택하세요. 클라우드 청구서 페이지에서 내보낸 차트는 통화를 다시 설정할 필요가 없습니다.
금액은 워크스페이스의 클라우드 청구서 표시 통화 및 당일 환율에 따라 환산되며, 과거 청구서도 당일 환율을 사용하고 원본 청구서 데이터는 수정하지 않습니다.
전역 모드에서 현재 차트의 단위를 일괄 설정할 수 있으며, 사용자 지정 모드에서 금액 메트릭 또는 금액 열에 대해 개별 설정할 수도 있습니다. 차트에 금액과 수량 등 서로 다른 유형의 데이터가 동시에 포함된 경우 사용자 지정 모드를 사용하여 금액에만 이 단위를 선택하는 것이 좋습니다.
- 워크스페이스에서 특정 통화를 선택하면 차트가 해당 통화로 표시되며, 통화 변경 후 다음 쿼리 또는 차트 새로고침 시 적용됩니다.
- 워크스페이스에서 원본 통화를 선택하면 차트가 청구서의 원래 통화별로 각각 표시되며, 서로 다른 통화의 금액을 직접 합산하지 않습니다.
- 데이터에 원래 통화 정보나 환율이 없으면 페이지에 관련 비용을 환산할 수 없다는 안내가 표시되며, 현재 집계가 불완전할 수 있습니다.
별칭¶
시스템은 현재 차트 쿼리 아래의 모든 메트릭과 그룹을 자동으로 나열합니다. 별칭을 추가하면 차트의 그룹 부분이 별칭 값에 따라 동적으로 업데이트됩니다. 별칭은 템플릿 변수를 사용할 수 있어 클릭 한 번으로 대체할 수 있습니다. 예:
-
{{tags}}: 모든 "태그 이름"과 "태그 값"으로 대체됩니다. -
{{host}}:host의 "태그 값"으로 대체됩니다. -
{{__name__}}: 모든 메트릭 이름으로 대체됩니다.
주의
- 메트릭 부분의 별칭은 쿼리 문 오른쪽의
AS에 의해 결정됩니다.
-
쿼리에 by 조건이 있는 경우 반환된 모든 범례 시퀀스가 표시됩니다.
-
별칭에서 메트릭 부분과 그룹 부분을 동시에 설정하면 우선순위는 그룹 별칭 > 메트릭 별칭입니다.
시나리오 예시¶
아래 그림과 같이 호스트 CPU의 총 사용률(usage_total)과 사용자 모드 사용률(usage_user)을 각각 쿼리합니다. 전자를 기준으로 별칭을 설정하면 다음 시나리오가 나타납니다:
- 별칭을 추가하지 않은 경우:
- 순수 텍스트를 입력한 경우:
- by 조건을 기준으로 변수
{{tags}}를 입력한 경우:
범례¶
위치¶
숨김, 하단, 오른쪽 범례를 선택할 수 있으며, 범례의 메트릭 행을 클릭하면 해당 메트릭을 숨기거나 표시할 수 있습니다.
표시 값¶
범례에 표시할 값 또는 계산된 값을 선택합니다.
시계열 차트 범례 값은 차트 쿼리 결과에 따라 다시 집계 계산되며, Last(마지막 값), First(첫 번째 값), Avg(평균값), Min(최솟값), Max(최댓값), Sum(합계), Count(반환 포인트 수)를 선택할 수 있습니다.
아래 그림과 같이 First는 현재 시계열 차트 쿼리 결과의 첫 번째 값을 의미하고, Last는 현재 시계열 차트 쿼리 결과의 마지막 값입니다. 범례 값을 클릭하면 오름차순/내림차순 정렬할 수 있습니다.
주의
Avg, Sum, Count는 선택한 시간 간격(원본 간격 및 자동 정렬)에 따라 다른 결과를 표시합니다.
데이터 형식¶
-
소수 자릿수: 0, 1, 2, 3자리 소수 또는 전체 정밀도를 선택할 수 있습니다.
-
천 단위 구분 기호: 기본적으로 사용 설정되며, 끄면 구분 기호 없이 원래 값이 표시됩니다.
대시보드 차트 쿼리 결과는 자동으로 데이터에 천 단위 형식을 적용하여 표시할 수 있습니다. 단위를 설정한 경우 설정된 단위에 따라 데이터 형식이 표시됩니다.
설정을 완료하면 미리보기에서 천 단위 데이터 형식으로 표시할 수 있으며, 단위를 설정한 경우 단위 설정 형식에 따라 표시됩니다.
- 천 단위 데이터 형식으로 표시한 경우:
- 설정한 데이터 형식으로 표시한 경우:
고급 설정¶
시간 고정¶
즉, 현재 차트 쿼리 데이터의 시간 범위를 고정하여 전역 시간 위젯의 제한을 받지 않도록 합니다. 설정이 완료되면 차트 오른쪽 상단에 "xx분", "xx시간", "xx일"과 같이 사용자가 설정한 시간이 표시됩니다. 시간 고정 간격이 30분이라고 가정하면, 오른쪽 상단의 시간 위젯을 조정하더라도 현재 차트는 계속 최근 30분 데이터만 표시합니다.
규칙 매핑¶
서로 다른 열에 대해 메트릭 범위와 해당 배경색, 글꼴 색상을 설정합니다. 범위 내의 메트릭은 설정된 스타일로 표시됩니다.
메트릭 범위와 매핑 값을 설정하면, 메트릭 값이 설정된 데이터 범위 내에 있을 때 해당 매핑 값으로 표시됩니다.
메트릭 값이 여러 설정을 동시에 충족하는 경우 마지막으로 조건을 충족한 설정 스타일로 표시됩니다.
값 매핑을 설정할 때 "표시 값"과 "색상"은 모두 필수 항목이 아닙니다:
-
표시 값: 기본값은 비어 있으며, 매핑 값을 표시하지 않음을 의미합니다.
-
색상: 기본값은 비어 있으며, 색상 매핑을 하지 않고 원래 색상으로 표시합니다.
필드 매핑¶
실제 비즈니스 시나리오에서 쿼리할 필드와 프런트엔드에 표시되는 필드가 일치하지 않는 경우 차트의 필드 매핑을 활성화할 수 있습니다. 뷰 변수의 객체 매핑 기능과 함께 사용하며, 기본값은 비활성화입니다.
필드 매핑을 활성화하면 차트에 쿼리된 그룹 필드와 해당 매핑 필드가 표시되며, 매핑이 지정되지 않은 그룹 필드는 표시되지 않습니다.
워크스페이스 권한 부여¶
활성화하면 현재 워크스페이스의 현재 차트에서 외부 워크스페이스의 데이터를 쿼리할 수 있습니다.
차트 아래에서 권한이 부여된 워크스페이스 드롭다운에서 대상 워크스페이스를 선택하여 쿼리할 수 있습니다.
데이터 샘플링¶
Doris 로그 데이터 엔진을 사용하는 워크스페이스에만 적용됩니다.
활성화하면 "메트릭"을 제외한 다른 데이터에 대해 샘플링 쿼리를 수행하며, 샘플링 비율은 고정되지 않고 데이터 양에 따라 동적으로 조정됩니다.
자세한 내용은 데이터 샘플링 기능 기술 가이드를 참고하세요.
시간 오프셋¶
비시계열 데이터는 저장 후 최소 1분의 쿼리 지연이 있습니다. 상대 시간 쿼리를 선택하면 최근 몇 분의 데이터가 수집되지 않아 데이터가 누락될 수 있습니다.
시간 오프셋을 활성화하면 상대 시간 범위를 쿼리할 때 실제 쿼리 시간 범위가 1분 이전으로 이동하여, 저장 지연으로 인해 데이터 조회 결과가 비어 있는 것을 방지합니다. 예: 현재 시간이 12:30이고 최근 15분 데이터를 쿼리하는 경우, 시간 오프셋을 활성화하면 실제 쿼리 시간은 12:14-12:29입니다.
주의
- 이 설정은 상대 시간에만 적용되며, 쿼리 시간 범위가 "절대 시간 범위"인 경우 시간 오프셋이 적용되지 않습니다.
- 시간 간격이 있는 차트(예: 시계열 차트)의 경우 설정된 시간 간격이 1min을 초과하면 시간 오프셋이 적용되지 않으며, 1m 이하인 경우에만 오프셋이 적용됩니다. 시간 간격이 없는 차트(예: 개요 차트, 막대 차트 등)의 경우 시간 오프셋이 계속 적용됩니다.
샘플링 사전 점검¶
활성화하면 시스템이 먼저 "샘플링 사전 점검" 기능을 시작하여 필터링 후의 데이터 양을 자동으로 추정합니다. 데이터 양이 미리 설정된 샘플링 임계값 하한에 도달하거나 이를 초과하면, 시스템이 임계값과 목표 데이터 양의 비율에 따라 샘플링 프로세스를 자동으로 트리거하고 실행합니다. 데이터 양이 해당 하한보다 낮으면 샘플링을 수행하지 않고 모든 데이터를 유지합니다.








