제외

원문 보기 위키 갱신 2026.10.05

제외 (Exclusion)

제외 함수는 특정 값을 가진 그룹을 그래프에서 제거하거나, 임계값 아래·위의 메트릭 값을 임계값으로 대체하거나 NaN으로 바꾸는 함수예요. 그래프를 단순히 하고 싶을 때 유용합니다.

출처: 문서

본문

null 제외 (Exclude null)

함수	설명	예시
`exclude_null()`	그래프나 탑 리스트에서 N/A 태그 값을 가진 그룹을 제거합니다.	`exclude_null(avg:system.load.1{*} by {host})`

예를 들어 두 개의 태그(account, region)를 가진 메트릭이 있다고 해 볼게요. account는 세 가지 값(prod, build, N/A)을, region은 네 가지 값(us-east-1, us-west-1, eu-central-1, N/A)을 가질 수 있습니다.

이 메트릭을 timeseries로 그리면 그래프에 3 x 4 = 12개의 라인이 생겨요. exclude_null()을 적용하면 N/A 값을 하나라도 포함하는 태그 조합의 라인이 제거되어 2 x 3 = 6개 그룹만 남습니다.

클램프 (Clamp)

함수	설명	예시
`clamp_min()`	임계값 아래에 있는 메트릭 값을 그 값과 동일하게 설정합니다.	`clamp_min(avg:system.load.1{*}, 100)`
`clamp_max()`	임계값 위에 있는 메트릭 값을 그 값과 동일하게 설정합니다.	`clamp_max(avg:system.load.1{*}, 100)`

임계값을 추가하세요. clamp_min()은 임계값보다 낮은 모든 데이터 포인트를 그 값과 동일하게 만들고, clamp_max()는 임계값보다 높은 데이터 포인트를 제한해요.

참고: clamp_min(values, threshold)와 clamp_max(values, threshold)는 값에 있는 NaN을 threshold로 설정합니다.

이 동작을 피하려면 clamp_min() / clamp_max() 함수 앞에 default_zero()를 적용하세요.

컷오프 (Cutoff)

함수	설명	예시
`cutoff_min()`	임계값 아래에 있는 메트릭 값을 NaN으로 대체합니다.	`cutoff_min(avg:system.load.1{*}, 100)`
`cutoff_max()`	임계값 위에 있는 메트릭 값을 NaN으로 대체합니다.	`cutoff_max(avg:system.load.1{*}, 100)`

임계값을 추가하세요. cutoff_min()은 이 임계값보다 낮은 모든 메트릭 값을 NaN으로 대체하고, cutoff_max()는 이 임계값보다 높은 모든 메트릭 값을 NaN으로 대체합니다. 컷오프 함수는 임계값과 동일한 값은 대체하지 않아요.

팁: 클램프와 컷오프 함수 모두 선택한 임계값을 확인하는 게 도움이 될 수 있어요. 대시보드에서 가로 마커를 설정해 이 값을 표시할 수 있습니다.

기타 함수 (Other functions)

사용할 수 있는 다른 함수들을 확인해 보세요:

더 알아보기 (Learn more)

Datadog 대시보드