• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

OpenTelemetry APM UI

OpenTelemetry APM UI OpenTelemetry 를 통해 서비스에 대한 포괄적인 모니터링 경험을 제공하며, 뉴렐릭의 기존 언어 에이전트에서 기대하는 것과 동일한 강력한 APM 기능을 제공합니다.

전제 조건

OpenTelemetry APM UI를 사용하기 전에 다음 사항을 확인하세요.

이러한 단계를 완료하지 않은 경우 OpenTelemetry APM 모니터링 에서 설정 지침을 참조하세요.

OpenTelemetry 서비스 찾기

OpenTelemetry-계측 서비스를 찾으려면:

  1. 뉴렐릭 UI 에서 All entities > Services - OpenTelemetry 또는 APM & Services로 이동합니다.
  2. 서비스를 선택하여 요약 페이지를엽니다.

서비스를 필터링하려면 파티션 탐색기에서 분류 태그를 사용하세요. 뉴렐릭의OpenTelemetry 리소스 에서 항해 태그가 컴퓨트인 방법에 대해 자세히 알아보세요.

OpenTelemetry 가 뉴렐릭 APM과 작동하는 방식

OpenTelemetry-계측된 서비스는 뉴렐릭의 에이전트 언어를 사용하는 서비스와 동일하게 선별된 APM 경험을 제공합니다. 작동 원리는 다음과 같습니다.

데이터 매핑 프로세스

뉴렐릭은 다음을 통해 OpenTelemetry 데이터를 APM 규칙에 자동으로 매핑합니다.

  1. APM 메트릭 생성: OpenTelemetry 데이터에서 직접 APM 경험에 필요한 메트릭을 생성합니다.
  2. 원본 데이터 보존: 원본 OpenTelemetry 데이터는 맞춤형 대시보드 및 알림에 계속 사용할 수 있습니다.
  3. 정규화 규칙: OpenTelemetry의 진화하는 의미 규칙을 처리하므로 버전 차이를 추적할 필요가 없습니다.

기존 뉴렐릭 사용자의 장점

뉴렐릭 에이전트에서 OpenTelemetry 로 전환하는 경우 OpenTelemetry 표준을 채택하면서 익숙한 지표와 쿼리를 계속 사용할 수 있습니다.

중요

OpenTelemetry 데이터를 정규화하는 이유

OpenTelemetry의 의미적 규칙은 계속 발전하고 있으며, 그 중 많은 규칙이 아직 안정적이지 않습니다. 데이터를 뉴렐릭 규칙에 따라 정규화하면 다음과 같은 이점이 있습니다.

  • 측정, 계측에서 사용하는 OpenTelemetry 규칙 버전을 추적하는 복잡성을 줄이세요.
  • 뉴렐릭 에이전트에서 OpenTelemetry로 전환할 때 일관된 경험 제공
  • OpenTelemetry 변경 사항에 관계없이 APM 환경이 안정적으로 유지되도록 하세요.

데이터 소스 및 우선순위

APM 환경은 세 가지 유형의 OpenTelemetry 데이터를 사용합니다.

  • 메트릭 (기본): 처리량, 응답 시간, 오류율과 같은 정확한 서비스 통계를 제공합니다.
  • Spans (보조): 인덱스를 사용할 수 없거나 프로세서 트레이스와 같은 특정 장치에 사용됩니다.
  • 로그: 문제 해결, 처리, 상관관계 통합

지표가 선호되는 이유: 지표는 서비스의 전반적인 그림을 제공하지만, 스팬은 일반적으로 샘플링되어 모든 트래픽을 대표하지 않을 수 있습니다.

APM 환경은 주로 다음과 같은 OpenTelemetry 의미 규칙을 활용합니다.

OpenTelemetry 데이터에서 거래가 파생되는 방식

