모니터 요약 위젯

원문 보기 위키 갱신 2026.10.05

모니터 요약(Monitor Summary) 위젯은 모든 Datadog 모니터 또는 쿼리를 기반으로 한 부분집합의 요약 보기를 표시해요.

출처: 문서

본문

개요

모니터 요약 위젯은 모든 Datadog 모니터 또는 쿼리를 기반으로 한 부분집합의 요약 보기를 표시해요.

설정

구성

세 가지 요약 유형 중 하나를 선택해요: Monitor, Group, Combined
- Monitor 요약 유형은 모니터 쿼리와 일치하는 모니터의 상태와 이름을 나열해요. 멀티 알림 모니터는 결과 목록에 행이 하나만 있으며, 그 상태는 멀티 알림 모니터의 전체 상태예요. Status Counts는 각 상태 유형과 일치하는 모니터의 수예요.
- Group 요약 유형은 모니터 쿼리와 일치하는 모니터의 상태, 이름, 그룹을 나열해요. 멀티 알림 모니터는 결과 목록에서 여러 행으로 나뉘며, 각 그룹과 해당 그룹의 멀티 알림 모니터 내 특정 상태에 대응해요. Group 요약 유형은 Triggered Monitors 페이지와 유사하게 모니터 쿼리에서 group 및 group_status 파셋도 지원해요. Status Counts는 각 상태 유형과 일치하는 모니터 그룹의 수예요.
- Combined 요약 유형은 모니터 쿼리와 일치하는 모니터의 그룹 상태 수와 이름을 나열해요. 멀티 알림 모니터는 Monitor 요약 유형처럼 결과 목록에 행이 하나만 있지만, 그룹 열에는 모니터의 전체 상태 대신 각 상태 유형의 그룹 수가 표시돼요. Group 요약 유형과 유사하게 Combined 요약 유형도 모니터 쿼리에서 group과 group_status 파셋을 지원해요. Status Counts는 여전히 Monitor 요약 유형처럼 전체 모니터 상태의 수를 표시해요.
모니터 부분집합 위에 모니터 요약 위젯을 표시하려면 모니터 쿼리를 입력해요.

참고 위 링크에 나열된 파셋 외에도 Group 및 Combined 요약 유형은 Triggered Monitors 페이지와 유사하게 그룹 수준 검색을 위해 group 및 group_status 파셋도 지원해요.

템플릿 변수

모니터 요약 검색 쿼리에 대시보드에서 만든 템플릿 변수를 사용하려면 Manage Monitor 페이지와 동일한 쿼리 형식을 따라요.

예시

$service 템플릿 변수로 모니터 scope를 필터링.

manage 또는 triggered 모니터 페이지에서 scope를 활용하려면 scope:service:web-store를 입력해야 해요. 따라서 위젯에서 템플릿 변수 값을 위젯에 적용하려면 scope:$service를 입력해야 해요.

$env 템플릿 변수로 모니터 group을 필터링.

manage 또는 triggered 모니터 페이지에서 group을 활용하려면 group:env:prod를 입력해야 해요. 따라서 위젯에서 템플릿 변수 값을 위젯에 적용하려면 group:$env를 입력해야 해요.

옵션

표시 기본 설정

모니터 상태 유형별로 모니터의 Count만 표시할지, List를 표시할지, 아니면 Both를 표시할지 선택해요. Text와 Background 옵션은 상태 색상을 Status Counts의 텍스트 또는 배경에 적용할지 지정해요. Hide empty Status Counts 옵션을 활성화하면 결과 목록에서 0보다 많은 모니터가 있는 상태에 대해서만 Status Counts를 표시해요.

Show triggered column 옵션을 선택하면 결과를 트리거 상태(Alert, Warn, No Data)인 모니터 또는 모니터 그룹으로 필터링하고, 가장 최근에 트리거된 것부터 가장 오래된 것 순으로 정렬해요. 모니터/그룹이 마지막으로 트리거된 이후 경과된 시간을 나타내는 추가 열이 추가돼요.

API

이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의는 다음 표를 참조해요:

필드	타입	설명
`color_preference`	enum	위젯에서 사용할 색상. 허용되는 enum 값: `background,text`
`count`	int64	DEPRECATED: 표시할 모니터 수.
`description`	string	위젯의 설명.
`display_format`	enum	위젯에 표시할 내용. 허용되는 enum 값: `counts,countsAndList,list`
`hide_zero_counts`	boolean	0의 개수를 표시할지 여부.
`query` [필수]	string	모니터를 필터링하는 쿼리.
`show_last_triggered`	boolean	모니터/그룹이 트리거된 이후 경과된 시간을 표시할지 여부.
`show_priority`	boolean	우선순위 열을 표시할지 여부.
`sort`	enum	위젯 정렬 방법. 허용되는 enum 값: `name,group,status,tags,triggered,priority` 및 asc/desc 조합.
`start`	int64	DEPRECATED: 목록의 시작. 보통 0.
`summary_type`	enum	사용할 요약 유형. 허용되는 enum 값: `monitors,groups,combined`
`title`	string	위젯의 제목.
`title_align`	enum	위젯에서 텍스트를 정렬하는 방법. 허용되는 enum 값: `center,left,right`
`title_size`	string	제목의 크기.
`type` [필수]	enum	모니터 요약 위젯의 유형. 허용되는 enum 값: `manage_status`, 기본값: `manage_status`

JSON 예시:

{
  "color_preference": "string",
  "count": "integer",
  "description": "string",
  "display_format": "string",
  "hide_zero_counts": false,
  "query": "",
  "show_last_triggered": false,
  "show_priority": false,
  "sort": "name,asc",
  "start": "integer",
  "summary_type": "string",
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "manage_status"
}

더 알아보기 (Learn more)

Building Dashboards using JSON

모니터 요약 위젯