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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

Ruby 에이전트 API 사용 가이드

New Relic Ruby 에이전트는 GitHub에서 사용할 수 있는 설명서와 함께 공개 API를 제공합니다. GitHub 문서는 Ruby 앱의 사용자 지정 계측을 설정하고 보다 심층적인 데이터를 수집하는 방법을 알려줍니다.

다음 섹션에서는 공통 목표, 솔루션 및 설명서의 관련 부분에 대한 링크를 설명합니다.

중요

Ruby 에이전트 API를 사용할 때 최신 Ruby 에이전트 릴리스가 있는지 확인하십시오. 다음 예제에 사용된 여러 API에는 Ruby 에이전트 버전 4.6.0 이상이 필요합니다.

트랜잭션으로 코드의 누락된 섹션 계측

앱을 계측하기 위해 New Relic은 코드를 통한 각 경로를 자체 트랜잭션 으로 분리합니다. 새 유물 시간(또는 "계측기")은 이러한 트랜잭션의 상위 메서드로 앱의 전체 성능을 측정하고 추가 세부 정보를 위해 장기 실행 트랜잭션에서 트랜잭션 추적 을 수집합니다.

New Relic이 코드의 특정 부분을 전혀 계측하지 않을 때 다음 방법을 사용하십시오.

원하는 경우...

이게 ...

Time method New Relic이 자동으로 계측되지 않음

새 트랜잭션을 만듭니다. 트랜잭션 진입점 추적을 참조하십시오.

단일 메소드 호출 이외의 시간

추적자 API를 사용합니다.

트랜잭션이 New Relic에 보고되는 것을 방지

트랜잭션을 무시 하십시오.

세그먼트를 사용한 시간별 방법

New Relic UI에 트랜잭션이 이미 표시되어 있지만 해당 트랜잭션 중에 호출된 특정 메서드에 대한 데이터가 충분하지 않은 경우 세그먼트를 생성하여 개별 메서드의 시간을 더 자세히 확인할 수 있습니다. 예를 들어 복잡한 논리로 특히 중요한 방법의 시간을 정하고 싶을 수 있습니다.

기존 트랜잭션 내에서 메소드를 계측하려면 다음 메소드를 사용하십시오.

원하는 경우...

이게 ...

특정 방법 시간

메소드 추적자 를 참조하십시오.

단일 메소드 호출 이외의 시간

추적자 API를 사용합니다.

트랜잭션의 메타데이터 향상

때때로 대상으로 하는 코드가 New Relic UI에 표시되지만 메서드의 일부 세부 정보는 유용하지 않습니다. 예를 들어:

New Relic이 New Relic UI에 이미 표시되어 있는 트랜잭션을 계측하는 방법을 변경하려면 다음 방법을 사용하십시오.

원하는 경우...

이게 ...

트랜잭션 이름 변경

트랜잭션 이름 지정 을 참조하십시오.

거래에 메타데이터(예: 고객의 계정 이름 또는 구독 수준)를 추가합니다.

사용자 정의 속성 을 사용하십시오. 사용자 정의 속성 추가 를 참조하십시오.

트랜잭션을 백그라운드 작업으로 표시

사용자 정의 백그라운드 작업 모니터링 을 참조하십시오.

트랜잭션을 웹 트랜잭션으로 표시

:category => :controller 옵션을 set_transaction_name() 에 전달합니다. 자세한 내용은 트랜잭션 이름 지정 을 참조하십시오.

거래가 Apdex 점수 에 영향을 미치지 않도록 방지

Apdex 기여 무시 를 참조하십시오.

관련 로그 보기

애플리케이션의 오류 및 추적 컨텍스트 내에서 직접 로그를 보려면 다음 API 호출을 사용하여 로그에 주석을 추가하십시오.

로그 데이터와 다른 원격 측정 데이터의 상관 관계에 대한 자세한 내용은 컨텍스트 문서의 로그를 참조하세요.

오류 수집 또는 무시

일반적으로 에이전트는 오류를 자동으로 감지합니다. 그러나 에이전트를 사용하여 수동으로 오류를 표시할 수 있습니다. 또한 오류를 무시 또는 예상 으로 표시할 수 있습니다.

원하는 경우...

이게 ...

에이전트가 자동으로 보고하지 않는 오류 보고

새 유물 처리 오류 보내기 를 참조하십시오.

에이전트가 오류를 보고하지 못하도록 방지

