• 로그인

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

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

문제 신고

Ruby 맞춤 측정항목

사용자 지정 메트릭을 사용하면 API 호출을 통해 임의의 성능 데이터(예: 타이밍 또는 컴퓨터 리소스 데이터)를 기록할 수 있습니다. 그런 다음 쿼리 빌더 를 사용하여 차트를 만들고 해당 측정항목을 추적합니다. 사용자 지정 메트릭을 사용하여 New Relic 내에서 모니터링을 통합할 수 있습니다.

주의

너무 많은 메트릭을 수집하면 애플리케이션과 New Relic 에이전트의 성능에 영향을 줄 수 있습니다. 데이터 문제를 방지하려면 고유한 사용자 정의 측정항목의 총 수를 2000개 미만으로 유지하십시오.

중요

이 절차는 Rails 버전 7 이상에서 테스트되지 않았습니다.

측정항목 이름 지정

메트릭 이름은 New Relic에서 추적한 특정 데이터 값을 식별합니다. New Relic Ruby 에이전트의 API를 사용하여 사용자 지정 메트릭을 추적할 때 메트릭 이름 지정과 값이 집계되는 방식을 고려하는 것이 중요합니다.

맞춤 측정항목 이름은 접두사 Custom/ , 클래스 또는 카테고리 이름, 레이블로 구성되며 각각 슬래시 표시 / : Custom/<class>/<method> 또는 Custom/<category>/<name> (예: Custom/MyClass/My_method )로 구분됩니다.

맞춤 측정항목 기록

측정항목 데이터를 기록하기 위한 공개 API는 NewRelic::Agent , record_metricincrement_metric 에 대한 두 가지 메서드로 구성됩니다.

record_metricincrement_metric 모두 스레드로부터 안전합니다.

record_metric(metric_name, 값)

record_metric 일반적으로 특정 기간과 관련된 이벤트 기반 메트릭을 기록하는 데 사용해야 합니다. metric_name 은 표준 측정항목 이름 지정 규칙을 따르는 문자열이어야 합니다. value 은 일반적으로 숫자이지만 해시일 수도 있습니다.

value 이 숫자 값인 경우 이벤트와 관련된 측정의 크기(예: 특정 메서드 호출 기간)를 나타내야 합니다.

value 이 해시인 경우 :count , :total , :min , :max:sum_of_squares 키가 모두 숫자 값을 포함해야 합니다. 이 양식은 메트릭을 자체적으로 집계하고 주기적으로(예: 백그라운드 스레드에서) 보고하려는 경우에 유용합니다. 제공된 통계는 동일한 메트릭에 대해 이전에 수집된 값과 함께 집계됩니다. 해시 키의 이름은 플랫폼 API에서 사용하는 키의 이름과 일치하도록 선택되었습니다.

increment_metric(metric_name, amount=1)

increment_metric 단순 카운터 역할을 하는 메트릭을 업데이트하는 데 사용해야 합니다. 선택한 측정항목의 개수가 지정된 양만큼 증가합니다.

맞춤 측정항목의 예

다음은 메트릭을 사용하여 사이트를 통해 흐르는 통화를 추적하는 방법을 보여주는 예입니다.

class Cart
def checkout()
amount = compute_cart_total # computes the amount to charge the customer
::NewRelic::Agent.record_metric('Custom/Cart/charge_amount', amount)
charge_customer(amount)
...
end
end

시간 경과에 따른 데이터 집계 방식에 대한 자세한 내용은 통계 집계 정책 을 참조하십시오.

맞춤 측정항목 보기

이러한 사용자 지정 메트릭을 보려면 쿼리 빌더 를 사용하여 메트릭을 검색하고 사용자 지정 가능한 차트를 만들고 해당 차트를 대시보드에 추가하십시오.

Copyright © 2022 New Relic Inc.

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