뉴렐릭의 APM 경험은 트랜잭션 개념을 중심으로 이루어집니다. 뉴렐릭 에이전트를 사용할 때 트랜잭션 범위(예: 단일 웹 요청)를 정의하는 것은 에이전트의 측정, 리소스의 책임입니다. 에이전트는 트랜잭션 지표를 기록하고, 트랜잭션 기간과 개별 작업(예: 외부 통화 및 데이터베이스 통화)을 측정하여 대부분의 뉴렐릭 APM 경험을 주도하는 지표 데이터를 생성합니다.

OpenTelemetry 측정, 계측에는 뉴렐릭 거래와 직접적인 유사점이 없으므로 거래 개념을 OpenTelemetry 데이터에 맞게 조정하는 것이 중요합니다.

OpenTelemetry의 의미 규칙을 활용하면 텔레메트리를 설명하는 OpenTelemetry의 고도로 구조화되고 표준화된 수단을 활용하여 뉴렐릭의 에이전트와 매우 유사한 방식으로 APM 경험을 제공할 수 있습니다.

의미적 규칙은 HTTP 또는 RPC requests 처리와 같은 일반적인 작업을 측정하기 위한 표준 지표를 정의합니다. 이러한 지표는 인텔 프로세서를 설명하기 위해 생성하는 트랜잭션 지표와 유사합니다. OpenTelemetry의 HTTP 및 RPC 지표를 활용하여 apm.service.transaction.duration 지표 와 같은 APM UI 구동하는 지표를 합성합니다.

뉴렐릭은 비웹 프로세서 의 개념도 제공합니다. 비 웹 프로세서는 일반적으로 메시지 처리를 수행하는 시스템에 사용됩니다. OpenTelemetry의 메시징 규칙을 활용하는 측정, 로그는 비 웹 프로세서를 나타내는 메트릭을 합성하게 됩니다.

중요

메시징 작업 및 스팬 데이터

OpenTelemetry의 메시징 규칙은 HTTP 및 RPC 규칙보다 덜 성숙했습니다. 현재 우리는 메트릭 데이터가 아닌 범위 데이터에서 메시징 작업을 위한 비 웹 프로세서 그래픽을 생성합니다. 이 접근 방식은 메시징 의미 규칙을 따르지만 샘플링 전략의 영향을 받을 수 있습니다.

거래 이름

각 거래에는 OpenTelemetry의 의미 규칙에 필요한 속성에서 파생된 이름이 있습니다. 이 이름이 어떻게 유래되었는지는 APM 서비스 메트릭 섹션을 참조하세요.

알 수 없는 거래 이름

때로는 이름에 unknown 포함된 거래를 볼 수 있습니다. 이는 거래를 도출하는 데 사용된 소스 데이터가 현재 우리가 지원하는 OpenTelemetry 의미 규칙을 전혀 따르지 않는다는 것을 나타냅니다.

몇 가지 예:

  • HTTP 메트릭에 http.request.method 또는 http.route 없습니다. 예를 들어, http.server.request.duration 메트릭에 http.route 속성이 없으면 거래 이름은 WebTransaction/server/GET unknown 됩니다.
  • OpenTelemetry 현재 의미론적 규칙을 정의하지 않는 프레임워크 또는 프로토콜(예: 백그라운드 작업 및 CI 프레임워크).

APM 경험 탐색

요약

요약 페이지는 서비스 상태에 대한 개요를 제공하며 뉴렐릭의 트랜잭션 개념을 중심으로 구성됩니다. 자세한 내용은 OpenTelemetry 데이터에서 거래가 파생되는 방식을 참조하세요.

요약 페이지를 구동하는 뉴렐릭 지표는 apm.service.transaction.durationapm.service.error.count 지표입니다. OpenTelemetry 데이터에서 어떻게 파생되는지에 대한 자세한 내용은 해당 항목을 참조하세요.

Customizing Apdex 목표, 목표

