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

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

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

문제 신고

Ruby 에이전트 8.x에서 9.x로 마이그레이션 가이드

마이그레이션할 준비가 되면 Ruby 에이전트의 8.x 및 9.x 시리즈 간의 주요 변경 사항을 검토하십시오. 또한 버전 9.x로 성공적으로 마이그레이션할 수 있도록 업그레이드하는 동안 발생할 수 있는 문제에 대해서도 알아봅니다.

요약

주요 변경 사항은 다음과 같습니다.

자세한 내용은 9.0의 이정표를 참조하십시오.

더 이상 사용되지 않는 구성 제거됨

다음 구성 옵션을 제거했으므로 더 이상 작동하지 않습니다. 아래 나열된 대체 항목을 사용하려면 모든 구성을 업데이트하고 자세한 내용은 구성 설명서를 참조하십시오.

제거됨

바꿔 놓음

newrelic.yml 예시

analytics_events.capture_attributes

transaction_events.attributes.enabled

transaction_events.attributes.enabled: false

browser_monitoring.capture_attributes

browser_monitoring.attributes.enabled

browser_monitoring.attributes.enabled: false

error_collector.capture_attributes

error_collector.attributes.enabled

error_collector.attributes.enabled: false

resque.capture_params

attributes.include

attributes.include: ['job.resque.args.*']

sidekiq.capture_params

attributes.include

attributes.include: ['job.sidekiq.args.*']

transaction_tracer.capture_attributes

transaction_tracer.attributes.enabled

transaction_tracer.attributes.enabled: false

error_collector.ignore_errors

error_collector.ignore_classes

error_collector.ignore_classes: ['ActionController::RoutingError', 'CustomError']

analytics_events.enabled

transaction_events.enabled

transaction_events.enabled: false

analytics_events.max_samples_stored

transaction_events.max_samples_stored

transaction_events.max_samples_stored: 1200

disable_database_instrumentation

disable_sequel_instrumentation

disable_sequel_instrumentation: true

disable_bunny

instrumentation.bunny

instrumentation.bunny: disabled

disable_curb

instrumentation.curb

instrumentation.curb: disabled

disable_dj

instrumentation.delayed_job

instrumentation.delayed_job: disabled

disable_excon

instrumentation.excon

instrumentation.excon: disabled

disable_grape

instrumentation.grape

instrumentation.grape: disabled

disable_grape_instrumentation

instrumentation.grape

instrumentation.grape: disabled

disable_httpclient

instrumentation.httpclient

instrumentation.httpcient: disabled

disable_httprb

instrumentation.httprb

instrumentation.httprb: disabled

disable_dalli

instrumentation.memcache

instrumentation.memcache: disabled

disable_dalli_cas_client

instrumentation.memcache

instrumentation.memcache: disabled

disable_memcache_client

instrumentation.memcache-client

instrumentation.memcache-client: disabled

disable_memcache_instrumentation

instrumentation.memcache

instrumentation.memcache: disabled

disable_memcached

instrumentation.memcached

instrumentation.memcached: disabled

disable_mongo

instrumentation.mongo

instrumentation.mongo: disabled

disable_net_http

instrumentation.net_http

instrumentation.net_http: disabled

prepend_net_instrumentation

instrumentation.net_http

instrumentation.net_http: prepend

disable_puma_rack

instrumentation.puma_rack

instrumentation.puma_rack: disabled

disable_puma_rack_urlmap

instrumentation.puma_rack_urlmap

instrumentation.puma_rack_urlmap: disabled

disable_rack

instrumentation.rack

instrumentation.rack: disabled

disable_rack_urlmap

instrumentation.rack_urlmap

instrumentation.rack_urlmap: disabled

disable_redis

instrumentation.redis

instrumentation.redis: disabled

disable_redis_instrumentation

instrumentation.redis

instrumentation.redis: disabled

disable_resque

instrumentation.resque

instrumentation.resque: disabled

disable_sinatra

instrumentation.sinatra

instrumentation.sinatra: disabled

disable_rake

instrumentation.rake

instrumentation.rake: disabled

disable_rake_instrumentation

instrumentation.rake

instrumentation.rake: disabled

disable_typhoeus

instrumentation.typhoeus

instrumentation.typhoeus: disabled