오류를 무시된 것으로 표시합니다. error_collector.ignore_errors 구성 옵션을 사용하려면 오류 수집기 를 참조하세요.

오류가 Apdex 또는 오류율에 영향을 미치지 않도록 방지하되 여전히 New Relic에 보고하십시오.

오류를 예상대로 표시하십시오. 새 유물 처리 오류 보내기 를 참조하고 :expectedtrue 로 설정합니다.

앱에서 맞춤 이벤트 및 측정항목 데이터 보내기

APM에는 임의의 사용자 지정 데이터를 기록하는 여러 방법이 포함되어 있습니다. New Relic 데이터 유형에 대한 설명은 데이터 수집 을 참조하십시오.

원하는 경우...

이게 ...

대시보드에서 분석할 수 있도록 이벤트에 대한 데이터 보내기

맞춤 이벤트 를 만듭니다. record_custom_event() 을(를) 참조하세요.

대시보드 또는 오류 분석에서 이벤트를 필터링하고 패싯하기 위해 메타데이터로 이벤트에 태그 지정

사용자 정의 속성 을 추가합니다. 속성의 해시를 record_custom_event() 에 전달합니다.

맞춤 실적 데이터 보고

맞춤 측정항목 을 만듭니다. record_metric() 을(를) 참조하세요.

브라우저 에이전트 제어

일반적으로 에이전트는 페이지에 자동으로 추가되거나 JavaScript 스니펫을 복사하여 붙여넣어 배포됩니다. 이러한 권장 방법에 대한 자세한 내용은 브라우저 모니터링에 앱 추가를 참조하세요. 그러나 APM 에이전트 API 호출을 통해 브라우저 에이전트를 검색할 수도 있습니다. 자세한 내용은 browser_timing_header() 참조하세요.

데이터 저장소에 대한 계측 호출

다음 방법을 사용하여 다른 데이터 저장소에 대한 앱의 연결에 대한 데이터를 수집합니다.

원하는 경우...

이게 ...

New Relic에 의해 자동으로 계측되지 않은 데이터 저장소에 대한 호출 시간 측정

wrap() 을(를) 참조하세요.

Ruby 블록으로 깔끔하게 래핑할 수 없는 데이터 저장소 호출 시간

Tracer.start_datastore_segment() 을(를) 참조하세요. 이 메서드에서 반환된 객체에 대해 finish 을 호출 해야 합니다 .

타이밍과 함께 SQL 쿼리 캡처

notice_sql() 을(를) 참조하세요.

타이밍과 함께 비 SQL 쿼리 캡처

notice_statement() 을(를) 참조하세요.

외부에 대한 기기 호출

다음 방법을 사용하여 외부 요청에 대한 데이터를 수집합니다.

원하는 경우...

이게 ...

New Relic에 의해 자동으로 계측되지 않은 외부 요청에 대한 호출 시간 측정

Tracer.start_external_segment() 을(를) 사용합니다. 이 메서드에서 반환된 객체에 대해 finish 을 호출 해야 합니다 .

아웃바운드 HTTP 요청에 CAT(교차 애플리케이션 추적) 헤더 추가

add_request_headers() 을(를) 사용합니다.

인바운드 HTTP 요청에서 CAT 헤더 읽기

read_response_headers() 을(를) 사용합니다.

아웃바운드 요청에서 CAT 정보를 전송하기 위해 난독화된 문자열 생성

get_request_metadata() 을(를) 사용합니다.

인바운드 요청에서 받은 CAT 정보가 포함된 난독화된 문자열 처리

process_response_metadata() 을(를) 사용합니다.

분산 추적을 위한 계측기 호출

중요

다음 API 예시는 Ruby 에이전트 버전 6.9.0 이상이 필요합니다.

이러한 API 를 사용하려면 분산 추적 이 필요합니다.

분산 추적을 사용하면 분산 시스템을 통해 이동하는 요청의 경로를 볼 수 있습니다.

아래 호출을 사용하여 분산 추적을 구현하는 방법에 대한 일반적인 지침은 분산 추적 API 사용 을 참조하세요.

원하는 경우...

이게 ...

호출된 서비스에 페이로드/헤더를 보냅니다.

insert_distributed_trace_headers() 을(를) 참조하세요.

추적에서 이러한 서비스를 함께 연결할 첫 번째 서비스에서 수신된 페이로드/헤더를 수락합니다.

accept_distributed_trace_headers() 을(를) 참조하세요.

Copyright © 2024 New Relic Inc.

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