뉴렐릭 측정, 사용자 정의 apdex 로그, 출력은 에이전트 설정을 사용하여 구성됩니다. OpenTelemetry 의 경우 서비스를 볼 때 Settings > Application 으로 이동하여 Apdex를 구성하려면 목표를 설정하세요.

분산 추적

혐의 추적 페이지에서는 OpenTelemetry Traces 데이터에 대한 자세한 인사이트를 제공합니다. 페이지 사용 정보는 분산 추적을 참조하세요. Traces 데이터가 OpenTelemetry 뉴렐릭으로 수집되는 방법에 대한 자세한 내용은 뉴렐릭의 Traces를 참조하세요.OpenTelemetry

골든 시그널 과 마찬가지로 스팬 상태가 ERROR (예: otel.status_code = ERROR)로 설정된 경우 스팬은 오류로 분류됩니다. 범위가 오류인 경우 범위 상태 설명(예: otel.status_description)이 오류 세부정보 에 표시됩니다.

OpenTelemetry 범위 이벤트는 추가 이벤트 컨텍스트 정보를 특정 범위에 연결합니다. They are most commonly used to capture exception information. 사용 가능한 경우 trace details [추적 세부 정보] 에서 스팬 이벤트를 볼 수 있습니다.

스팬 예외 이벤트가 존재한다고 해서 그 자체로 스팬이 오류로 간주되는 것은 아닙니다. ERROR 으로 설정된 스팬 상태만 오류로 분류됩니다.

Screenshot showing the right pane showing the two links for span events

서비스 맵

서비스 맵 페이지는 전체 아키텍처의 시각적 표현을 제공합니다. 자세한 내용은 서비스 지도를 참조하세요.

업무

거래 페이지는 서비스 거래 의 문제를 식별하고 분석하는 도구를 제공합니다.

OpenTelemetry 뉴렐릭의 거래 개념과 직접적인 유사점이 없습니다. 자세한 내용은 OpenTelemetry 데이터에서 거래가 파생되는 방식을 참조하세요.

거래 페이지를 구동하는 뉴렐릭 지표는 apm.service.transaction.durationapm.service.error.count 지표입니다. OpenTelemetry 데이터에서 어떻게 파생되는지에 대한 자세한 내용은 해당 항목을 참조하세요.

트랜잭션 추적

OpenTelemetry 용 그래픽 트레이스 는 스팬 데이터에서 파생됩니다. 거래 페이지에서 프로세서 트레이스 목록을 확인할 수 있습니다. 이 목록을 작성하려면 주어진 거래에 대한 범위 데이터와 메트릭 데이터를 서로 연관시켜야 합니다. 이를 위해서는 프로세서 트레이스의 루트 범위에 transaction.name 속성을 추가하면 됩니다.

세그먼트 분류

거래를 클릭하면 해당 거래의 세부 보기가 열리고 세그먼트별 세부 정보가 표시됩니다. 뉴렐릭 에이전트와 달리 OpenTelemetry 개별 세그먼트에 대한 지표를 생성하지 않습니다. 따라서 세그먼트 분석을 수행하는 데 필요한 뉴렐릭 지표는 범위 데이터에서 파생됩니다.

스팬 데이터에서 세그먼트 세분화를 계산하는 데 있어 주목할 만한 단점은 스팬이 일반적으로 샘플링된다는 것입니다. 하지만 샘플링을 하더라도 세그먼트 분류는 거래 내에서 가장 많은 시간을 소모하는 특정 방법이나 작업을 식별하는 데 도움이 될 수 있습니다.

스팬 데이터에서 수신된 스팬 데이터를 기반으로 처리량을 계산하여 샘플링 속도를 추정하고, 이를 메트릭 데이터에서 보고된 실제 처리량으로 나눕니다. 추정된 샘플링 속도를 통해 거래의 세그먼트별 세부 내용을 추정할 수 있습니다.

