위젯 구성

원문 보기 위키 갱신 2026.10.05

위젯 구성은 인프라와 애플리케이션에 대한 의미 있는 인사이트를 제공하는 효과적인 대시보드를 만드는 데 필수적이에요. 이 가이드는 위젯을 설정할 때 이해해야 할 핵심 구성 옵션과 고려 사항을 다룹니다.

출처: 문서

본문

개요

전체 화면 (Full screen)

전체 화면 모드는 위젯에 대한 향상된 보기 및 분석 기능을 제공해요. 대부분의 위젯을 전체 화면 모드로 보고 다음을 수행할 수 있어요:

시간 범위 변경
선택한 시간 범위만큼 앞뒤로 이동
현재 시간에 그래프 일시 중지 또는 실시간 그래프 보기
시간 범위 재설정
그래프를 대시보드나 노트북으로 내보내거나 쿼리 복사
그래프를 생성하는 데이터를 CSV 형식으로 다운로드

위젯 개요에 직접 접근하려면 위젯 오른쪽 위 모서리의 전체 화면 버튼을 클릭해요.

timeseries 위젯에는 추가 옵션이 있어요.

데이터 미리 보기 (Data preview)

그래프 편집기에서 여러 데이터 소스를 결합하면 추가 컨텍스트와 메타데이터로 시각화를 풍부하게 만들 수 있어요. 데이터 미리 보기(Data Preview)를 사용하면 어떤 데이터를 조인하는지, 쿼리가 예상대로 작동하는지 확인할 수 있어요. 이 기능은 다음을 도와줍니다:

데이터 구조와 열 이름 확인
일치하는 키 식별
전체 쿼리를 실행하기 전에 결과 검증

예시

결제 로그를 제품 세부 정보가 포함된 참조 테이블(lookup table)과 조인해 트랜잭션 데이터와 함께 판매 가격이나 출시 날짜를 표시할 수 있어요. 또는 Salesforce나 Snowflake 같은 외부 소스의 고객 정보와 RUM 세션 데이터를 조인해 고객 등급으로 사용자를 세그먼트화할 수 있어요.

조인에 지원되는 데이터 소스는 다음과 같습니다(이에 국한되지 않아요):

Logs
Metrics
RUM
Cloud Cost Recommendations
Netflow
APM Spans
APM Traces
Profiles
Synthetics CI Batches
Synthetics Run
Static Analysis
CI Tests
Compliance Findings
Product Analytics
Reference Tables

조인과 데이터 미리 보기를 사용하면 올바른 필드를 선택하고 그래프를 관련 세부 정보로 풍부하게 만들어 대시보드의 품질과 유용성을 개선할 수 있어요.

사용자 지정 링크 (Custom links)

사용자 지정 링크는 위젯 데이터 값을 Datadog 페이지나 AWS 콘솔 같은 관련 URL에 연결해 데이터 상호작용을 향상시켜 줍니다.

일반 위젯에서 데이터와 인라인으로 상호작용을 사용자 지정하려면 Context Links를 참조해요.

위젯 설명을 사용하면 모든 대시보드 위젯에 텍스트 설명을 추가할 수 있어요. 설명을 사용해 메트릭이 무엇을 나타내는지, 어떻게 해석할지, 어떤 조치를 취해야 하는지 같은 컨텍스트를 제공해요.

설명을 추가하려면:

위젯의 그래프 편집기를 엽니다.
편집기 하단에 Description을 입력해요.
Save를 클릭해요.

저장 후 위젯 왼쪽 위의 설명 아이콘 위에 마우스를 올리면 설명을 볼 수 있어요.

메트릭 정보 (Metrics info)

메트릭 그래프에서 컨텍스트 메뉴(세로 점 3개)를 클릭하면 Metrics Info 옵션을 찾을 수 있어요. 이렇게 하면 메트릭에 대한 설명이 있는 패널이 열려요. 이 패널에서 메트릭 이름을 클릭하면 추가 분석이나 편집을 위해 메트릭 요약 페이지에서 메트릭이 열려요.

단위 재정의 (Unit override)

단위 재정의는 데이터 값이 위젯에 표시되는 방식을 사용자 지정할 수 있게 해 주는 핵심 표시 옵션이에요. 데이터에 의미 있는 컨텍스트를 추가할 수 있어요. 더 많은 사용 사례와 정보는 Customize your visualizations with unit overrides를 참조해요.

단위 재정의: 'memory' 계열의 단위를 표시하도록 선택하고, 데이터에 따라 적절한 스케일(예: 메가바이트 또는 기가바이트)을 표시하도록 Datadog가 처리하게 해요.
단위 및 스케일 재정의: 단위를 단일 스케일로 고정해요(값과 관계없이 메가바이트로 표시).
사용자 지정 단위 정의: 완전히 사용자 지정 단위를 정의해요(일반 count 대신 'tests' 같은).

이는 데이터에 단위를 할당하는 대안이 아니에요.

조직 수준에서 단위를 설정해요:

전체 시간 선택기 (Global time selector)

전체 시간 선택기는 대시보드의 모든 위젯이 같은 시간 범위를 사용하도록 동기화하는 기본적인 시간 구성 옵션이에요. 전체 시간 선택기를 사용하려면 시간 기반 위젯이 하나 이상 Global Time을 사용하도록 설정되어 있어야 해요. 위젯 편집기의 Set display preferences에서 선택하거나 위젯을 추가하면 됩니다(전체 시간이 기본 시간 설정이에요).

