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

Ruby agent release notesRSS

October 6
Ruby agent v10.9.1

중요

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법 에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 루비 에이전트 EOL 정책을 참조하세요.

v10.9.1

  • 버그 수정: Action Controller 계측은 컨트롤러 클래스를 식별할 수 없을 때 더 이상 오류를 발생시키지 않습니다.

    에이전트가 요청의 컨트롤러 클래스를 식별할 수 없는 경우, TypeError: no implicit conversion of nil into String을(를) 로그에 기록한 다음 NoMethodError: undefined method 'finish' for nil을(를) 기록하고 해당 요청에 대한 데이터를 기록하지 않았습니다. 이제 이러한 트랜잭션의 이름은 Controller/(unknown)/<action> (으)로 지정되며 정상적으로 기록됩니다. PR#3691

  • 버그 수정: 대용량 페이로드를 보고할 때 Parallel 워커가 멈추는 문제를 방지합니다.

    parallel 계측이 활성화된 경우, in_processes:이(가) 있는 Parallel.each/Parallel.map이(가) 무한정 멈출 수 있었습니다. 각 워커는 에이전트가 이전 형제 프로세스를 위해 등록한 파이프 쓰기 끝을 상속받았기 때문에, 해당 파이프가 파일 끝에 도달할 수 없었고 에이전트의 파이프 리스너 스레드가 그중 하나를 기다리며 차단되었습니다. 데이터가 운영 시스템 파이프 버퍼를 초과하는 모든 워커는 종료 시 차단되었습니다. 이제 에이전트는 포크 직후 상위에서 각 파이프의 쓰기 끝을 닫으며, 다른 파이프에 여전히 대기 중인 데이터가 있는 동안 리스너는 더 이상 단일 파이프에서 차단되지 않습니다. 이 버그를 보고해 주신 @yayamochi 님께 감사드립니다. Issue#3680 PR#3688

  • 버그 수정: 신세틱스 모니터의 requests에서 gRPC 호출이 더 이상 실패하지 않습니다.

    신세틱스 모니터의 요청이 gRPC 호출을 수행할 때 에이전트는 호출의 메타데이터에 X-NewRelic-Synthetics을(를) 추가했습니다. gRPC는 소문자 메타데이터 키만 허용하므로 호출 시 ArgumentError: 'X-NewRelic-Synthetics' is an invalid header key이(가) 발생했습니다. 이제 에이전트는 신세틱스 헤더를 소문자로 보냅니다. gRPC 서버 트랜잭션은 이제 수신되는 메타데이터에서 신세틱스 헤더도 읽으므로, 신세틱 검사 중에 호출된 gRPC 서비스는 해당 트레이스 및 신세틱스 속성을 기록합니다. PR#3693

September 28
Ruby agent v10.9.0

중요

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법 에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 루비 에이전트 EOL 정책을 참조하세요.