이 과정은 완벽하지 않으며 여러 요인, 특히 샘플링 전략의 영향을 받을 수 있습니다. 이 방법은 범위 데이터의 일정 비율만 엄격하게 샘플링할 때 가장 효과적입니다. 그러나 예를 들어 오류를 나타내는 범위만 샘플링하는 경우 세그먼트 분석이 왜곡될 수 있습니다.

데이터베이스

데이터베이스 페이지는 서비스의 데이터베이스 클라이언트 작업과 관련된 문제를 식별하고 분석하기 위한 도구를 제공합니다.

OpenTelemetry 측정, 로그는 데이터베이스 의미 체계 규칙을 사용하여 데이터베이스에 대한 호출을 나타냅니다.

데이터베이스 페이지를 구동하는 뉴렐릭 지표는 apm.service.datastore.operation.duration 지표입니다. OpenTelemetry 데이터에서 어떻게 파생되는지에 대한 자세한 내용은 해당 내용을 참조하세요.

발신자의 시간 소비

특정 데이터베이스 호출을 클릭하면 "호출자별 시간 소모" 차트가 표시됩니다. 이 차트는 apm.service.transaction.overview 메트릭에 의해 구동됩니다. 이는 거래 페이지의 세그먼트 분석 보기를 구동하는 것과 동일한 지표이며, 스팬 데이터에서 파생됩니다.

중요

OpenTelemetry의 데이터베이스 의미 규칙은 최근 안정적인 것으로 간주되었습니다. 아직은 안정적인 측정값, 측정항목이 많이 존재하지 않으며, 존재하는 측정측정 리소스는 측정 범위 데이터만 내보내고 지표 데이터는 내보내지 않는 경우가 많습니다.

따라서 아직 안정적인 의미 규칙을 채택하지 않은 측정, 물리학을 사용하는 경우 데이터베이스 페이지를 구동하는 APM 지표는 범위 데이터에서 파생됩니다.

안정적인 측정량을 사용할 수 있게 되고 이를 채택하면 데이터베이스 페이지에서 OpenTelemetry 지표 데이터를 활용하기 시작합니다. 귀하의 언어로 안정적인 데이터베이스 측정, 소스의 가용성에 관해 OpenTelemetry 커뮤니티에 문의하세요.

외부 서비스

외부 서비스 페이지는 호출하는 곳(상류 서비스)과 호출되는 곳(하류 서비스)을 포함하여 서비스의 외부 호출과 관련된 문제를 식별하고 분석하기 위한 도구를 제공합니다.

OpenTelemetry 측정, 계측은 HTTPRPC 의미 규칙을 사용하여 외부 서비스에 대한 호출을 나타냅니다.

데이터베이스 페이지를 구동하는 뉴렐릭 지표는 apm.service.external.host.duration 지표입니다. OpenTelemetry 데이터에서 어떻게 파생되는지에 대한 자세한 내용은 해당 내용을 참조하세요.

발신자의 시간 소비

특정 외부 통화를 클릭하면 "발신자별 시간 소모" 차트가 표시됩니다. 이 차트는 apm.service.transaction.overview 메트릭에 의해 구동됩니다. 이는 거래 페이지의 세그먼트 분석 보기를 구동하는 것과 동일한 지표이며, 스팬 데이터에서 파생됩니다.

JVM 런타임

JVM 런타임 페이지는 서비스의 JVM 에 대한 문제를 식별하고 분석하기 위한 도구를 제공합니다. 이 페이지는 OpenTelemetry 를 사용하는 서비스에만 표시됩니다. 여러 서비스 인스턴스를 구별하기 위해 해당 페이지에서는 service.instance.id 리소스 속성을 설정해야 합니다(자세한 내용은 서비스 참조).

JVM 런타임 페이지에는 JVM 런타임 지표와 함께 황금 신호가 표시되어 런타임 문제와 서비스 사용량의 상관 관계를 보여줍니다.