전체 시간 선택기는 같은 대시보드에서 Global Time 옵션을 사용하는 모든 위젯에 같은 시간 범위를 설정해요. 과거의 이동 창(예: Past 1 Hour 또는 Past 1 Day)을 선택하거나 Select from calendar… 옵션 또는 사용자 지정 시간 범위 입력으로 고정 기간을 선택해요. 이동 창을 선택하면 위젯이 시간 창과 함께 움직이도록 업데이트돼요.

전체 시간에 연결되지 않은 위젯은 해당 로컬 시간 범위의 데이터를 전체 시간 창에 적용해 표시해요. 예를 들어 전체 시간 선택기가 2019년 1월 1일부터 1월 2일까지로 설정된 경우, 로컬 시간 범위가 Past 1 Minute로 설정된 위젯은 2019년 1월 2일 오후 11:59부터의 마지막 1분을 표시해요.

위젯 복사 및 붙여넣기 (Copy and paste widgets)

복사 및 붙여넣기 기능은 위젯을 서로 다른 Datadog 컨텍스트와 외부 도구에서 재사용할 수 있게 해 주는 핵심 공유 및 협업 기능이에요.

참고: 링크 미리 보기와 함께 위젯을 Datadog 외부로 공유하려면 관리자가 조직 설정에서 Widget Share URLs를 Public 또는 Private으로 설정해야 해요. 관리자는 이 설정을 비활성화해 사용자가 위젯 공유 링크와 미리 보기를 생성하지 못하게 할 수 있어요.

위젯은 Dashboards, Notebooks, APM Service, 그리고 APM resource 페이지에서 Ctrl/Cmd + C로 또는 공유 아이콘을 선택하고 "Copy"를 선택해 복사할 수 있어요.

복사된 위젯은 Ctrl/Cmd + V로 Datadog 내에서 붙여넣을 수 있어요:

Dashboards: 마우스 커서 아래에 새 위젯을 추가해요.
Notebooks: 노트북 끝에 새 셀을 추가해요.

링크 미리 보기를 표시하는 즐겨 쓰는 채팅 프로그램(예: Slack 또는 Microsoft Teams)에도 위젯을 붙여넣을 수 있어요. 조직의 Widget Share URLs 모드에 따라 그래프의 공개 미리 보기 이미지 또는 Slack의 비공개 미리 보기 이미지와 위젯의 직접 링크가 표시돼요. 자세한 내용은 Widget Share URLs를 참조해요.

위젯 그룹 (Groups of widgets)

그룹 위젯 영역 위에 마우스를 올리고 Ctrl/Cmd + C를 사용하거나 공유 아이콘을 선택하고 "Copy"를 선택해 Timeboard 그룹 위젯을 복사해요.

참고: 그래프를 screenboard나 노트북에 붙여넣으면 Datadog는 그룹의 각 위젯을 개별적으로 붙여넣어요.

여러 screenboard 위젯을 복사하려면(편집 모드만) Shift + 클릭으로 위젯을 선택하고 Ctrl/Cmd + C를 사용해요.

참고: 이 기능은 Datadog 내에서 공유할 때만 작동해요. 미리 보기 이미지를 생성하지 않아요.

위젯 그래프 메뉴는 필수 데이터 상호작용 옵션을 제공해요. 그래프 위에 마우스를 올리면 다음 메뉴 옵션에 접근할 수 있어요.

전체 화면으로 보기

그래프를 전체 화면 모드로 봐요.

내보내기 (Export)

대시보드 그래프의 내보내기 아이콘을 클릭하면 옵션 메뉴가 열려요:

옵션	설명
Copy	대시보드 그래프의 복사본을 만들어요.
Share snapshot	그래프의 스냅샷을 만들어 보내요.

Datadog 내에서 사용

옵션	설명
Declare incident	그래프에서 인시던트를 선언해요.
Add to incident	그래프를 기존 인시던트에 추가해요.
Create case	그래프에서 케이스를 만들어요.
Save to notebook	그래프를 노트북에 저장해요.
Link to widget	클립보드에 복사된 위젯 링크를 얻어요.

외부 공유

형식	설명
Download as PNG	위젯을 PNG 형식으로 다운로드해요.
Download as SVG	위젯을 SVG 형식으로 다운로드해요.
Download as CSV	위젯을 CSV 형식으로 다운로드해요.

편집 (Edit)

대시보드 그래프의 연필 아이콘을 클릭해 편집해요.

추가 옵션

대시보드 그래프의 컨텍스트 메뉴(세로 점 3개)를 클릭하면 옵션 메뉴가 열려요:

옵션	설명
Edit	그래프를 편집해요.
Clone	그래프의 인접한 복사본을 만들어요.
Split graph	분할 그래프를 만들어요.
Create custom links	사용자 지정 링크를 만들어요.
Create monitor	그래프의 쿼리로 미리 구성된 모니터를 만들어요.
Metrics info (메트릭 그래프만)	이 그래프의 메트릭에 대한 설명을 얻어요. 메트릭 이름을 클릭하면 Metric Summary 페이지에서 열 수 있어요.
Delete	그래프를 삭제해요.