v10.9.0

  • 기능: 연속 프로파일링(미리 보기)

    Continuous Profiling은 아직 일반적으로 사용할 수 없는 새로운 기능입니다. 이제 에이전트 측 구성 요소 코드가 에이전트에 존재하지만, 일반 공급 릴리스 전에 실제로 사용하려면 뉴렐릭 영업 담당자에게 문의하여 프리뷰에 미리 참여해야 합니다.

    Continuous Profiling은 실행 중인 애플리케이션의 루비 호출 스택을 반복적으로 샘플링하여 뉴렐릭에 보고하므로, 앱에 코드를 추가하지 않고도 프로덕션 환경에서 어떤 메서드가 가장 많은 CPU 시간을 소비하는지(또는 가장 많은 객체를 할당하는지) 확인할 수 있습니다.

    활성화하려면 애플리케이션의 Gemfile에 stackprof 및 google-protobuf gem을 추가한 다음 profiling.enabled을(를) true(으)로 설정하십시오:

    profiling.enabled: true

    profiling.enabled만 설정된 경우, 에이전트는 프로세스의 수명 동안 10밀리초마다 CPU 시간을 샘플링합니다. 이러한 옵션을 통해 해당 동작을 조정할 수 있습니다:

    설정 이름기본값행동
    profiling.enabledfalsetrue인 경우, 에이전트는 지속적인 프로파일링 데이터를 수집하고 보고합니다.
    profiling.includecpu샘플링할 항목: CPU 시간의 경우 cpu 또는 객체 할당의 경우 object 입니다.
    profiling.sample_period0.01스택 샘플 간의 초 단위 시간입니다. profiling.include이(가) cpu일 때만 사용됩니다. 0.000001~0.999999 사이여야 합니다.
    profiling.object_allocation_interval10000스택 샘플 간의 객체 할당입니다. profiling.include이(가) object일 때만 사용됩니다. 1,000~999,999 사이여야 합니다.
    profiling.delay0프로파일링이 시작되기 전에 대기할 밀리초입니다. 0은(는) 즉시 시작됩니다.
    profiling.duration0자동으로 중지되기 전까지 프로파일링할 밀리초 단위 시간입니다. 0은(는) 프로세스가 종료될 때까지 프로파일링합니다.

    PR#3617

  • 기능: Dalli 5.1.1 지원 추가

    Dalli 5.1.1은 에이전트에 의해 계측된 일부 메서드에 인수를 추가했으며, 이로 인해 다중 키 작업에서 ArgumentError이(가) 발생하거나 요청 옵션이 알림 없이 삭제될 수 있습니다. 이제 에이전트는 이러한 메서드에 대해 가변적인 수의 위치 및 키워드 인수를 수락하고 전달합니다. PR#3683

September 14
Ruby agent v10.8.0

중요

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법 에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 루비 에이전트 EOL 정책을 참조하세요.

v10.8.0

  • 기능: Google Cloud Run 워커 풀 및 작업에 대한 고유한 호스트명을 보고합니다.

    PR#3609에 추가된 Cloud Run 호스트명 지원은 Cloud Run Services에서 설정한 환경 변수인 K_REVISION을(를) 통해서만 Cloud Run을 감지했습니다. 이제 에이전트는 CLOUD_RUN_REVISION (Worker Pools) 및 CLOUD_RUN_EXECUTION (Jobs)도 인식하므로, 이제 utilization.gcp_cloud_run.use_instance_as_host은(는) 세 가지 리소스 유형 모두에 적용됩니다. utilization.gcp_cloud_run.include_revision_in_host이(가) true인 경우, 호스트명은 이러한 변수 중 존재하는 변수를 기반으로 생성됩니다 ― 예를 들어 Job의 경우 {CLOUD_RUN_EXECUTION}-{instance id} 입니다. Issue#3651 PR#3652

  • 기능: browser_monitoring.version 설정 옵션 추가

    이제 고객은 새로운 browser_monitoring.version 설정 옵션을 설정하여 뉴렐릭이 주입하는 정확한 브라우저 에이전트 로더 버전을 고정할 수 있습니다. 현재 사용 가능하고 지원되는 버전은 브라우저 에이전트 EOL 정책을 참조하십시오. PR#3663

  • 기능: 백그라운드 작업 라이브러리에 span.kind 추가

    이제 백그라운드 작업 라이브러리의 produce 및 consume 작업에 span.kind 속성이 추가됩니다. 여기에는 ActiveJob, Sidekiq, Resque 및 DelayedJob이 포함됩니다. PR#3636

  • 버그 수정: prepend 모드에서 DelayedJob 계측이 더 이상 모든 워커에 자체적으로 재설치되지 않습니다.

    prepend(기본값)를 통해 DelayedJob 계측이 설치된 경우, 동일한 프로세스에서 두 개 이상의 Delayed::Worker을(를) 생성하면 에이전트가 "Installing DelayedJob instrumentation"을 로그에 기록하고 추가 작업자마다 플러그인을 다시 초기화했습니다. 이는 무해하지만 노이즈가 많았으며, 이제 기존 체인 계측 동작과 일치하도록 프로세스당 한 번만 수행됩니다. PR#3654

  • 버그 수정: 허용 목록의 설정 값은 더 이상 대소문자를 구분하지 않습니다

    이전에는 허용 목록에 지정된 설정 옵션에 정확한 대소문자 일치가 필요했으므로, 예상치 못한 대소문자가 포함된 값 — 예를 들어 slow_sql.record_sql에 대한 OBFUSCATED 또는 ObFuScAtEd — 은 조용히 기본값으로 대체되었습니다. 이제 허용 목록을 기준으로 유효성을 검사하는 설정 옵션은 대소문자에 관계없이 값과 일치하므로, 두 값 모두 obfuscated과(와) 동일하게 처리됩니다. 이슈#3613 PR#3645

  • 버그 수정: Puma가 지연 로드될 때 Puma 계측이 작동합니다.

    gem "puma", require: false의 경우, 에이전트의 의존성 검사가 실행될 때 Puma가 아직 로드되지 않아 Puma 계측 설치에 실패했습니다. 이제 에이전트는 Puma::RackHandler을(를) Puma가 존재한다는 증거로 인식하여 이 문제를 해결합니다. Issue#3641 PR#3650