Ruby 2.2 및 2.3에 대한 지원 제거

Ruby 2.2 및 2.3은 Ruby 에이전트에서 더 이상 지원되지 않습니다. 최신 Ruby 에이전트 버전을 계속 사용하려면 Ruby 2.4.0 이상으로 업데이트하십시오.

New Relic은 Ruby 언어 개발 팀(Ruby 팀)에서 제공하는 공식적으로 지원되는 유지 관리 기간을 벗어난 후에도 특정 이전 Ruby 버전을 계속 지원합니다. 예를 들어 2023년 3월 31일 현재 Ruby 팀에서 지원하는 가장 오래된 Ruby 버전은 버전 3.0이지만 Ruby 에이전트 버전 9.0에서는 Ruby 버전 2.4 이상이 계속 지원됩니다. Ruby 버전의 공식 Ruby 팀 지원에 대한 자세한 내용은 Ruby 유지 관리 분기를참조하십시오.

기본적으로 활성화된 스레드 추적

이제 구성 옵션 instrumentation.thread.tracing 이 기본적으로 활성화됩니다. 이 구성을 통해 에이전트는 스레드 내부에서 발생하는 코드를 감시할 수 있습니다. Ruby 에이전트 9.0은 스레드 내에서 계측된 코드를 기록하고 이를 현재 트랜잭션과 연결합니다.

현재 사용자 정의 스레드 계측을 사용 중인 경우 이는 주요 변경 사항일 수 있습니다. 스레드 내부의 새 트랜잭션은 이미 존재하는 경우 더 이상 시작되지 않습니다.

이전 UI를 사용하는 경우 거래 차트에 "#" 세그먼트가 표시될 수 있습니다. 세그먼트 테이블을 보면 전체 이름은 "Thread: #"입니다. 이러한 세그먼트는 스레드 계측을 참조합니다. 자세한 내용은 Issue#1859를 참조하십시오.

더 이상 사용되지 않는 계측 제거

다음 계측된 gem은 이전에 사용되지 않았으며 이제 더 이상 지원되지 않습니다.

  • Solr 역할

  • 오솔로직

  • 데이터매퍼

  • 무지개

  • 흑점

    다음 기술의 버전은 이전에 사용되지 않았으며 더 이상 지원되지 않습니다.

  • 승객: 2.2.x - 4.0.x

  • 푸마: 2.0.x

  • 포도: 0.2.0

  • 파드리노: 0.14.x

  • 레일: 3.2.x

  • 시나트라: 1.4.x, 1.5.x

  • 몽고: 1.8.x - 2.3.x

  • 속편: 3.37.x, 4.0.x

  • Delayed_Job: 2.0.x - 4.0.x

  • 사이드키크: 4.2.x

  • 엑스콘: 0.55.0 이하

  • Http클라이언트: 2.2.0 - 2.8.0

  • HttpRb: 0.9.9 - 2.2.1

  • 장티푸스: 0.5.3 - 1.2.x

  • 토끼: 2.0.x - 2.6.x

  • 활성 판매자: 1.25.0 - 1.64.x

업데이트된 API 방법 set_transaction_name

NewRelic::Agent.set_transaction_name 메서드가 호출되면 이제 항상 현재 실행 중인 트랜잭션의 이름과 범주를 메서드에 전달된 항목으로 변경합니다. 이것은 이전 에이전트 버전에서 변경된 사항입니다.

이전에는 새 트랜잭션 이름 및 트랜잭션에 이미 할당된 범주와 일치하지 않는 새 범주로 set_transaction_name 를 호출하면 새 이름이나 범주가 모두 트랜잭션에 저장되지 않았습니다.

이전에는 카테고리 차이로 인해 무시되었던 상황에서 이 메소드가 호출되면 이제 트랜잭션의 이름과 카테고리가 변경됩니다.

제거된 API 메서드

더 이상 사용되지 않는 API 메소드 NewRelic::Agent.disable_transaction_tracing 이(가) 제거되었습니다. 대신 NewRelic::Agent#ignore_transaction 사용하여 현재 트랜잭션의 기록을 비활성화하거나 NewRelic::Agent.disable_all_tracing 사용하여 후속 호출에서 메트릭이나 추적을 수집하지 않고 블록을 생성합니다.

Copyright © 2024 New Relic Inc.

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