쿼리는 데이터가 JVM 메트릭 의미 규칙을 따른다고 가정합니다. 참고로, 이러한 규칙은 OpenTelemetry 측 에이전트와 함께 자동으로 포함되는OpenTelemetry OpenTelemetry 런타임 에 구현됩니다.

Go 런타임

Go 런타임 페이지는 Go 서비스 런타임과 관련된 문제를 식별하고 분석하는 도구를 제공합니다. 이 페이지는 OpenTelemetry Go를 사용하는 서비스에 대해서만 표시됩니다. 서로 다른 서비스 인스턴스를 구별하기 위해 해당 페이지에서 service.instance.id 리소스 속성을 설정해야 합니다(자세한 내용은 서비스 참조).

Go 런타임 페이지에는 Go 런타임 지표와 함께 황금 아이콘이 표시되어 런타임 문제와 서비스 사용량의 상관관계를 보여줍니다.

쿼리는 데이터가 OpenTelemetry Go 런타임 측정, 리소스 저장소 에 의해 생성된다고 가정합니다. 참고로, 현재 Go 런타임 메트릭에 대한 의미 규칙은 없습니다.

로그

로그 페이지는 문제를 식별하고 서비스 로그를 분석하는 도구를 제공합니다. 자세한 내용은 로그 UI 사용을 참조하세요.

오류 받은편지함

에러 인박스(errors inbox) 페이지는 서비스의 오류를 탐지하고 분류하는 도구를 제공합니다. 자세한 내용은 에러스 인박스(errors inbox) 시작하기를 참조하세요.

무스 인박스(errors inbox) 페이지는 트레이스 데이터를 기반으로 운영됩니다. 골든 사인 과 마찬가지로 스팬 상태가 ERROR (예: otel.status_code = ERROR)으로 설정된 경우 스팬은 오류로 분류됩니다.

오류 범위는 UUID, 16진수 값, 이메일 주소 등과 같은 식별 값을 정규화하여 오류 지문인 컴퓨트별로 그룹화됩니다. 각각의 고유한 오류 범위는 오류 그룹 내의 개별 인스턴스입니다. 오류 그룹 메시지는 다음과 같이 결정됩니다.

  • 스팬 상태 설명(예: otel.status_description)
  • rpc.grpc.status_code RPC span 의미 규칙에서
  • http.status_code HTTP span 의미 규칙에서
  • http.response.status_code HTTP span 의미 규칙에서
  • undefined 위의 항목 중 어느 것도 존재하지 않는 경우

Span View (구형)

과거 OpenTelemetry 리소스화된 서비스는 뉴렐릭의 언어 에이전트와는 완전히 다른 사용자 경험을 제공했습니다. 이전 경험에서는 스팬 데이터를 기반으로 큐레이팅된 차트를 제공했습니다. 스팬 데이터는 일반적으로 샘플링되므로 특히 처리량과 같은 항목을 표현할 때 오해의 소지가 있습니다.

지금은 Span View(구형) 페이지를 통해 이전 사용자 환경을 계속 사용할 수 있습니다. 맨 위에는 요약, 거래, 데이터베이스, 외부 서비스라는 4개의 탭이 있습니다. 이 탭의 모든 차트는 스팬 데이터를 기반으로 합니다.

구형 Span 기반 뷰

이전의 OpenTelemetry APM 환경에서는 메트릭과 스팬 관점 모두에서 데이터를 볼 수 있었습니다. 일반적으로 스팬 데이터는 샘플링되므로, 메트릭은 더 정확한 처리량 및 응답 시간 측정값을 제공합니다. 스팬 기반 뷰는 여전히 사용할 수 있지만 단계적으로 폐지됩니다. 자세한 내용은 Span View(구형)를 참조하세요.

뉴렐릭 스팬 데이터에서 파생된 APM 지표

