다음을 통해 공유

render 연산자

  • 아티클

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

사용자 에이전트가 쿼리 결과의 시각화를 렌더링하도록 지시합니다.

렌더링 연산자는 쿼리의 마지막 연산자여야 하며 단일 테이블 형식 데이터 스트림 결과를 생성하는 쿼리에서만 사용할 수 있습니다. 렌더링 연산자는 데이터를 수정하지 않습니다. 결과의 확장 속성에 주석("시각화")을 삽입합니다. 주석에는 쿼리에서 연산자가 제공한 정보가 포함됩니다. 시각화 정보의 해석은 사용자 에이전트에 의해 수행됩니다. Kusto.Explorer 또는 Azure Data Explorer 웹 UI와 같은 다른 에이전트는 다양한 시각화를 지원할 수 있습니다.

렌더링 연산자의 데이터 모델은 다음과 같은 세 종류의 열이 있는 것처럼 테이블 형식 데이터를 확인합니다.

  • x 축 열(속성으로 xcolumn 표시됨)입니다.
  • 계열 열(속성으로 표시된 series 열 수)입니다. 각 레코드에 대해 이러한 열의 결합된 값은 단일 계열을 정의하고 차트에는 고유한 결합 값이 있는 만큼 계열이 있습니다.
  • y축 열(속성으로 표시된 ycolumns 열 수)입니다. 각 레코드에 대해 계열에는 y축 열만큼 많은 측정값(차트의 "점")이 있습니다.

팁

  • summarize top 를 사용하여 where표시하는 볼륨을 제한합니다.
  • 데이터를 정렬하여 x축의 순서를 정의합니다.
  • 사용자 에이전트는 쿼리에서 지정되지 않은 속성의 값을 자유롭게 "추측"합니다. 특히 결과 스키마에 "관심이 없는" 열이 있으면 잘못된 추측으로 변환될 수 있습니다. 그런 경우 이러한 열을 프로젝팅해 봅니다.

참고 항목

Azure Data Explorer 대시보드에서만 사용할 수 있는 몇 가지 시각화가 있습니다. 자세한 내용은 대시보드별 시각적 개체를 참조 하세요.

구문

T | render 시각화 [ (with propertyName = propertyValue [, ...]])

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름 Type 필수 설명
T string ✔️ 입력 테이블 이름입니다.
시각화 string ✔️ 사용할 시각화 종류를 나타냅니다. 다음 목록에서 지원되는 값 중 하나여야 합니다.
propertyName, propertyValue string 키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.

시각화

시각화 설명 그림
anomalychart 시간 차트와 비슷하지만 series_decompose_anomalies 함수를 사용하여 변칙을 강조 표시합니다.
areachart 영역형 그래프입니다.
barchart 가로 줄무늬로 표시됩니다.
card 첫 번째 결과 레코드는 스칼라 값 집합으로 처리되고 카드로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
ladderchart 마지막 두 열은 x축이고 다른 열은 y축입니다.
linechart 선 그래프입니다.
piechart 첫 번째 열은 색 축이고 두 번째 열은 숫자입니다.
pivotchart 피벗 테이블과 차트를 표시합니다. 사용자는 데이터, 열, 행 및 다양한 차트 유형을 대화형으로 선택할 수 있습니다.
scatterchart 포인트 그래프입니다.
stackedareachart 누적 영역 그래프입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 datetime이어야 합니다. 다른(숫자) 열은 y축입니다.
timepivot 이벤트 타임라인에 대한 대화형 탐색입니다(시간 축에서 피벗).
treemap 계층적 데이터를 중첩된 사각형 집합으로 표시합니다.

참고 항목

사다리 차트, 피벗 차트, timepivot 및 트리맵 시각화는 Kusto.Explorer에서 사용할 수 있지만 Azure Data Explorer 웹 UI에서는 사용할 수 없습니다.

