호스트 맵 위젯

원문 보기 위키 갱신 2026.10.05

호스트 맵(Host Map) 위젯은 호스트, 컨테이너, 파드 또는 클러스터의 색상 코드 그리드로 인프라를 표시해요. 이상 징후를 발견하고, 리소스 분포를 이해하며, 인프라 상태를 한눈에 모니터링하는 데 사용해요. 전체 화면 버전은 Host Map 페이지를 참조해요.

출처: 문서

본문

호스트 맵 위젯은 호스트, 컨테이너, 파드 또는 클러스터의 색상 코드 그리드로 인프라를 표시해요. 이상 징후를 발견하고, 리소스 분포를 이해하며, 인프라 상태를 한눈에 모니터링하는 데 사용해요. 전체 화면 버전은 Host Map 페이지를 참조해요.

Query Type을 사용해 위젯이 데이터를 가져오는 방식을 선택해요. Infrastructure(기본값)는 인프라 엔티티를 직접 쿼리하고, DDSQL은 게시된 데이터셋을 쿼리해요.

Node type: 표시할 엔티티 유형을 선택해요: Host, Container, Pod, Cluster. Fill by: 각 노드의 색상을 결정하는 메트릭 쿼리를 구성해요. 쿼리는 노드별로 평가되어 선택한 색상 팔레트에 매핑돼요. Filter by: env:prod 같은 태그 필터 식으로 노드 집합을 좁혀요. 필터 식은 와일드카드와 논리 연산자를 지원해요. 비워 두면 선택한 유형의 모든 노드를 포함해요. Group by: 하나 이상의 태그로 노드를 육각형 그룹으로 집계해요. 태그 값을 공유하는 노드는 같은 그룹에 함께 나타나요. Size by(선택): 각 노드의 상대적 크기를 조정하는 두 번째 메트릭 쿼리를 구성해요. 계층적 하위 레이어가 구성되면 사용할 수 없어요. Style: - 팔레트: 색상 팔레트를 선택해요. - 팔레트 반전: 팔레트의 방향을 뒤집어요. - Min / Max: 색상 스케일을 특정 메트릭 값에 고정해요. 최솟값 아래 노드는 첫 번째 팔레트 색상으로, 최댓값 위 노드는 마지막 색상으로 표시돼요. Visual Formatting Rules(선택): 채우기 값이 정의된 임계값을 넘는 노드에 색상 오버라이드를 적용해요. Hierarchical view(선택): 그룹으로 확대할 때 나타나는 하위 노드 유형을 구성해요(예: Host 안의 Container). 하위 레이어는 자체 Fill by 쿼리와 Style 설정을 가져요.

DDSQL 모드는 인프라 엔티티를 직접 쿼리하는 대신 게시된 데이터셋의 열을 호스트 맵 시각화에 매핑해요. 인프라 엔티티로 기본 모델링되지 않은 데이터를 시각화하는 데 사용해요. 예로는 비용 할당 분해 또는 여러 소스를 조인해 정의한 사용자 지정 토폴로지가 있어요.

Query Type을 DDSQL로 선택해요.
DDSQL Editor에서 게시한 데이터셋을 선택해요. 행을 필터링하는 검색 쿼리를 추가하고, Display first로 사전 설정 목록에서 가져올 최대 행 수를 선택하거나 사용자 지정 값을 입력해요. 매핑 전에 데이터셋의 열과 행을 검사하려면 Preview Data를 클릭해요.
Configure Points에서 데이터셋 열을 시각화 차원에 매핑해요:
- Label node by: 각 포인트를 고유하게 식별하고 라벨을 지정하는 열.
- Fill by: 각 포인트의 색상을 결정하는 숫자 열.
- Size by(선택): 각 포인트의 상대적 크기를 조정하는 숫자 열.
- Group by(선택): 포인트를 중첩 그룹으로 묶는 최대 3개의 열. 선택한 열의 순서가 중첩 계층을 설정해요. 첫 번째 열이 가장 바깥쪽 그룹을 형성해요.
Style과 Visual Formatting Rules는 인프라 모드와 동일하게 작동해요.

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

이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의를 참조하세요. type은 hostmap이며, requests 배열에 노드 유형, 채우기/크기/그룹 메트릭 쿼리, 노드 필터, 스타일 설정이 포함돼요.

주요 직영 필드는 다음과 같아요:

필드	타입	설명
`node_type` [필수]	enum	표시할 엔티티 유형. 허용되는 enum 값: `host,container,pod,cluster`
`requests` [필수]	object[]	호스트 맵 요청. `fill`, `size`, `group`, `no_metric_hosts`, `no_group_hosts` 구성 포함.
`title`	string	위젯의 제목.
`type` [필수]	enum	호스트 맵 위젯의 유형. 허용되는 enum 값: `hostmap`, 기본값: `hostmap`