중요
Ruby 에이전트 버전 8.0.0부터 분산 추적 이 기본적으로 켜져 있습니다. 분산 추적은 애플리케이션 간 추적을 개선하며 대규모 분산 시스템에 권장됩니다.
분산 추적을 위해 교차 애플리케이션 추적은 더 이상 사용되지 않습니다. 비표준 미들웨어 프레임워크와 같이 교차 애플리케이션 추적을 계속 사용해야 하는 경우 이 문서의 구성 정보 를 참조하십시오.
요구 사항
Ruby 에이전트에서 애플리케이션 간 추적을 사용하려면 다음 요구 사항을 따르십시오.
- 계측 중인 요청이 지원되는 HTTP 클라이언트 라이브러리 를 사용하는지 확인하십시오.
- 최신 Ruby 에이전트 (버전 3.5.5.38 이상)를 설치하거나 업데이트합니다.
- 미들웨어 설치 요구 사항을 따르십시오.
미들웨어 설치
교차 애플리케이션 추적은 Rack과 함께 작동하므로 Rails 2.3 이상 또는 다른 호환 가능한 프레임워크가 필요합니다.
- Rails를 사용하면 Ruby 에이전트가 자동으로 미들웨어를 설치합니다.
- 다른 랙 기반 프레임워크를 사용하는 경우 스택에
NewRelic::Rack::AgentHooks
미들웨어를 수동으로 추가합니다.
구성
교차 애플리케이션 추적은 구성 플래그로 제어할 수 있습니다. Ruby 에이전트 버전 8.0.0부터 cross_application_tracer.enabled
의 기본값은 지정되지 않은 경우에도 false
입니다. 교차 애플리케이션 추적을 활성화하려면 이 플래그를 true
로 설정하고 distributed_tracing.enabled
을 false
로 설정해야 합니다.
cross_application_tracer: enabled: truedistributed_tracing: enabled: false
8.0.0 미만 버전의 경우 다음 설정을 사용하여 교차 응용 프로그램을 구성할 수 있습니다.
cross_application_tracer: enabled: true
교차 애플리케이션 추적 측정
외부 측정(호출 응용 프로그램의)은 항상 내부 측정(호출 응용 프로그램의)보다 큽니다. 외부 측정은 HTTP 클라이언트 라이브러리(예: Net::HTTP)에 대한 New Relic의 계측에 의해 수집됩니다. 내부 측정은 호출된 애플리케이션에서 웹 프레임워크(예: Rails)에 대한 New Relic의 계측에 의해 수행됩니다.
다음은 내부 측정에 포함 되지 않은 외부 측정에 포함된 주요 구성 요소입니다.
이러한 구성 요소 중 일부는 다른 구성 요소보다 제어하기 쉽습니다. 예를 들어, 위의 수신 호스트 항목에 대한 타이밍을 캡처하려면 수신 응용 프로그램에 요청 대기열 모니터링 이 설정되어 있는지 확인하십시오.
분산 추적 가져오기
Ruby 에이전트 버전 8.0.0부터 분산 추적 이 기본적으로 켜져 있습니다. 분산 추적은 애플리케이션 간 추적을 개선한 것으로 대규모 분산 시스템에 권장됩니다.