Ruby agent release notesRSS

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

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

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

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

profiling.enabled: true

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

PR#3617

기능: Dalli 5.1.1 지원 추가

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

기능: 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

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

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

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

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

기능: 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