APM 경험을 주도하는 뉴렐릭 APM 지표는 일반적으로 지표 데이터에서 파생됩니다. 그러나 APM Maxim이 스팬 데이터에서 파생되는 몇 가지 시나리오가 있습니다. 다음 시나리오에서는 사용하는 샘플링 전략이 생성되는 지표에 영향을 미친다는 점에 유의하세요.

세그먼트 분류

거래 세그먼트 분석 보기는 스팬 데이터에서 생성됩니다. 자세한 내용은 세그먼트 분류를 참조하세요.

데이터베이스 호출

OpenTelemetry 데이터베이스 의미 규칙은 최근 안정적이라고 선언되었습니다. 그러나 대부분의 데이터베이스 측정, 로그는 아직 안정적인 규칙을 채택하지 않았으며 지표 데이터를 내보내지 않습니다. 따라서 이전 측정값을 사용할 때 데이터베이스 페이지를 구동하는 지표는 범위 데이터에서 생성됩니다. 해당 언어에 대한 최신 안정적 데이터베이스 측정, 계측 버전이 출시되면 즉시 업그레이드하는 것이 좋습니다.

메시징 시스템

OpenTelemetry 메시징 의미 규칙은 아직 개발 중입니다. 대부분의 메시징 측정, 로그는 아직 지표 데이터를 내보내지 않습니다. 뉴렐릭은 비 웹 프로세서로서 메시징 시스템과의 상호 작용을 나타냅니다. 자세한 내용은 OpenTelemetry 데이터에서 거래가 파생되는 방식을 참조하세요.

OpenTelemetry 루비

OpenTelemetry 현재 대부분 언어에 대한 지표를 지원하지만, 루비는 주목할 만한 예외입니다. 루비의 경우, 우리는 스팬 데이터로부터 뉴렐릭 APM 지표를 생성하기 위해 최선의 노력을 기울입니다.

APM 서비스 메트릭

apm.service.* 지표는 뉴렐릭의 APM 경험을 주도합니다. 다음 섹션에서는 apm.service.* 메트릭을 도출하는 데 사용되는 소스 OpenTelemetry 데이터를 설명합니다.

메트릭 리소스 속성

다음 리소스 속성은 소스 데이터에서 APM 메트릭으로 복사됩니다.

  • container.id
  • entity.guid
  • host.name
  • instrumentation.provider
  • k8s.cluster.name
  • k8s.container.name
  • k8s.namespace.name
  • k8s.pod.name
  • service.instance.id
  • service.name

측정항목: apm.service.transaction.duration

이름

리치하다(Type)

단위(UCUM)

설명

apm.service.transaction.duration

분포

s, ms, ns [1]

거래 기간. [2]

기인하다

유형

설명

예시

transactionName

string

거래의 이름.

WebTransaction/server/GET /users/:id, OtherTransaction/consumer/unknown

transactionType

string

거래 유형.

Web, Other

error.type

string

거래가 종료된 오류 유형을 설명합니다.

500, TimeoutException

[1]: 소스 메트릭의 단위가 복사됩니다.

[2]: error.type null이 아닌 것으로 확인되면 apm.service.error.count 해당 소스 데이터 개수만큼 증가합니다.

메트릭 소스

의미적 규칙

측정항목 이름

정황

transactionName

transactionType

error.type

OtelHttpServer1_23

http.server.request.duration

http.request.method IS NOT NULL

WebTransaction/server/${http.request.method} ${http.route}

Web

${error.type}

OtelHttpServer1_20

http.server.duration

http.method IS NOT NULL

WebTransaction/server/${http.method} ${http.route}

Web

__http_error_status_code_or_null__

OtelRpcServer1_20

rpc.server.duration

rpc.system IS NOT NULL

WebTransaction/server/${rpc.system}/${rpc.service:-unknown}.${rpc.method:-unknown}

Web

__rpc_error_status_code_or_null__

측정항목: apm.service.transaction.overview

이름

리치하다(Type)

단위(UCUM)

설명

apm.service.transaction.overview

요약

에스