시각화 설명 그림
areachart 영역형 그래프입니다. 첫 번째 열은 x축이며 숫자 열이어야 합니다. 다른 숫자 열은 y축입니다.
barchart 첫 번째 열은 x축이며 텍스트, 날짜/시간 또는 숫자일 수 있습니다. 다른 열은 숫자이며 가로 줄무늬로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
piechart 첫 번째 열은 색 축이고 두 번째 열은 숫자입니다.
scatterchart 포인트 그래프입니다. 첫 번째 열은 x축이며 숫자 열이어야 합니다. 다른 숫자 열은 y축입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 datetime이어야 합니다. 다른(숫자) 열은 y축입니다. 숫자 열을 "그룹화"하고 차트에 다른 줄을 만드는 데 값이 사용되는 문자열 열이 하나 있습니다(추가 문자열 열은 무시됨).
시각화 설명 그림
anomalychart 시간 차트와 비슷하지만 series_decompose_anomalies 함수를 사용하여 변칙을 강조 표시합니다.
areachart 영역형 그래프입니다.
barchart 가로 줄무늬로 표시됩니다.
card 첫 번째 결과 레코드는 스칼라 값 집합으로 처리되고 카드로 표시됩니다.
columnchart 가로 스트립 대신 세로 스트립이 있는 barchart와 같습니다.
linechart 선 그래프입니다.
piechart 첫 번째 열은 색 축이고 두 번째 열은 숫자입니다.
scatterchart 포인트 그래프입니다.
stackedareachart 누적 영역 그래프입니다.
table 기본값 - 결과가 테이블로 표시됩니다.
timechart 선 그래프입니다. 첫 번째 열은 x축이며 datetime이어야 합니다. 다른(숫자) 열은 y축입니다.

지원되는 속성

PropertyName/PropertyValue 는 렌더링할 때 사용할 추가 정보를 나타냅니다. 모든 속성은 선택 사항입니다. 지원되는 속성은 다음과 같습니다.

PropertyName PropertyValue
accumulate 각 측정값의 값이 모든 선행 문서에 추가되는지 여부입니다. (true 또는 false)
kind 시각화 종류의 추가 경과입니다. 자세한 내용은 속성을 참조 kind 하세요.
legend 범례 표시 여부(visible 또는 hidden)입니다.
series 레코드가 속한 계열을 정의하는 결합된 레코드당 값이 있는 열의 쉼표로 구분된 목록입니다.
ymin Y축에 표시할 최소값입니다.
ymax Y축에 표시할 최대값입니다.
title 시각화의 제목(형식 string)입니다.
xaxis x축의 크기를 조정하는 방법입니다(linear 또는 log).
xcolumn x축에 사용되는 결과의 열입니다.
xtitle x축의 제목입니다(string 형식).
yaxis y축의 크기를 조정하는 방법입니다(linear 또는 log).
ycolumns x 열 값당 제공된 값으로 구성된 쉼표로 구분된 열 목록입니다.
ysplit 여러 시각화를 분할하는 방법입니다. 자세한 내용은 속성을 참조 y-split 하세요.
ytitle y축의 제목입니다(string 형식).
anomalycolumns 에만 관련된 속성입니다 anomalychart. 쉼표로 구분된 열 목록- 변칙 계열로 간주되고 차트에 포인트로 표시됩니다.
PropertyName PropertyValue
kind 시각화 종류의 추가 경과입니다. 자세한 내용은 속성을 참조 kind 하세요.
series 레코드가 속한 계열을 정의하는 결합된 레코드당 값이 있는 열의 쉼표로 구분된 목록입니다.
title 시각화의 제목(형식 string)입니다.

kind 속성

이 시각화는 속성을 제공하여 kind 더욱 정교해질 수 있습니다. 이 속성의 지원되는 값은 다음과 같습니다.

