커스텀 시간 프레임
커스텀 시간 프레임 (Custom Time Frames)
Datadog의 여러 보기는 특정 시간 프레임으로 범위를 좁힐 수 있어요. 시간 컨트롤에는 일반적인 시간 프레임 목록과 빠른 선택을 위한 달력 선택기가 포함되며, 이동·증가·고정형 시간 프레임, 달력 정렬 날짜, URL 기반 시간 조작까지 다양한 문법을 지원합니다.
출처: 문서
본문
개요 (Overview)
정보: 쿼리는 UTC 시간으로 실행되지만, 쿼리 시간 프레임은 브라우저의 시간대에 따라 선택됩니다. 대시보드 구성 작업에서 기본 시간대 또는 UTC 표시 사이를 전환할 수 있어요. 자세한 내용은 대시보드 구성 문서를 참고하세요.
Datadog의 많은 보기는 특정 시간 프레임으로 범위를 정할 수 있어요. 시간 컨트롤에는 흔한 시간 프레임 목록과 빠른 선택을 위한 달력 선택기가 포함됩니다.
시간 프레임은 다음과 같을 수 있어요:
- 이동형 (Sliding): 시작과 끝이 모두 시간이 흐르면서 앞으로 이동합니다 (예:
5h는 항상 가장 최근 5시간을 보여 줍니다). - 증가형 (Growing): 시작은 고정되고 끝은 "지금(now)"을 추적합니다 (예:
since Jun 1은 6월 1일부터 현재까지의 모든 것을 보여 줍니다). - 고정형 (Fixed): 시작과 끝이 모두 특정 시점에 고정됩니다 (예:
Jan 1 - Jan 2).
월, 일, 년, 시, 분 단위로 증가시키려면 시간 프레임의 일부를 강조하고 [↑]와 [↓] 키를 사용하세요.
지원되는 문법 (Supported syntaxes)
고정 날짜 (Fixed dates)
| 형식 | 예시 |
|---|---|
{MMM/MMMM} D |
Jan 1, January 1 |
M/D |
1/1 |
M-D |
1-1 |
M/D/{YY/YYYY} |
1/1/19, 1/1/2019 |
M-D-{YY/YYYY} |
1-1-19, 1-1-2019 |
{MMM/MMMM} D, h:mm a |
Jan 1, 1:00 pm, January 1, 1:00 pm |
{MMM/MMMM} D, YYYY, h:mm a |
Jan 1, 2019, 1:00 pm, January 1, 2019, 1:00 pm |
h:mm a |
1:00 pm |
| Unix 초 타임스탬프 | 1577883600 |
| Unix 밀리초 타임스탬프 | 1577883600000 |
모든 고정 날짜는 범위의 일부로 입력될 수 있어요. 예를 들어:
1577883600 - 1578009540Jan 1 - Jan 26:00 am - 1:00 pm
상대 날짜 (Relative dates)
상대 날짜는 시간이 지남에 따라 업데이트되며, 현재 시간에서 계산됩니다.
| 형식 | 설명 |
|---|---|
N{unit} |
지난 N 단위의 이동 창을 표시합니다. 허용되는 단위는 아래에 나열돼 있어요. 시작과 끝이 모두 시간과 함께 앞으로 이동합니다. 예: 3 mo (지난 3개월). 끝이 "지금"에 머무는 증가형 창을 만들려면 to now 문법을 사용하세요 (예: 10am to now). 자세한 내용은 '증가형 시간 프레임'을 참고하세요. |
상대 날짜에서 모든 {unit}에 대해 다음 문자열이 허용됩니다:
- 분:
m,min,mins,minute,minutes - 시:
h,hr,hrs,hour,hours - 일:
d,day,days - 주:
w,week,weeks - 월:
mo,mos,mon,mons,month,months
증가형 시간 프레임 (Growing time frames)
증가형 시간 프레임은 시작이 고정되고 자동으로 현재 시간("지금")까지 확장됩니다. 특정 시점 이후의 모든 활동을 보고 싶을 때 유용해요.
| 형식 | 설명 |
|---|---|
{date} to now |
{date}부터 지금까지의 증가형 창입니다. 예: Jan 1 to now. |
{date} - now |
{date} to now와 동일합니다. 예: Jan 1 - now. |
since {date} |
{date} to now와 동일합니다. 예: since Jun 1, since 5h, since 1549116000. |
from {date} |
{date} to now와 동일합니다. 예: from Jun 1, from 5h. |
두 형식의 {date}는 다음 중 어떤 것이든 허용합니다:
- 상대 축약형 (예:
5h,2d,3w) - 고정 날짜 (예:
Jun 1,Feb 2 2pm,1/15/2024) - 초 또는 밀리초 단위의 Unix 타임스탬프 (예:
1549116000,1549116000000)
달력 정렬 날짜 (Calendar-aligned dates)
달력 정렬 날짜는 달력 경계(자정, 주 시작, 월 시작 등)에 스냅되며 시간이 지나면서 그에 따라 업데이트됩니다.
| 형식 | 설명 |
|---|---|
today |
현재 달력 날짜부터 현재까지 |
yesterday |
지난 전체 달력 날짜 |
week to date |
월요일 12AM부터 현재까지의 이번 주 |
month to date |
1일부터 현재까지의 이번 달 |
year to date |
1월 1일부터 현재까지의 올해 |
this {unit} |
현재 달력 단위부터 현재까지. 예: this month, this year |
last {unit} |
지난 전체 달력 단위. 예: last month, last year |
previous {unit} |
last {unit}와 동일합니다. 예: previous week, previous month |
N {units} ago |
N 기간 이전의 전체 달력 단위. 예: 2 weeks ago, 3 months ago |
URL (URLs)
대시보드의 URL에서 시간 쿼리를 조작할 수 있어요.
다음 대시보드 URL을 생각해 보세요:
https://app.datadoghq.com/dash/host/<DASHBOARD_ID>?from_ts=<QUERY_START>&to_ts=<QUERY_END>&live=true
from_ts파라미터는 쿼리 시작 시간의 Unix 밀리초 타임스탬프입니다. 예:1683518770980.to_ts파라미터는 쿼리 종료 시간의 Unix 밀리초 타임스탬프입니다. 예:1683605233205.live=true는 쿼리를 저장하거나 공유할 때 상대 시간 지정이 유지됨을 나타냅니다.live=false도 사용할 수 있어요.