트리맵 위젯

원문 보기 위키 갱신 2026.10.05

출처: 문서

본문

트리맵(treemap) 위젯을 사용하면 하나 이상의 데이터셋의 비율을 표시할 수 있어요. 이 위젯은 대응하는 비율이 있는 단일 데이터셋, 또는 중첩된 비율을 가진 여러 데이터셋을 표시할 수 있어요.

구성 (Configuration)

사용 가능한 데이터 소스에서 선택해요.
쿼리를 구성해요. 자세한 내용은 다음 리소스를 참고하세요.
- 메트릭: 메트릭 쿼리를 구성하려면 쿼리 문서를 참고하세요.
- 이벤트: 로그 이벤트 쿼리를 구성하려면 로그 검색 문서를 참고하세요.
(선택) 공식(formula)으로 쿼리를 수정해요.
그래프를 사용자화해요.

사용자화 (Customization)

컨텍스트 링크 (Context links)

컨텍스트 링크는 기본적으로 활성화되어 있으며 켜고 끌 수 있어요. 컨텍스트 링크는 대시보드 위젯을 다른 페이지(Datadog 내부 또는 타사)와 연결해줘요.

표시 및 상호작용 (Display and interaction)

필터 및 포커스 (Filter and focus)

한 번에 여러 데이터 그룹이 플롯되는 경우 위젯을 단일 카테고리로 필터링해서 그 안의 비율을 볼 수 있어요.

단일 카테고리로 필터링하고 포커스하려면 카테고리의 바깥쪽 부분에 마우스를 올리고 클릭해요. 이전 뷰로 돌아가려면 위젯 왼쪽 위 헤더의 뒤로(back) 버튼을 클릭해요.

컨텍스트 메뉴에 접근하려면 먼저 개별 카테고리에 마우스를 올려요. 이는 중첩 카테고리 또는 그룹일 수 있어요. 예를 들어 다음 예시의 Canada 또는 Canada > Edge 같은 경우예요. 그러면 오른쪽 위 모서리에 드롭다운 버튼이 나타나요. 클릭하면 컨텍스트 메뉴가 표시돼요.

전체 화면 (Full-screen)

트리맵 위젯을 전체 화면으로 보면 표준 전체 화면 옵션 세트가 표시돼요.

트리맵 위젯처럼 파이 차트 위젯도 중첩 비율을 표시하는 데 사용할 수 있어요. 둘의 주요 차이점은 파이 차트는 방사형 조각으로 비율을 표시하고 트리맵은 중첩된 사각형으로 표시한다는 점이에요.

API

이 위젯은 **대시보드 API**와 함께 사용할 수 있어요. 위젯 JSON 스키마 정의에 대해서는 다음 표를 참고하세요.

트리맵 위젯의 최상위 필드는 다음과 같아요.

필드	타입	설명
color_by	enum	DEPRECATED (더 이상 사용되지 않음): 이전에 위젯에서 색상을 결정하는 데 사용된 속성. 허용 enum 값: `user` 기본값: `user`
custom_links	object[]	사용자 지정 링크 목록.
is_hidden	boolean	컨텍스트 메뉴 링크 표시 여부를 전환하는 플래그.
label	string	사용자 지정 링크 URL의 라벨. 라벨을 짧고 명확하게 유지하세요. 메트릭과 태그를 변수로 사용하세요.
link	string	사용자 지정 링크의 URL. URL은 `http` 또는 `https`를 포함해야 해요. 상대 URL은 `/`로 시작해야 해요.
override_label	string	컨텍스트 메뉴 링크를 나타내는 라벨 ID. `logs`, `hosts`, `traces`, `profiles`, `processes`, `containers`, `rum` 중 하나가 될 수 있어요.
description	string	위젯의 설명.
group_by	enum	DEPRECATED (더 이상 사용되지 않음): 이전에 위젯에서 요소를 그룹화하는 데 사용된 속성. 허용 enum 값: `user,family,process`
requests [필수]	object[]	트리맵 위젯 요청 목록.
size_by	enum	DEPRECATED (더 이상 사용되지 않음): 이전에 위젯에서 크기를 결정하는 데 사용된 속성. 허용 enum 값: `pct_cpu,pct_mem`
time	object	위젯의 시간 설정.
title	string	위젯 제목.
type [필수]	enum	트리맵 위젯 유형. 허용 enum 값: `treemap` 기본값: `treemap`

각 requests는 formulas, queries, q, response_format, sort, style 필드를 포함해요. formulas 항목은 alias, cell_display_mode(number,bar,trend), cell_display_mode_options, conditional_formats, formula, limit(count, order), number_format, style(색상 팔레트)를 포함해요. queries는 metrics, 이벤트 플랫폼(logs,spans,network,rum,security_signals,profiles,audit,events,ci_tests,ci_pipelines,incident_analytics,product_analytics,on_call_events,errors,llm_observability), process, apm_dependency_stats, apm_resource_stats, apm_metrics, slo, cloud_cost, product_analytics_extended, product_analytics_journey, product_analytics_retention 같은 데이터 소스를 지원해요.

time 객체는 라이브 스팬(live span) 래퍼이며 live_span(허용 enum: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert)과 hide_incomplete_cost_data 필드를 가져요.

예시:

{
  "color_by": "user",
  "custom_links": [
    {
      "is_hidden": false,
      "label": "Search logs for {{host}}",
      "link": "https://app.datadoghq.com/logs?query={{host}}",
      "override_label": "logs"
    }
  ],
  "description": "string",
  "group_by": "user",
  "requests": [
    {
      "formulas": [
        {
          "alias": "string",
          "cell_display_mode": "number",
          "cell_display_mode_options": {
            "trend_type": "area",
            "y_scale": "shared"
          },
          "conditional_formats": [
            {
              "comparator": ">",
              "custom_bg_color": "string",
              "custom_fg_color": "string",
              "hide_value": false,
              "image_url": "string",
              "metric": "string",
              "palette": "blue",
              "timeframe": "string",
              "value": 0
            }
          ],
          "formula": "func(a) + b",
          "limit": {
            "count": "integer",
            "order": "asc"
          },
          "number_format": {
            "unit": {
              "per_unit_name": "bytes",
              "type": "canonical_unit",
              "unit_name": "bytes"
            },
            "unit_scale": {
              "type": "canonical_unit",
              "unit_name": "bytes"
            }
          },
          "style": {
            "palette": "classic",
            "palette_index": 1
          }
        }
      ],
      "q": "string",
      "queries": [],
      "response_format": "timeseries",
      "sort": {
        "count": "integer",
        "order_by": [
          {
            "index": 0,
            "order": "desc",
            "type": "formula"
          }
        ]
      },
      "style": {
        "line_type": "string",
        "line_width": "string",
        "order_by": "string",
        "palette": "string"
      }
    }
  ],
  "size_by": "pct_cpu",
  "time": {
    "hide_incomplete_cost_data": false,
    "live_span": "5m"
  },
  "title": "string",
  "type": "treemap"
}

트리맵 위젯