Notes
이 끌어 당기는 에이전트 릴리스는 Django 측정의 초기 활성화, 소스, 무시되는 max_samples_stored 에 대한 서버 측 재정의 및 Python trace_cache.pop() 의 충돌 방지에 대한 수정 사항을 제공합니다.
끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
버그 수정
Django 측정, 로그의 조기 활성화 방지
- Django 측정에서
application_settings()에 대한 호출을 제거하여 pre-fork의 초기 활성화 관련 문제를 방지합니다.
- Django 측정에서
서버 설정을 로컬 설정 동기화 문제 수정
- 이는
event_harvest_config.harvest_limits.*설정이*.max_samples_stored설정으로 인해 더 이상 사용되지 않을 때 발생한 버그를 수정합니다. 일부 서버측 설정이 클라이언트측 설정을 재정의하지 않아 사용자가 이를 비활성화했음에도 불구하고 데이터가 수집기로 전송되었습니다.
- 이는
충돌로부터 보호하세요
trace_cache.pop()ContextOf클래스에서 기본값 없이pop(key)통해trace_cache에 안전하지 않은 액세스가 발생했습니다. 사전의weakref이 이미 가비지 수집된 경우 충돌이 발생했습니다.
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
주의
이 버전의 에이전트는 철회되었습니다.
이번 릴리스 에이전트에는 다음과 같은 변경 사항이 적용됩니다.
- 끌어당김 3.7에 대한 지원 제거
- 다양한 API 및 설정을 제거하거나 더 이상 사용하지 않습니다.
- aioredis 측정, 로그 사용 중단
setuptools의 최소 지원 버전을 올립니다.setuptools_scm- AutoGen에 대한 새 측정, 로그를 추가합니다.
- Pyzeebe에 대한 새로운 측정, 로그를 추가합니다.
- 새로운 MCP(모델 컨텍스트 프로토콜)라는 이름의 span을 추가합니다.
- psycopg에서 충돌이 발생하는 문제를 해결합니다.
- AI 모니터링이 활성화된 경우에만 MCP 스팬이 기록되도록 보장합니다.
끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
제거된 기능
끌어당김 3.7에 대한 지원 제거
- 끌어3.7은 2023년 6월 27일에 단종되었습니다. 접착제 에이전트가 이에 대한 지원을 중단했습니다.
다양한 더 이상 사용되지 않는 API를 제거합니다.
다음 API가 제거되었습니다.
구형 API 대체 API accept_distributed_trace_payloadaccept_distributed_trace_headersadd_custom_parameteradd_custom_attributeadd_custom_parametersadd_custom_attributescreate_distributed_trace_payloadinsert_distributed_trace_headersget_browser_timing_footer이 기능은 get_browser_timing_header()에 래핑되었습니다.record_exceptionnotice_error()NewRelicLogHandlerNewRelicLogForwardingHandlerlambda_handler&LambdaHandlerWrapper이러한 API는 newrelic-lambda패키지로 이동되었습니다.
다양한 더 이상 사용되지 않는 설정을 제거합니다.
다음 설정이 제거되었습니다.
구형 설정 교체 설정 transaction_tracer.capture_attributestransaction_tracer.attributes.enablederror_collector.capture_attributeserror_collector.attributes.enabledbrowser_monitoring.capture_attributesbrowser_monitoring.attributes.enabledanalytics_events.enabledtransaction_events.enabledanalytics_events.capture_attributestransaction_events.attributes.enablederror_collector.ignore_errorserror_collector.ignore_classesstrip_exception_messages.whiteliststrip_exception_messages.allowlistssl이제 이 항목은 true에 하드코딩되어 설정 옵션에서 제거되었습니다.ignored_params대신 newrelic.attributes.exclude = request.parameters.{name}사용하세요. 각 요청 템플릿, 키를 쉼표로 구분하여newrelic.attributes.exclude목록에 추가합니다. 키 앞에request.parameters꼭 추가하세요.agent_limits.merge_stats_maximum이제 서버 측 구성을 선호하여 이 문제는 완전히 무시되었습니다.
더 이상 사용되지 않는 기능
aioredis 에 대한 측정, 사용이 더 이상 사용되지 않습니다.
다른 언어 에이전트와 일치하도록 일부 기존 수확 설정을 더 이상 사용하지 않습니다.
다른 언어 에이전트의 규칙과 일관성을 유지하기 위해 다음 수확 설정은 더 이상 사용되지 않습니다.
구형 설정 교체 설정 event_harvest_config.harvest_limits.analytic_event_datatransaction_events.max_samples_storedevent_harvest_config.harvest_limits.span_event_dataspan_events.max_samples_storedevent_harvest_config.harvest_limits.error_event_dataerror_collector.max_event_samples_storedevent_harvest_config.harvest_limits.custom_event_datacustom_insights_events.max_samples_storedevent_harvest_config.harvest_limits.log_event_dataapplication_logging.forwarding.max_samples_stored이는 이러한 설정의 이름을
*.max_samples_stored에서event_harvest_config.harvest_limits.*형식으로 변경한 이전 변경 사항을 되돌린 것입니다. 이 결정은 뒤집혔고, 원래 설정은 이러한 설정 이름을 변경하지 않은 다른 언어 에이전트와 일치하도록 복원되었습니다. 더 이상 사용되지 않는 설정은 현재로는 계속 작동하지만, 향후 릴리스에서는 제거될 예정입니다.
WSGI 환경 사전을 통해 에이전트 설정을 더 이상 사용하지 않습니다.
이전에는 WSGI environ 사전을 통해 구성할 수 있었던 다음 설정은 더 이상 사용되지 않습니다. 환경 변수나 구성 파일을 통해 이러한 설정을 구성하세요.
newrelic.set_background_tasknewrelic.suppress_apdex_metricnewrelic.suppress_transaction_tracenewrelic.capture_request_paramsnewrelic.disable_browser_autorum
setuptools<61.2또는 를 사용하여 에이전트를 빌드하는 데 대한 지원을 더 이상 사용하지 않습니다.setuptools_scm<6.4setuptools및setuptools_scm의 최소 지원 버전이 각각61.2및6.4으로 증가했습니다. 이는 패키지 메타데이터 구성 및 빌드 지침에pyproject.toml를 사용할 수 있도록 지원하기 위한 것입니다. 이제 에이전트는 더 현대적인 빌드 도구로 빌드될 수 있으며, 더 이상pyproject.toml파일이 없다는 경고를 발생시키지 않습니다.- 이 변경 사항은 패키지
newrelic.__version__및newrelic.__version_tuple__에 새로운 버전 속성을 추가합니다. 이를 통해 런타임에 에이전트 버전을 프로그래밍 방식으로 확인할 수 있습니다.
새로운 기능
AutoGen에 대한 새 측정, 로그를 추가합니다.
- AutoGen의 에이전트 및 도구에 대한 측정, 로그(명명된 범위 및 사용자 정의
Llm이벤트)를 추가합니다.
- AutoGen의 에이전트 및 도구에 대한 측정, 로그(명명된 범위 및 사용자 정의
Pyzeebe에 대한 새로운 측정, 로그를 추가합니다.
- Pyzeebe에 대한 자동 측정, 리소스 및 프레임워크 관련 에이전트 속성을 추가합니다.
새로운 MCP(모델 컨텍스트 프로토콜)라는 이름의 span을 추가합니다.
- Streamable HTTP를 지원하기 위해 도구 관리자를 통해 수행된 MCP(모델 컨텍스트 프로토콜) 도구 호출에 대한 새로운 명명된 스팬을 추가합니다.
버그 수정
psycopg>=3.2.0에서 호출 시 발생하는 충돌을 수정합니다.as_string()as_string()메서드가 더 이상 인수를 필요로 하지 않아 잠재적인 충돌을 일으키는psycopg>=3.2.0의 문제를 해결합니다. 이 문제는 해결되었으며, 이 메서드의 두 가지 서명이 모두 지원됩니다.
AI 모니터링이 활성화된 경우에만 MCP(모델 컨텍스트 프로토콜) 스팬이 기록되도록 보장합니다.
- MCP(모델 컨텍스트 프로토콜) 스팬은 설정
ai_monitoring.enabled활성화된 경우에만 기록됩니다.
- MCP(모델 컨텍스트 프로토콜) 스팬은 설정
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이번 릴리스 에이전트에는 다음에 대한 지원이 추가되었습니다.
- Celery의 사용자 정의 작업
- 그래핀-Django 모니터링
- Django의 미들웨어 필터링
- AWS Bedrock Converse API
- W3CTraceParent 헤더 샘플링 플래그
이 릴리스에서는 다음과 같은 수정 사항도 제공됩니다.
- GraphQL에서 가장 깊은 고유 경로에 대한 보호 장치
- 웹 URL 요청 구문 분석을 위한 보안 조치
- ElasticSearch 및 GraphQL에 대한 대체
trace.settings==None - 비동기 ElasticSearch 클라이언트 목록에서
options메서드 제거
끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
새로운 기능
Celery에서 사용자 정의 작업에 대한 지원을 추가합니다.
Graphene-Django에 대한 지원을 추가합니다.
- Graphene-Django 로 생성된 동기 스키마에 대한 모니터링 지원을 추가합니다. 이전에는 Graphene-Django로 생성된 스키마가 부분적으로만 모니터링되어 GraphQL 관련 속성이 누락되었습니다.
Django에서 미들웨어 필터링에 대한 지원을 추가합니다.
이제 사용자는 모니터링할 Django 미들웨어를 필터링할 수 있습니다. 이제 세 가지 추가 설정이 있습니다.
instrumentation.middleware.django.enabled(기본값은true입니다)instrumentation.middleware.django.excludeinstrumentation.middleware.django.include
자세한 내용과 예제는 Django 미들웨어 필터링 페이지를 참조하세요.
AWS Bedrock Converse API에 대한 지원을 추가합니다.
- 스트리밍이 아닌 Converse API에 대한 모니터링 지원을 추가합니다. 여기에는
boto3및aioboto3클라이언트를 사용하여 수행된converse채팅 완료 호출에 대한 지원이 포함됩니다.
- 스트리밍이 아닌 Converse API에 대한 모니터링 지원을 추가합니다. 여기에는
W3CTraceParent 헤더 샘플링 플래그에 대한 지원을 추가합니다.
- 업스트림 서비스가 샘플링 플래그가 설정된 W3CTraceParent 헤더를 보내면 뉴렐릭은 currentResources를 샘플링할지 여부를 결정할 때 해당 샘플링 결정을 고려합니다.
원격 부모가 샘플링되었는지 여부에 따라 샘플링 결정에 대한 지원이 추가되었습니다.
두 가지 새로운 설정 옵션에 대한 지원이 추가되었습니다.
distributed_tracing.sampler.remote_parent_sampleddistributed_tracing.sampler.remote_parent_not_sampled
default기본 동작이며 이 변경 이전과 동일하게 동작합니다(트랜잭션을 샘플링할지 여부를 결정하기 위해 샘플링 결정을 적응형 샘플링 알고리즘에 전달함).always_on즉, 원격 부모가 샘플링되었거나 샘플링되지 않은 트레이스는 항상 샘플링됩니다.always_off즉, 원격 부모가 샘플링되었거나 샘플링되지 않은 원격 부모가 있는 트레이스는 절대 샘플링되지 않습니다.
버그 수정
GraphQL에서 가장 깊은 고유 경로에 대한 보호 기능 추가
- 일부 사용자는 GraphQL 에서 필드 이름이
None반환하여 가장 깊은 고유 경로가 생성되지 않는 문제를 경험했습니다. 이 문제는 해결되었습니다.
- 일부 사용자는 GraphQL 에서 필드 이름이
웹 요청 구문 분석을 위한 보호 기능 추가
- 일부 사용자는
request_uri잘못 형식화되었거나 잘못된 문자를 포함하고 있어 구문 분석 오류를 경험했습니다. 요청 헤더의request_uri이 유효하지 않고 원래 제공된 (유효한) URL과 일치하지 않는 경우 이 문제가 발생할 수 있습니다. 이 보호 장치는 현재 뉴렐릭에 적용되었지만,urllib에서는 2025년 1월 31일 이후에 출시된 버전에 대한 이 문제를 해결했습니다.
- 일부 사용자는
ElasticSearch 및 GraphQL에서 충돌을 수정합니다.
trace.settings==Nonetrace.settings이None인 경우 ElasticSearch에 대한 측정, 리소스가 작동을 중단했습니다.global_settings대안이 마련되었습니다. 이는 GraphQL에서 발견되는 동일한 문제를 해결합니다.
비동기 ElasticSearch 클라이언트 목록에서
options메서드 제거- 이전 측정, ElasticSearch의 계측은
options비동기 메서드 목록에 있기 때문에 충돌이 발생했습니다. 이 메서드는 어떠한 데이터스토어 작업/requests 도 수행하지 않으므로 더 이상DatastoreTrace에 래핑되지 않습니다.
- 이전 측정, ElasticSearch의 계측은
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이 에이전트 릴리스에서는 새로운 레디스 함수에 대한 지원이 추가되고, 모든 내부 경로를 os.path 에서 pathlib.Path 로 변환하며, PosixPaths의 JSON 인코딩 문제를 해결합니다.
끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
새로운 기능
새로운 레디스 기능에 대한 지원을 추가합니다.
- 새로운 레디스 함수에 대한 측정, 로그를 추가합니다.
os.path의 모든 내부 경로를 다음으로 변환합니다.pathlib.Path- Windows 경로를 지원하기 위해 문자열 기반 경로의 모든 내부 사용법과
os.path을pathlib.Path로 변환합니다.
- Windows 경로를 지원하기 위해 문자열 기반 경로의 모든 내부 사용법과
버그 수정
PosixPath JSON 인코딩 문제 해결
- 일부 사용자는 JSON 인코딩
PosixPath구성 설정에서 문제를 겪고 있었습니다. 이 문제는 해결되었습니다.
- 일부 사용자는 JSON 인코딩
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이번 릴리스 에이전트는 oracledb 에 대한 지원을 추가하고, MessageTransaction 객체에 destination_name 속성이 없는 Kombu 및 Kafka의 버그를 수정하고, AWS 에서 사용률 메타데이터가 사라지는 문제를 수정합니다.
끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
새로운 기능
OracleDB에 대한 지원을 추가합니다.
- oracledb 에 대한 측정, 도구를 추가합니다.
버그 수정
"
MessageTransaction개체에 속성destination_name없습니다" 버그 수정- MessageBroker 측정, 과학적 버그를 수정했습니다. 이 버그에서는 직렬화 메서드가
MessageTransaction에서destination_name속성을 찾았지만 해당 속성이 존재하지 않았습니다.
- MessageBroker 측정, 과학적 버그를 수정했습니다. 이 버그에서는 직렬화 메서드가
AWS와 K8s를 함께 실행할 때 발생하는 AWS 활용 메타데이터 문제 해결
- AWS EC2 서버에서 실행되는 K8s 파드의 권한 설정으로 인해 사용량을 처음으로 검색할 수 있습니다. 그러나 애플리케이션을 계속해서 실행하면 에이전트가 다시 연결되고 사용률 메타데이터가 로드되지 않습니다. 이러한 경우, 활용 메타데이터는 에이전트 인스턴스별로 캐시되며 검색이 가능합니다.
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.