Datadog와 OpenTelemetry 메트릭 간 쿼리
Datadog와 OpenTelemetry 메트릭 간 쿼리 (Query Across Datadog and OpenTelemetry Metrics)
많은 조직이 OpenTelemetry(OTel)을 Datadog와 함께 사용해, 일부 호스트는 OTel 메트릭을 내보내고 다른 호스트는 Datadog 메트릭을 내보내는 하이브리드 환경을 만들고 있어요. OTel과 Datadog 메트릭은 종종 서로 다른 명명 규칙과 의미적 정의를 사용하므로, 이런 환경에서 인프라의 통합된 뷰를 만드는 것은 어려울 수 있습니다.
Datadog은 다음을 가능하게 해 이 간극을 메워 줘요.
- OTel과 Datadog 메트릭을 함께 쿼리하기.
- 메트릭 소스와 매핑 이해하기.
출처: 문서
본문
쿼리에서 OpenTelemetry와 Datadog 메트릭 통합하기 (Unify OpenTelemetry and Datadog metrics in queries)
Preview 참여하기!
Telemetry source 쿼리 수정자는 OTel Native Instrumentation preview가 필요해요. 이 폼을 사용해 액세스를 요청하세요.
Metrics Query Editor와 대시보드 위젯에는 Telemetry source 쿼리 수정자가 있어요. OTel과 Datadog 소스에서 잠재적으로 동등한 메트릭을 Datadog이 어떻게 처리할지 제어할 수 있습니다. Modify를 선택한 뒤 Telemetry sources 섹션에서 Native telemetry 또는 Combined telemetry를 선택하세요.
두 가지 모드 중에서 선택할 수 있어요.
Native telemetry (기본값)
- 이 모드는 입력한 특정 메트릭 이름만 쿼리해요(Datadog 메트릭이든 OTel 메트릭이든).
- 동등한 메트릭의 데이터는 포함하지 않습니다.
Combined telemetry
- 이 모드는 메트릭 이름을 하나만 입력해도, 동등한 Datadog와 OTel 메트릭의 데이터를 자동으로 하나의 쿼리로 결합해요.
- 동등한 메트릭 간의 매핑(복잡한 것 포함)을 처리하고, 관련된 모든 타임시리즈를 단일 메트릭으로 집계합니다.
- Datadog 메트릭으로 시작하든 OTel 메트릭으로 시작하든 동작해요.
예시 (Example)
두 가지 다른 메트릭으로 시스템 로드를 모니터링한다고 상상해 보세요.
- OTel 네이티브:
system.cpu.load_average.15m - Datadog 에이전트:
system.load.15
system.cpu.load_average.15m을 쿼리하고, max 공간 집계를 적용하고, 텔레메트리 소스를 Combined telemetry로 설정하면 Datadog은 자동으로:
- 동등한 Datadog 메트릭
system.load.15을 식별해요. system.cpu.load_average.15m과system.load.15양쪽의 타임시리즈를 결합합니다.- 두 소스의 모든 데이터포인트에 max 집계를 적용해요.
메트릭 소스와 매핑 이해하기 (Understand metric sources and mappings)
쿼리할 때 명확성을 제공하기 위해 메트릭 소스와 동등한 메트릭이 표시돼요.
- 소스 알약(Source pill): 쿼리 편집기에서 메트릭 이름 옆에 Datadog 또는 OTel 알약이 나타나 그 기원을 나타냅니다.
- 동등 메트릭 목록(Equivalent metrics list): 편집기는 쿼리한 메트릭과 동등하다고 간주되는 메트릭 목록도 보여 줘요. 여기에는 복잡한 일대다 매핑이 포함됩니다. 예를 들어
system.cpu.utilization은 여러 Datadog CPU 상태 메트릭(system.cpu.idle,system.cpu.iowait등)에 매핑됩니다.
상세 매핑 보기 (View detailed mappings)
특정 OTel과 Datadog 메트릭이 어떻게 관련되는지 포괄적으로 보려면 Metrics Summary 페이지를 확인하세요.
- Metrics > Summary로 이동하세요.
- 알려진 Datadog 또는 OTel 메트릭을 검색하세요.
- 메트릭 상세(Metric Details) 사이드 패널을 여세요.
또는 쿼리 편집기에서 메트릭을 입력할 때 Metrics Summary의 Edit을 클릭해도 됩니다.
이 패널은 복잡한 관계를 포함한 메트릭 매핑을 표시해요. 예를 들어 system.cpu.utilization이 system.cpu.idle, system.cpu.user 등 여러 Datadog 메트릭에 어떻게 매핑되는지 보여 줍니다.
이 매핑에 사용되는 태그 기반 로직도 볼 수 있어요. 동등 메트릭에 마우스를 올리면 특정 조건이 표시됩니다. 예를 들어 system.cpu.idle에 마우스를 올리면 state=idle일 때 system.cpu.utilization에 매핑되고, 값에 100이 곱해진다는 것을 보여 줍니다.