August 20
Ruby agent v10.7.1

중요

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법 에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 루비 에이전트 EOL 정책을 참조하세요.

v10.7.1

  • 버그 수정: Dalli 5.1.0을 사용한 다중 키 작업에서 ArgumentError 해결

    이 수정 사항은 다중 및 파이프라인 작업에서 선택적 요청 옵션 인수를 수락하고 전달하도록 Dalli 계측을 업데이트합니다. 수정 사항을 기여해 주신 @dbackeus 님께 감사드립니다! PR#3642

  • 버그 수정: 세그먼트가 시작되지 않을 때 Async::HTTP requests가 더 이상 NoMethodError을(를) 발생시키지 않음

    에이전트가 Async::HTTP 요청에 대한 세그먼트를 생성하는 동안 내부 오류가 발생한 경우, 계측은 해당 누락된 세그먼트를 계속 사용하여 NoMethodError을(를) 발생시킬 수 있었습니다. @ydah 님 덕분에 이제 이 문제가 수정되었습니다. PR#3640

August 6
Ruby agent v10.7.0

중요

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법 에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 루비 에이전트 EOL 정책을 참조하세요.

v10.7.0

  • 기능: transaction_tracer.cap_segment_artifacts 구성 옵션 추가

    세그먼트가 많은 장기 실행 트랜잭션은 트랜잭션의 수명 동안 메모리 사용량을 지속적으로 증가시킬 수 있습니다. 이제 에이전트는 옵트인 transaction_tracer.cap_segment_artifacts 설정 옵션을 제공합니다(기본값은 false입니다). 활성화된 경우, transaction_tracer.limit_segments 에 도달하면 에이전트는 해당 트랜잭션에서 이후에 생성된 모든 세그먼트에 대한 독점 시간 기록도 중지하여 트랜잭션에 대한 타이밍 데이터의 정확도를 낮추는 대신 메모리 사용량을 줄입니다. PR#3615

  • 기능: Puma 서버 통계 계측 추가

    이제 에이전트는 Puma의 클러스터 전체 서버 통계를 샘플링하고 이를 backlog, running, pool_capacity, max_threads 및 requests_count를 포함한 Ruby/Puma/* 타임슬라이스 메트릭으로 보고합니다. 통계는 단일 모드에서, 그리고 preload_app! 이(가) 활성화된 경우 클러스터 모드에서 샘플링됩니다. 이 계측은 기본적으로 비활성화되어 있습니다. disable_puma_instrumentation 을(를) false(으)로 설정하여 활성화하십시오. 활성화되면 에이전트는 이러한 메트릭을 전달하기 위해 Puma 마스터 프로세스에서 보고 스레드를 시작하며, 이는 Puma 워커와 함께 추가 에이전트 연결을 실행합니다. 샘플링 간격은 새로운 puma.sample_rate 설정을 통해 구성할 수 있습니다(기본값 60초). Puma 6.6 이상이 필요합니다. 자세한 내용은 문서 를 참조하십시오. PR#3578

  • 기능: Google Cloud Run 인스턴스에 대한 고유 호스트명 보고

    이제 에이전트가 Cloud Run을 감지하고 개별 인스턴스를 구분할 수 있도록 GCP 인스턴스 ID를 호스트명으로 보고합니다. 이 변경 이전에는 모든 Google Cloud Run 호스트명이 localhost이었습니다. 이 기능은 새로운 utilization.gcp_cloud_run.use_instance_as_host 설정 옵션(기본값 true)에 의해 제어됩니다. 대신 호스트명을 {K_REVISION}-{instance id} (으)로 보고하려면 utilization.gcp_cloud_run.include_revision_in_host (기본값 false)을(를) true (으)로 설정하십시오. 여기서 K_REVISION 은(는) Cloud Run 리비전 이름입니다. Issue#3295 PR#3609

  • 버그 수정: transaction_tracer.limit_segments 초과되었습니다

    트랜잭션이 transaction_tracer.limit_segments을(를) 초과한 후에도, 이후에 생성된 데이터스토어 세그먼트에 느린 SQL이 여전히 기록될 수 있었습니다. 이제 에이전트는 한도에 도달한 후 생성된 모든 세그먼트에 대해 느린 SQL 기록을 중지합니다. PR#3615

  • 버그 수정: 다중 데이터베이스 Rails 앱에서 실행 계획이 잘못된 데이터베이스를 타겟으로 할 수 있는 문제 (Rails>=7.2)

    Rails 7.2+에서 에이전트는 전용 연결 대신 앱의 기본/공유 풀의 연결을 사용하여 실행 계획을 수집했습니다. 이는 주로 다중 데이터베이스 앱에 영향을 미쳤습니다. 잘못된 데이터베이스에 대해 실행 계획이 생성될 수 있었으며, 실행 계획이 실패하면 공유 연결이 잘못된 상태로 남아 관련 없는 requests에 영향을 미칠 수 있었습니다. 이제 에이전트는 Rails 7.2 이전과 마찬가지로 실행 계획에 자체 전용 연결을 사용하며, 실행 계획 시도가 실패할 때마다 해당 연결을 재설정하거나 폐기하여 잘못된 연결이 재사용되지 않도록 합니다. Issue#3610 PR#3612

  • 버그 수정: 브라우저 모니터링 계측이 더 이상 다음으로 인해 실패하지 않습니다. FrozenError

    응답 본문의 첫 번째 조각이 고정된 String 이고 여러 조각이 있는 경우, 브라우저 계측에서 FrozenError 이(가) 발생하여 브라우저 타이밍 헤더가 주입되지 않았습니다. 이 현상은 컴파일된 문자열을 더 많이 고정하기 시작한 ERB 6.0.3+부터 나타나기 시작했습니다. 이제 이 문제가 수정되었습니다. Issue#3624 PR#3625

  • 버그 수정: 모든 대소문자를 허용하도록 부울 설정 값 정규화

    버전 9.x에서 에이전트는 "FALSE"와 같은 대문자 부울 값과 "True"와 같은 대소문자가 혼합된 값을 허용했습니다. 버전 10.0.0에는 대소문자를 구분하지 않는 요구 사항을 의도치 않게 제거한 PR#3341이 포함되었습니다. 이로 인해 모두 소문자가 아닌 다른 대소문자를 사용한 사용자는 설정 옵션이 기본값으로 대체되었습니다. 이제 에이전트는 다시 대소문자를 구분하지 않는 검사를 사용합니다. Issue#3632 PR#3633

Copyright © 2026 New Relic Inc.

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