거래의 세그먼트 분석 시간.

기인하다

유형

설명

예시

transactionName

string

거래의 이름.

WebTransaction/server/GET /users/:id, OtherTransaction/consumer/unknown

transactionType

string

거래 유형.

Web, Other

도메인 속성

다양한

db.system, db.sql.table, db.operation 를 포함한 소스 규칙에 따라 달라지는 도메인별 속성 external.host

apm.service.external.host.duration 참조하세요. apm.service.datastore.operation.duration

스팬 소스

의미적 규칙

스팬 종류

정황

transactionName

transactionType

도메인 속성

OtelHttpServer1_23

server

http.request.method IS NOT NULL

WebTransaction/server/${http.request.method} ${http.route}

Web

OtelHttpServer1_20

server

http.method IS NOT NULL

WebTransaction/server/${http.method} ${http.route}

Web

OtelRpcServer1_20

server

rpc.system IS NOT NULL

WebTransaction/server/${rpc.system}/${rpc.service:-unknown}.${rpc.method:-unknown}

Web

OtelMessagingConsumer1_24

consumer

messaging.operation IS NOT NULL

OtherTransaction/consumer/${messaging.operation:-unknown}/${messaging.destination.template:-${messaging.destination.name:-unknown}}

Other

OtelDbClient1_33

internal
client

db.system.name IS NOT NULL

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

db.system: ${db.system.name}
db.sql.table: ${db.stored_procedure.name:-${db.collection.name:-${__db_summary_to_sql_table__}}}
db.operation: ${db.operation.name:-${__db_summary_to_operation__:-unknown}}

OtelDbClientRedis1_24

client

db.system IS NOT NULL
db.system = 'redis'

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

db.system: ${db.system}
db.sql.table: ${db.sql.table}
db.operation: ${db.operation:-${name:-unknown}}

OtelDbClient1_24

client

db.system IS NOT NULL

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

db.system: ${db.system}
db.sql.table: ${db.sql.table}
db.operation: ${db.operation:-unknown}

OtelHttpClient1_23

client

http.request.method IS NOT NULL

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

external.host: ${server.address:-unknown}

OtelHttpClient1_20

client

http.method IS NOT NULL

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

external.host: ${net.peer.name:-unknown}

OtelRpcClient1_20

client

rpc.system IS NOT NULL

transactionName 로컬 루트 스팬의

transactionType 로컬 루트 스팬의

external.host: ${net.peer.name:-unknown}

측정항목: apm.service.external.host.duration

이름

리치하다(Type)

유닛

(유컴)

설명

apm.service.external.host.duration | | |

분포

s, ms, ns [1]

외부 통화 기간.

기인하다

유형

설명

예시

external.host

string

역방향 DNS 조회 없이 사용 가능한 경우 서버 도메인, 그렇지 않은 경우 IP 주소 또는 Unix 도메인 소켓 이름

example.com, 10.1.2.80 , /tmp/my.sock

[1]: 소스 메트릭의 단위가 복사됩니다.

메트릭 소스

의미적 규칙

측정항목 이름

정황

external.host

OtelHttpClient1_23

http.client.request.duration

http.request.method IS NOT NULL

${server.address:-unknown}

OtelHttpClient1_20

http.client.duration

http.method IS NOT NULL

${net.peer.name:-unknown}

OtelRpcClient1_20

rpc.client.duration

rpc.system IS NOT NULL

${net.peer.name:-unknown}

측정항목: apm.service.datastore.operation.duration

이름

리치하다(Type)

단위(UCUM)

설명

apm.service.datastore.operation.duration

분포

s, ms, ns [1]

데이터스토어 통화 지속 시간.

[1]: 소스 메트릭의 단위가 복사됩니다.

기인하다

유형

설명

예시

db.system

string

클라이언트 측정, 리소스로 식별되는 DBMS(데이터베이스 관리 시스템) 제품입니다.

postgresql, mysql , mariadb

db.sql.table

string

데이터베이스 내의 컬렉션(테이블, 컨테이너)의 이름입니다.

public.users, customers

db.operation

string

실행되는 작업이나 명령의 이름입니다.

findAndModify, HMSET , SELECT

db.query.summary

string

데이터베이스 쿼리의 낮은 기수 요약입니다.

SELECT wuser_table, INSERT shipping_details , SELECT order

메트릭 소스

의미적 규칙

측정항목 이름

정황

db.system

db.sql.table

db.operation

db.query.summary

OtelDbClient1_33

db.client.operation.duration

db.system.name IS NOT NULL

${db.system.name}

${db.stored_procedure.name:-${db.collection.name:-${__db_summary_to_sql_table__}}}

${db.operation.name:-${__db_summary_to_operation__:-unknown}}

${db.query.summary}

도우미 기능

도우미 함수는 간단한 속성 참조보다 더 복잡한 속성 매핑 논리의 일부에 대한 참조입니다.

함수

설명

__http_error_status_code_or_null__

문자열 값을 반환합니다. http.status_code if >= 500

__rpc_error_status_code_or_null__

rpc.grpc.status_code의 문자열 값을 반환합니다. 세트에 있는 경우: [2,4,12,13,14,15]

__db_summary_to_operation__

db.query.summary 의 첫 번째 단어를 집합에서 반환합니다(대소문자 구분 없음): [alter,call,create,delete,drop,exec,execute,insert,merge,select,set,update]

__db_summary_to_sql_table__

db.query.summary 의 첫 번째 단어를 반환합니다(세트에 없는 단어). (대소문자 구분 없음): [alter,call,create,delete,drop,exec,execute,insert,merge,select,set,update]

__null__

플레이스홀더 for null

황금 신호

처리율, 응답 시간 및 오류의 황금 신호는 OpenTelemetry APM UI 전체의 여러 위치에 나타납니다. 사용되면 다음과 같이 컴퓨트됩니다.

지표의 경우 쿼리는 데이터가 HTTP 지표 또는 RPC 지표 의미 규칙을 준수한다고 가정합니다.

범위의 경우 쿼리는 일반적이며 최상위 범위 데이터 모델만 활용합니다. 스팬은 WHERE span.kind = server OR span.kind = consumer 의 휴리스틱을 사용하여 컴퓨트 서비스에 대한 루트 항목 스팬인 경우 처리량 및 응답 시간으로 계산됩니다. 상태 코드가 ERROR 인 경우 스팬은 오류입니다(예: otel.status_code = ERROR).

필터를 사용하여 데이터 범위 좁히기

여러 페이지에는 Narrow data to... [데이터 범위 좁히기...] 와 같은 옵션이 있는 필터 표시줄이 포함되어 있습니다. 이를 통해 기준과 일치하도록 페이지의 쿼리를 필터링할 수 있습니다. 예를 들어 service.version='1.2.3-canary'(를) 필터링하여 특정 카나리아 배포로 범위를 좁힐 수 있습니다. 페이지 간을 탐색할 때 필터가 유지됩니다.

골든 메트릭

골든 지표는 HTTP/RPC 지수와 같은 골든 신호 데이터의 낮은 카디널리티 버전입니다. 여기에는 일부분 탐색기, 워크로드 활동 페이지, 추적 세부 정보 변경 페이지 등 다양한 플랫폼 환경이 채워져 있습니다. 이러한 지표는 newrelic.goldenmetrics.ext.service.* 과 같은 이름을 사용합니다.

중요

과거에는 OpenTelemetry 골든 메트릭이 스팬을 기준으로 계산되었습니다. 스팬은 일반적으로 샘플링되므로 부분적인 그림만 제공합니다. 이제 지표가 광범위하게 제공되므로 골든 지표는 스팬 데이터가 아닌 지표 데이터를 사용하여 계산됩니다.

Copyright © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.