로컬 시간대를 반영하도록 이상 탐지 모니터 업데이트하기

원문 보기 위키 갱신 2026.10.05

로컬 시간대를 반영하도록 이상 탐지 모니터 업데이트하기 (How to update an anomaly detection monitor to account for local time zone)

Datadog 모니터는 UTC 시간을 사용하며, 기본적으로 로컬 시간대를 추적하지 않아요. 시스템 유형에 따라 데이터가 사용자 시간대의 로컬 활동에 영향을 받을 수 있어요. 예를 들어 점심 시간 급증이 하루 중반에 스파이크를 일으킬 수 있고, 이 급증이 예상치 못한 이상 징후로 감지될 수 있어요. 로컬 활동으로 인해 예상치 못한 이상 징후가 발생한다면, 로컬 시간대를 반영하도록 이상 탐지 모니터를 업데이트해요.

agile 또는 robust 이상 탐지 알고리즘을 주간 또는 일간 계절성(seasonality)과 함께 사용한다면, API와 UI 양쪽에서 로컬 시간대를 반영하도록 이상 탐지 모니터를 업데이트할 수 있어요.

다음은 로컬 시간대를 반영하도록 설정하기 전의 모니터 예시예요:

{% image source="https://docs.dd-static.net/images/monitors/guide/dst-off.68fb742641fbc6b25fac45e8365b4a7b.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/monitors/guide/dst-off.68fb742641fbc6b25fac45e8365b4a7b.png?auto=format&fit=max&w=850&dpr=2 2x" alt="DST tracking turned off" /%}

다음은 일광 절약 시간을 고려할 때의 모니터 예시예요:

{% image source="https://docs.dd-static.net/images/monitors/guide/dst-on.cbbb1fab33ee4755b367f3e8943e9f0c.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/monitors/guide/dst-on.cbbb1fab33ee4755b367f3e8943e9f0c.png?auto=format&fit=max&w=850&dpr=2 2x" alt="DST tracking turned on" /%}

출처: 문서

본문

UI (UI)

UI에서 로컬 시간대를 반영하도록 이상 탐지 모니터를 업데이트하려면 New monitor > Anomaly monitor로 이동해요. Set Alert Conditions 섹션 아래에서 Advanced 패널을 열고, 모니터를 평가할 때 일광 절약 시간을 고려하도록 스위치를 켜요. 그다음 timezone 드롭다운을 추적하고 싶은 시간대에 맞춰 설정해요.

{% image source="https://docs.dd-static.net/images/monitors/guide/how_to_update_anomaly_monitor_timezone/daylight_savings_toggle.30527dbd220060e6f535fd4b66c1be9a.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/monitors/guide/how_to_update_anomaly_monitor_timezone/daylight_savings_toggle.30527dbd220060e6f535fd4b66c1be9a.png?auto=format&fit=max&w=850&dpr=2 2x" alt="DST toggle option in the UI" /%}

API (API)

모니터 API를 통해 업데이트 요청을 보내려면 다음 정보가 필요해요:
- 인증을 위한 Datadog API 키와 애플리케이션 키예요.
- 이상 탐지 모니터의 모니터 ID와 쿼리예요. 앱에서 쿼리하는 모니터로 이동하면 URL에서 모니터 ID를 찾을 수 있어요.
- 메트릭과 관련된 시간대의 TZ 식별 문자열이에요. 예를 들어 America/New_York 또는 Europe/Paris예요. tz 데이터베이스 시간대 목록의 TZ 열에서 선호하는 시간대를 찾아보세요 (정규 형식(canonical format) 권장).
anomalies() 함수 호출에 timezone 인자를 추가해 모니터 쿼리의 업데이트 버전을 만들어요. 예를 들어 위에 표시된 쿼리를 뉴욕 현지 시간을 사용하도록 바꾸려면 쿼리를 이렇게 업데이트하면 돼요:
```
avg(last_4h):anomalies(avg:system.cpu.user{role:trace-cassandra} by {host}, 'basic', 2, direction='both', alert_window='last_15m', interval=60, count_default_zero='true', timezone='America/New_York') >= 1
```
Edit a Monitor API로 모니터 정의를 업데이트해요.
- 예시는 Python, Ruby, cURL로 제공돼요.
- 기존 설정을 덮어쓰지 않도록 요청에는 ID와 쿼리만 포함해요. name, message, options, tags는 필요하지 않아요.

로컬 시간대를 반영하도록 이상 탐지 모니터 업데이트하기