시각화 kind 설명
areachart default 각 "영역"은 자체적으로 서 있습니다.
unstacked default와 동일합니다.
stacked "영역"을 오른쪽으로 쌓습니다.
stacked100 오른쪽에 "영역"을 쌓고 각각을 다른 영역과 동일한 너비로 늘입니다.
barchart default 각 "가로 막대" 자체를 나타냅니다.
unstacked default와 동일합니다.
stacked 스택 "막대".
stacked100 "가로 막대"를 쌓고, 각 가로 막대를 다른 가로 막대와 같은 너비로 늘립니다.
columnchart default 각 "열"은 자체적으로 표시됩니다.
unstacked default와 동일합니다.
stacked "세로 막대"를 켜켜이 쌓습니다.
stacked100 "열"을 쌓고 각각을 다른 열과 동일한 높이로 늘입니다.
scatterchart map 예상 열은 [경도, 위도] 또는 GeoJSON 지점입니다. 계열 열은 선택 사항입니다. 자세한 내용은 지리 공간적 시각화를 참조 하세요.
piechart map 예상 열은 [경도, 위도] 또는 GeoJSON 점, 색 축 및 숫자입니다. Kusto Explorer 데스크톱에서 지원됩니다. 자세한 내용은 지리 공간적 시각화를 참조 하세요.

ysplit 속성

일부 시각화는 여러 y축 값으로 분할을 지원합니다.

ysplit 설명
none 모든 계열 데이터에 대해 단일 y축이 표시됩니다. (기본값)
axes 단일 차트가 여러 y축으로 표시됩니다(계열당 하나씩).
panels 각 ycolumn 값에 대해 하나의 차트가 렌더링됩니다(특정 제한까지).

연속 데이터를 렌더링하는 방법

값 시퀀스(예 linechart: , timechart및 areachart)를 렌더링하는 데 여러 시각화가 사용됩니다. 이러한 시각화에는 다음과 같은 개념적 모델이 있습니다.

  • 테이블의 한 열은 데이터의 x축을 나타냅니다. 이 열은 속성을 사용하여 xcolumn 명시적으로 정의할 수 있습니다. 정의되지 않은 경우 사용자 에이전트는 시각화에 적합한 첫 번째 열을 선택합니다.
    • 예를 들어 시각화에서 timechart 사용자 에이전트는 첫 번째 datetime 열을 사용합니다.
    • 이 열이 형식 dynamic 이고 배열을 보유하는 경우 배열의 개별 값은 x축의 값으로 처리됩니다.
  • 테이블의 하나 이상의 열은 x축에 따라 달라지는 하나 이상의 측정값을 나타냅니다. 이러한 열은 속성을 사용하여 ycolumns 명시적으로 정의할 수 있습니다. 정의되지 않은 경우 사용자 에이전트는 시각화에 적합한 모든 열을 선택합니다.
    • 예를 들어 시각화에서 timechart 사용자 에이전트는 달리 지정되지 않은 숫자 값이 있는 모든 열을 사용합니다.
    • x축이 배열인 경우 각 y축의 값은 길이가 비슷한 배열이어야 하며 각 y축은 단일 열에서 발생합니다.
  • 테이블의 열이 0개 이상인 경우 측정값을 그룹화할 수 있는 고유한 차원 집합을 나타냅니다. 이러한 열은 속성에 의해 series 지정될 수 있습니다. 그렇지 않으면 지정되지 않은 열에서 사용자 에이전트가 자동으로 선택합니다.

참고 항목

렌더링 연산자의 데이터 모델은 다음과 같은 세 종류의 열이 있는 것처럼 테이블 형식 데이터를 확인합니다.

  • x 축 열(속성으로 xcolumn 표시됨)입니다.
  • 계열 열(속성으로 표시된 series 열 수)입니다.
  • y축 열(속성으로 표시된 ycolumns 열 수)입니다. 각 레코드에 대해 계열에는 y축 열만큼 많은 측정값(차트의 "점")이 있습니다.

예제

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart