중요
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
교차 애플리케이션 추적 측정
호출 애플리케이션의 external 측정값은 항상 호출된 애플리케이션의 internal 측정값보다 큽니다. 외부 측정은 HTTP 클라이언트 라이브러리(예: Net::HTTP)의 뉴렐릭의 측정, 표시에 의해 수집됩니다. 내부 측정은 뉴렐릭의 측정, 웹 프레임워크(예: Rails)라는 기능에 의해 수행됩니다.
다음은 내부 측정에 포함 되지 않은 외부 측정에 포함된 주요 구성 요소입니다.
이러한 구성 요소 중 일부는 다른 구성 요소보다 제어하기가 더 쉽습니다. 예를 들어 위의 Receiving host 항목에 대한 타이밍을 캡처하려면 수신 애플리케이션에 요청 대기열 모니터링이 설정되어 있는지 확인하세요.
분산 추적 가져오기
Ruby 에이전트 버전 8.0.0부터 분산 추적 이 기본적으로 켜져 있습니다. 분산 추적은 애플리케이션 간 추적을 개선한 것으로 대규모 분산 시스템에 권장됩니다.