Ruby agent release notesRSS

기능: 구조화된 로깅을 위한 Rails.event 계측 추가

이제 에이전트는 Rails.event를 구조화된 로그 이벤트로 지원합니다. 활성화되면 Rails.event.notify 을(를) 통해 게시된 이벤트는 캡처되어 로그 이벤트로 뉴렐릭에 전달됩니다. 이벤트 페이로드, 태그, 컨텍스트, 타임스탬프 및 소스 위치는 로그 속성으로 자동으로 캡처됩니다.

이 계측은 다음 옵션으로 구성할 수 있습니다:

• instrumentation.rails_event_logger - Rails.event 계측이 활성화되는지 여부를 제어합니다. 기본적으로 application_logging.enabled 값을 사용합니다.
• instrumentation.rails_event_logger.event_names - 캡처할 특정 이벤트 이름의 어레이입니다. 비어 있는 경우(기본값), 모든 Rails.event 공지가 캡처됩니다. 이를 사용하여 이름별로 이벤트를 필터링합니다. 예: ['user.signup', 'payment.processed'].

PR#3526

기능: Rails Active Job Continuations 계측 추가

이제 에이전트가 Rails Active Job Continuations를 계측하여 장기 실행 작업 내의 개별 단계 실행에 대한 가시성을 제공합니다. 단계 이름은 세그먼트 메트릭(예: Ruby/ActiveJob/default/MyJob/step/process_records)에 포함되며 커서 위치, 재개 상태, 중단 상태와 같은 단계별 속성이 캡처됩니다. 새로운 설정 옵션인 disable_active_job_step_names을(를) 통해 사용자는 필요한 경우 메트릭 기수를 줄이기 위해 메트릭 이름에서 단계 이름을 제외할 수 있습니다(기본값은 false입니다). PR#3493

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

새로운 설정 옵션인 sidekiq.separate_transactions을(를) 사용하면 웹 트랜잭션 중에 실행되는 Sidekiq 작업을 별도의 자체 트랜잭션에서 실행할 수 있습니다. 활성화하면 Sidekiq 작업 실행 시간이 웹 트랜잭션 메트릭에 포함되는 것을 방지하여 더 정확한 성능 데이터를 제공합니다. 이 기능은 역호환성을 유지하기 위해 선택 사항(기본값: false)입니다. 이는 활성 웹 트랜잭션 중에 실행되는 작업에만 영향을 미치며, 독립적으로 시작되거나 다른 백그라운드 작업 내에 중첩된 작업은 영향을 받지 않습니다. Issue#3364 PR#3514

버그 수정: ReDOS 공격에 취약했을 수 있는 정규식 업데이트

이전에는 에이전트에 다항 시간 복잡도(ReDOS) 공격의 가능한 타겟으로 식별된 몇 가지 정규식이 있었습니다. 우려 사항을 해결하기 위해 해당 정규식이 업데이트되었습니다. PR#3520

Bugfix: HTTPX 세그먼트 생성 중 충돌을 방지합니다.

이전에는 start_external_request_segment 에서 오류가 발생하여 nil을(를) 반환하면, 에이전트는 누락된 세그먼트에 헤더를 추가하려고 시도할 때 NoMethodError 을(를) 트리거했습니다. 계측이 이러한 경우를 원활하게 처리할 수 있도록 가드 검사를 추가했습니다.

보고서를 작성해 주신 @thebravoman 님께 박수를 보냅니다! 이슈#3509 PR#3510

버그 수정: Transaction#finish를 멱등하게 만들기

이전에는 Transaction#finish 메서드가 여러 번 호출되면 동일한 작업에 대해 둘 이상의 트랜잭션이 생성될 수 있었습니다. 이제 뮤텍스가 Transaction#finish에 대한 호출을 보호하여 finish 작업이 한 번만 실행되도록 합니다. PR#3513

버그 수정: Datastores.wrap API의 Log 기능에 대한 사용 중단 경고 (1회)

이전에는 Datastores.wrap에 대한 모든 호출에서 이 경고가 로그에 기록되었습니다. 이제 첫 번째 호출에만 로그가 기록됩니다. 또한, 두 번째 및 세 번째 콜백 인수의 사용 중단 상태를 명시하도록 문서가 업데이트되었습니다. 이슈#3516 PR#3519

기능: SQL 주석을 통해 데이터베이스 쿼리 이름 지정 추가

이제 SQL 주석을 사용하여 데이터베이스 쿼리에 명시적인 이름을 지정할 수 있습니다. 쿼리에는 추적 및 식별을 개선하기 위해 안정적인 이름을 지정하는 /* NewRelicQueryName: CustomName */ 주석이 포함될 수 있습니다. 이는 성능 회귀 또는 인시던트 중에 특정 데이터베이스 쿼리를 추적하는 데 특히 유용합니다. PR#3480

기능: 의미론적 로거 측정 추가, 로그

에이전트는 이제 semantic_logger gem 버전 4.6.0+에 대한 Semantic 로거 로그 포워딩 및 장식을 지원합니다. 이전에 Semantic 로거의 내장 뉴렐릭 어펜더를 사용하셨다면, 중복 로그 전송을 방지하기 위해 한 가지 방법을 선택하시는 것이 좋습니다. 뉴렐릭의 Semantic 로거 측정, 리소스는 instrumentation.semantic_logger 을 disabled 로 설정하여 비활성화할 수 있습니다. PR#3467

@jdelStrother 님께서 귀중한 피드백을 제공해 주셔서 이 측정, 계측을 구체화하는 데 도움이 되었습니다.

기능: 'ignored_middleware_classes' 설정을 새로 추가합니다.

새로운 설정 옵션인 ignored_middleware_classes 사용하면 사용자가 측정, 로그에서 특정 미들웨어를 제외할 수 있습니다(예: 랙::코어스). 기본적으로 비어 있는 다시입니다. 이슈 번호 1814 PR 번호 3481

기능: 새로운 NewRelic::Agent.add_transaction_log_attributes API 추가

새 API 인 NewRelic::Agent.add_transaction_log_attributes) 사용하면 사용자가 현재 프로세서에 대한 프로세서 범위의 관습 속성 등록 이벤트를 추가할 수 있습니다. 이러한 속성은 현재 트랜잭션 범위 내에서 생성된 로그에만 적용됩니다. PR#3472

버그 수정: ActionCable 브로드캐스트 메트릭의 카디널리티를 줄이는 구성 옵션을 제공합니다.

기본적으로 ActionCable 브로드캐스트 메서드 호출에 대한 메트릭에는 브로드캐스팅 값이 포함됩니다. 이 값은 매우 높은 카디널리티를 가질 수 있습니다. 이제 :simplify_action_cable_broadcast_metrics 설정 옵션을 사용하면 지표 이름에서 방송 값을 제거할 수 있습니다. 이것은 다음과 같은 형태를 갖는 것을 생성합니다: Ruby/ActionCable/broadcast. 이 설정 옵션을 활성화하면 브로드캐스팅 값이 span 속성으로 추가됩니다. PR#3463

버그 수정: FIPS/FedRAMP 규정 준수를 위한 더 이상 필요 없는 'digest/md5' 요구 사항을 제거했습니다.

에이전트 버전 7.1.0에서는 FIPS 규정 준수를 위해 MD5 사용이 SHA1으로 대체되었습니다 (PR). 하지만 기존의 'digest/md5' 요구 사항은 제거되지 않았습니다. FIPS/FedRAMP 사용자들을 지원하기 위해 해당 요구 사항을 제거했습니다. 이 문제를 알려주신 @ashleyboehs 님께 감사드립니다! 이슈 번호 3469 PR 번호 3470

버그 수정: 종료 지연을 방지하기 위해 rails test 동안 에이전트가 시작되지 않도록 수정했습니다.

이전에는 에이전트가 rails test 명령을 실행할 때 약 3초의 종료 지연이 발생했습니다. Rails::Command::TestCommand 상수는 Rails 테스트 실행 중에 에이전트가 시작되는 것을 방지하기 위해 기본 autostart.denylisted_constants 목록에 추가되었습니다. 이 문제를 알려주신 @varyform 님께 감사드립니다. PR#3478

버그 수정: Falcon 웹 서버 사용 시 "경과된 작업 시간을 계산할 수 없습니다"라는 경고 메시지를 수정했습니다.

이제 Falcon 에서 실행될 때 상태를 추적하기 위해 Thread.current.object_id 대신 Fiber.current.object_id 사용하여 동일한 스레드를 공유하는 동시 requests 으로 인한 충돌을 방지합니다. 또한 Falcon을 사용할 때 발생하는 "NameError: uninitialized constant Async::HTTP::VERSION" 오류를 수정합니다. 이 문제를 알려주신 @97jaz님 과 @gsar 님께 감사드립니다. PR#3483

버그 수정: harvest.rb 파일의 오타로 인해 발생하던 NoMethodError 오류를 수정했습니다.

lib/new_relic/agent/agent_helpers/harvest.rb 의 오타로 인해 NoMethodError: undefined method 'agent' for NewRelic:Module 이 발생했습니다. 이 문제를 제보해 주신 @oakbow 님께 감사드립니다. PR#3484

버그 수정: 더 이상 사용되지 않는 ObjectSpace._id2ref 사용을 제거했습니다.

이제 해당 도구는 더 이상 사용되지 않는 ObjectSpace._id2ref 방법 대신 대체 접근 방식을 사용하므로 루비 4.0 이상에서 실행 시 사용 중단 경고가 사라집니다. PR#3490

버그 수정: Logging 측정, 리소스의 NoMethoError 수정

이전에 Logging gem 측정, 계측이 로컬 로그를 데코레이션하려고 시도할 때 문자열이 아닌 객체를 만나면 NoMethodError 오류가 발생했습니다. 이 문제는 이제 해결되었습니다. PR#3501

기능: OpenTelemetry 추적 지원을 위한 하이브리드 에이전트 도입

이제 OpenTelemetry Tracing API를 뉴렐릭 루비 에이전트의 새로운 하이브리드 에이전트 기능을 사용하여 뉴렐릭 텔레메트리로 변환할 수 있습니다. 이를 통해 newrelic_rpm gem은 OpenTelemetry SDK와 유사하게 동작할 수 있으며, OpenTelemetry API 호출을 수락하고 이를 친숙한 속성과 이름을 가진 뉴럴릭 트랜잭션 및 세그먼트로 변환합니다.

다음 설정 옵션은 하이브리드 에이전트 기능과 관련됩니다:

: 설정 옵션 error_collector.backtrace_truncate_location 추가

새로운 설정 옵션 error_collector.backtrace_truncate_location 추가되었으며, 이를 통해 사용자는 프레임 수가 error_collector.max_backtrace_frames 초과할 때 백트레이스에서 어디를 잘라낼지 지정할 수 있습니다. 옵션은 'top' (시작 부분에서 프레임을 제거), 'middle' (시작과 끝은 유지하면서 중간 부분에서 프레임을 제거), 또는 'end' (끝 부분에서 프레임을 제거)입니다. 기본값은 'middle' 입니다. PR#3424

: 로깅 gem 측정 기능 추가, 로그아웃

이제 에이전트는 Logging gem 에서 생성된 로그를 기록합니다. PR#3420

기능: 설정 옵션을 추가합니다.utilization.Detect_in_parallel

새로운 설정 옵션 utilization.detect_in_parallel 이 추가되었으며, 이는이 cloud 공급업체 정보를 감지할 때 스레드를 사용하여 시작 속도를 높일지 여부를 제어합니다. false 로 설정하면 공급업체 감지가 스레드를 생성하지 않고 순차적으로 실행됩니다. 기본값은 true 입니다. PR#3439

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