Ruby agent release notesRSS

Feature: Add support for forking processes in Parallel gem instrumentation

Parallel gem instrumentation has been added to allow more consistent monitoring in processes forked using the Parallel gem. PR#3405

Feature: Add support for Grape v3.1.0

Grape's release of v3.1.0 introduced changes that were incompatible with the agent's instrumentation, causing issues when collecting transaction names. The agent has been updated to properly extract class names for transaction naming in the updated Grape API structure. PR#3413

Bugfix: Create health check files in forked processes

The agent now properly initializes health check loops after forking, ensuring each process generates its own health check file. This fix also has the effect of correctly including entity.guid values in the health check files. PR#3409 Issue#3408

Bugfix: Fix sidekiq.ignore_retry_errors

The configuration option sidekiq.ignore_retry_errors: true was continuing to report retry errors. The agent now correctly ignores retry errors and only reports when jobs permanently fail. PR#3399

호환성 파괴 변경 사항: 루비 2.4 및 2.5 버전에 대한 지원을 제거합니다.

루비 버전 2.4 및 2.5에 대한 지원이 제거되었습니다. 새로운 최소 요구 루비 버전은 2.6입니다. PR#3314

획기적인 변화: CAT(Standing Tracing) 제거

이전에는 CAT(강력한 추적)가 더 이상 사용되지 않고 대신 추적되었습니다. CAT 기능이 제거되었습니다. 설정 옵션 cross_application_tracer.enabled 이 제거되었습니다. 공개 API 메서드 NewRelic::Agent::External.process_request_metadata, NewRelic::Agent::External.get_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#process_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#get_request_metadata 및 NewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headers 도 제거되었습니다. PR#3333

주요 변경 사항: ActiveJob 메트릭 및 세그먼트 이름 변경

ActiveJob 메트릭이 업데이트되어 보다 구체적인 보고를 위해 작업 클래스 이름이 포함되었습니다. 이는 주요 변경 사항이므로 사용자 정의 대시보드 또는 알림을 업데이트해야 할 수도 있습니다. PR#3370 PR#3320

• 이전 형식: Ruby/ActiveJob/<QueueName>/<Method>
• 새로운 형식: Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

또한, 활성 작업 대기열 작업에 대해 생성된 세그먼트에는 이제 작업 클래스가 포함됩니다.

• 이전 형식: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• 새로운 형식: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

호환성 파괴 변경: bin/newrelic 명령어의 이름을 변경합니다. bin/newrelic_rpm

에이전트 CLI의 실행 파일 이름이 bin/newrelic 에서 bin/newrelic_rpm 로 변경되었습니다. 이번 변경으로 독립 실행형 뉴렐릭 CLI 도구와의 이름 충돌 문제가 해결되었습니다. PR#3323

호환성 파괴 변경: newrelic deployments CLI 명령어를 제거합니다.

더 이상 사용되지 않는 newrelic deployments CLI 명령이 제거되었습니다. 변경 사항 및 구현, 뉴렐릭 배포를 추적하려면 사용 가능한 옵션 목록에 대한 변경 추적 가이드를 참조하세요. PR#3299

호환성 파괴 변경: NewRelic::에이전트::SqlSampler#notice_sql 메서드가 제거되었습니다.

사용자는 NewRelic::Agent::Datastores.notice_sql 대신 호출해야 합니다. PR#3338

호환성 파괴 변경: 다양한 NewRelic::에이전트::Datastores API에서 사용되지 않는 인수를 제거합니다.

NewRelic::Agent::Datastores 클래스의 다음 API에서 메서드 인수가 제거되었습니다.

• NewRelic::Agent::Datastores.notice_sql이전에는 query, scoped_metric, elapsed 의 세 가지 위치 인수가 있었습니다. 지금은 query 만 있습니다.
• NewRelic::Agent::Datastores.notice_statement이전에는 두 개의 위치 인수 query 과 elapsed 이 있었습니다. 지금은 query 만 있습니다.
• NewRelic::Agent::Datastores.wrap 프로시저가 필요합니다. 이전에는 해당 프로시저가 yield 결과, 가장 구체적인 범위의 메트릭 이름, 그리고 호출에 걸린 시간이라는 세 가지 인수를 받았습니다. 이제 그것은 오직 하나의 결과, 즉 수확량만을 받습니다.

제거된 인수의 값은 호출 당시의 현재 세그먼트에서 가져옵니다. PR#3347

주요 변경 사항: 실험적 기능 설정 가능 보안 정책(CSP) 제거

설정 가능한 보안 정책(CSP)이라는 실험적 기능은 더 이상 지원되지 않으며 제거되었습니다. PR#3292

호환성 파괴 변경: Puma 버전 '<' 3.9.0에 대한 지원을 제거합니다.

현재 지원되는 Puma의 최소 버전은 3.9.0 이상입니다. PR#3326

획기적인 변경 사항: 설정 유효성 검사 및 강제 적용 개선

입력 설정에 제공된 값을 강제로 적용하고 유효성을 검사하는 데 사용되는 내부 로직이 이제 더욱 성능이 향상되고 정확도가 높아졌습니다.

• 이제 설정에서 nil을 지원하지 않는 경우 구성 값으로 nil이 제공되면 경고 메시지가 newrelic_agent.log 파일에 기록됩니다.
• 토크 설정 유형에는 정수 값이 허용됩니다.
• 정수 설정 유형에 대해 값이 허용됩니다.
• 잘못된 입력값을 대체할 기본값을 찾을 수 있는 경우 치명적인 중단을 방지할 수 있습니다 . (PR#3341)

호환성 파괴 변경: 분산 추적 원격 상위 샘플러에서 '기본값' 옵션을 '적응형'으로 대체합니다.

이전에는 distributed_tracing.sampler.remote_parent_sampled 및 distributed_tracing.sampler.remote_parent_not_sampled 에 대한 기본 옵션이 기존 적응형 샘플러를 사용하는 default 였습니다. default 옵션이 adaptive 로 이름이 변경되었습니다. PR#3363

: logger (를) 의존성/종속성 기능으로 추가하세요.

logger gem은 이제 에이전트의 의존성/종속성으로 나열되어 지속적인 로깅 기능과 루비 4.0.0 및 최신 버전에 대한 지원을 보장합니다. PR#3293

: Active Support 공지 허용 목록 설정 옵션 추가

새로운 설정 옵션인 instrumentation.active_support_notifications.active_support_events 사용하면 에이전트가 구독할 Active Support 공지 이벤트 이름의 허용 목록을 정의할 수 있습니다. 기본적으로 에이전트는 모든 Active Support: Caching 및 Active Support: Messages 이벤트를 구독합니다. PR#3327

: 루비에 내장된 Gzip 압축 사용

에이전트는 이제 압축을 위해 루비 표준의 내장 Zlib.gzip 메소드를 사용하여 이전 사용자 정의 구현을 대체합니다. PR#3332

기능: NewRelic::Agent#record_custom_event API에 대한 인자 유효성 검사 추가

NewRelic::Agent#record_custom_event API는 이제 유효하지 않은 event_type 가 제공될 경우 ArgumentError 오류를 발생시킵니다. 유효한 이벤트 유형은 영숫자, 밑줄(_), 콜론(:) 또는 공백( )으로만 구성되어야 합니다. PR#3319

: 루트 샘플링 설정 옵션 추가

이제 distributed_tracing.sampler.root 사용하여 현재 서비스 내에서 발생하는 트래픽에 대한 샘플링 동작을 구성할 수 있습니다. PR#3330

사용 가능한 모드는 네 가지입니다.

: 트레이스 ID 비율 기반 샘플링 옵션 추가

에이전트는 이제 OpenTelemetry 트레이스 ID 비율 기반 샘플러 알고리즘을 사용하여 트레이스를 샘플링할 수 있습니다. PR#3330 이 샘플은 트레이스 ID를 기반으로 0.0에서 1.0 사이의 확률로 트레이스를 추출합니다.

이 옵션을 사용하려면 먼저 분산 추적 샘플러 설정을 trace_id_ratio_based 으로 설정한 다음 해당 distributed_tracing.sampler.*.trace_id_ratio_based.ratio 샘플러를 0.0과 1.0 사이의 값으로 설정해야 합니다.

예를 들어:

distributed_tracing.sampler.remote_parent_sampled: 'trace_id_ratio_based'
  distributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratio': 0.5

이 설정은 원격 부모가 샘플링되는 모든 트레이스에 대해 트레이의 약 50%를 샘플링합니다.

이 옵션은 다음 경우에 사용할 수 있습니다.

• distributed_tracing.sampler.root
• distributed_tracing.sampler.remote_parent_sampled
• distributed_tracing.sampler.remote_parent_not_sampled

기능: 에이전트 제어 상태 점검 파일에 엔티티 GUID 추가

제어 환경 내에서 시작되면 모든 프로세스에 대해 구성된 파일 위치에 상태 점검 파일이 생성됩니다. 이 파일에는 이제 에이전트와 관련된 엔티티의 GUID가 포함되어 있습니다(사용 가능한 경우). PR#3371

버그 수정: GCP 사용률 감지에서 NoMethodError 오류를 해결합니다.

이제 GCP 메타데이터 검색 로직은 nil 또는 예상치 못한 값을 정상적으로 처리하여 서비스 초기화 충돌을 방지합니다. PR#3388

기능: SqlSampler#notice_sql API에 대한 사용 중단 알림

NewRelic::Agent::SqlSampler#notice_sql 메서드는 더 이상 사용되지 않으며 향후 주요 버전에서 제거될 예정입니다. 대신 사용자는 NewRelic::Agent::Datastores.notice_sql 호출해야 합니다. PR#3345

기능: Datastores.notice_sql의 두 번째 및 세 번째 인수에 대한 사용 중단 알림 API

NewRelic::Agent::Datastores.notice_sql 메서드의 두 번째(scoped_metric) 및 세 번째(elapsed) 인수는 더 이상 사용되지 않습니다. 이 방법은 얼마동안 사용되지 않았습니다. 대신 이러한 값은 API가 호출될 때 현재 세그먼트를 기반으로 설정됩니다. PR#3345

기능: Datastores.notice_statement의 두 번째 인수에 대한 사용 중단 알림 API

NewRelic::Agent::Datastores.notice_statement 메서드의 두 번째(elapsed) 인수는 더 이상 사용되지 않습니다. 이 방법은 얼마동안 사용되지 않았습니다. 대신, 이 값은 API가 호출될 때 현재 세그먼트를 기반으로 설정됩니다. PR#3346

기능: Datastores.wrap API에서 proc의 두 번째 및 세 번째 인수에 대한 사용 중단 알림

NewRelic::Agent::Datastores.wrap 메서드가 변경됩니다. 향후 주요 버전에서는 proc이 yield의 결과인 단일 인수만 허용하게 될 것입니다. 범위가 지정된 메트릭 이름과 경과된 인수는 Datastores.notice_sql 메서드에서 제거되므로 제거됩니다. 범위가 지정된 메트릭 이름과 경과 값은 래핑이 생성될 때 현재 세그먼트에서 파생됩니다. PR#3346

기능: sidekiq.ignore_retry_errors 추가 설정 옵션

Sidekiq 작업 재시도가 캡처되는지 여부를 제어하기 위해 새로운 설정 옵션 sidekiq.ignore_retry_errors 이 추가되었습니다. 재시도 오류는 기본적으로 캡처되지만 이제 sidekiq.ignore_retry_errors true 로 설정된 경우 에이전트는 Sidekiq의 재시도 중 발생한 예외를 무시하고 작업이 영구적으로 실패하는 경우에만 오류를 보고합니다. 이러한 개선 사항을 인식하고 해결책을 제공해 주신 DonGiulio에게 감사드립니다. PR#3317

: Capistrano를 사용하여 녹음 구현, 배포에 대한 지원 중단 알림

Capistrano 레시피를 사용한 배포 정보 전송은 더 이상 사용되지 않으며 에이전트 버전 10.0.0에서 제거될 예정입니다. 기록 구현, 배포의 경우 사용 가능한 옵션 목록은 추적 변경 가이드를 참조하세요.

기능: 더 많은 시나리오에서 결정을 내리기 위해 원격 부모 샘플링 설정을 사용합니다.

이전에는 traceparent 및 tracestate 헤더가 있는 경우에만 distributed_tracing.sampler.remote_parent_sampled 및 distributed_tracing.sampler.remote_parent_not_sampled 설정 옵션이 샘플링 결정에 사용되었습니다. 이제 이러한 설정 옵션은 tracestate 헤더가 누락되고 newrelic 헤더만 사용 가능한 경우에 적용됩니다. 이번 변경으로 인해 방사트레이스 샘플링이 더욱 일관되고 예측 가능해졌습니다. PR#3306

기능: 1단계 측정, Kubernetes용 리소스

Kubernetes APM Kubernetes 구현, 배포 내에서 에이전트 업그레이드를 자동으로 첨부하고 관리합니다. 이 기능은 미리보기에서 종료되었으며 이제 일반적으로 사용할 수 있습니다. Kubernetes 자동 연결 에 대해 자세히 알아보세요. PR#2635 PR#3287

기능: Ruby 2.4 및 Ruby 2.5 지원 중단 안내

Ruby 버전 2.4 및 2.5에 대한 Ruby 에이전트 지원은 더 이상 사용되지 않으며 에이전트 버전 10.0.0에서 제거될 예정입니다.새로운 최소 요구 Ruby 버전은 Ruby 2.6이 되며, Ruby 2.4와 2.5에 대한 테스트는 중단됩니다.PR#3288

기능: newrelic deployments 명령에 대한 사용 중단 알림

newrelic deployments 명령을 사용하여 녹화 및 배포를 지원하는 기능은 더 이상 사용되지 않으며 에이전트 버전 10.0.0에서 제거됩니다.

앞으로는 뉴렐릭의 변경 사항을 기록하는 여러 가지 자동 및 수동 방법이 있습니다. 사용 가능한 옵션 목록은 변경 추적 가이드를 참조하세요. PR#3262

기능: 크로스 애플리케이션 추적을 위한 사용 중단 알림

크로스 로그 추적은 루비 에이전트의 주요 버전 8.0.0부터 더 이상 사용되지 않습니다. 에이전트 버전 10.0.0에서는 이에 대한 지원을 완전히 제거할 예정입니다. PR#3288

기능: Ruby 3.5의 Method#source_location 변경과의 호환성 보장

Method#source_location의 반환 값을 올바르게 구문 분석하도록 에이전트를 업데이트했습니다. 이 값은 Ruby 3.5에서 2개 요소에서 5개 요소로 변경됩니다.이 변경을 통해 이전 Ruby 버전에 대한 지원이 유지되고 향후 릴리스에 대한 지원이 추가됩니다.PR#3257