Notes
이번 릴리스 에이전트에는 LangGraph 에이전트에 대한 지원이 추가되었습니다.
easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
특징
LangGraph 에이전트 지원을 추가합니다.
- LangChain 의
create_agent()을 통해 LangGraph 에이전트 호출을 위한 측정, 리소스를 추가합니다. 여기에는invoke(),ainvoke(),stream(),astream()에 대한 에이전트 통화가 포함됩니다.
- LangChain 의
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이번 파이썬 도구 릴리스에서는 notice_error() 에 오류를 전달하는 새로운 방법이 추가되고, Strands-에이전트 동기 도구 오류 캡처 지원이 추가되고, gpt-5 및 최신 OpenAI LLM 모델 지원이 추가되고, Azure Functions 의 활용 논리에서 발생하는 충돌이 수정되었습니다.
easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
특징
예외 인스턴스를 인수로 지원하는 기능을 추가합니다.
notice_error()notice_error()이제error인자에 대해sys.exc_info()의 예외 튜플 대신 try/except 블록에서 발생한 것과 같은 포착된 예외 인스턴스를 허용할 수 있습니다.이는 기존 동작을 대체하는 것이 아니라 추가되는 기능입니다. 인수가 없거나 예외 튜플과 함께
notice_error()사용하는 이전 방식은 여전히 올바르게 작동해야 합니다.
gpt-5및 그 이후 버전의 OpenAI LLM 모델에 대한 지원을 추가합니다.- OpenAI 측정, 로그에 업데이트를 추가하여 최신 OpenAI 모델과 함께 사용되는 최신 속성 이름을 지원합니다.
Strands-에이전트 동기식 도구 오류 캡처 지원 추가
- Strands-에이전트의 도구로 사용되는 동기식 끌어오기 기능에는 이제 적절한 오류 캡처 기능과 데이터베이스 조회와 같은 도구 내 트레이스 캡처 기능이 있습니다.
버그 수정
Azure Functions 사용 중 충돌을 방지하세요
- 이전에는 일부 사용자가 Azure Functions 사용량 감지가 정규 표현식을 일치시키려고 할 때 충돌하는 예외적인 상황을 경험했습니다. 해당 오류는 수정되었으며, 앞으로는 더 이상 발생하지 않을 것입니다.
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이번 릴리스 에이전트에는 다음에 대한 지원이 추가되었습니다.
- 가닥
- AWS 베드락 컨버스 스트리밍
- 레디스 메소드
hybrid_search및msetex - LLM 이벤트에 대한 LangChain 역할 할당
- LLM 요청 시점에 캡처된 LLM 이벤트 타임스탬프
loop_factory반응, inasyncio.Runner
이번 릴리스에서는 웹 서버에서 헤더가 보고되지 않는 ASGI 측정 및 계측의 버그도 해결되었습니다.
easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
특징
Strands지원을 추가합니다.
- 단일 및 다중 에이전트(군집, 그래프 등) 설정에서 Strands 도구 및 에이전트에 대한 측정, 리소스 추가
AWS Bedrock Converse Streaming지원을 추가합니다.
- Converse API 스트리밍에 대한 모니터링 지원을 추가합니다. 여기에는
converse_stream()을 사용하여 boto3 및 aioboto3 클라이언트로 수행되는 Converse 채팅 완료 호출에 대한 지원이 포함됩니다.
- Converse API 스트리밍에 대한 모니터링 지원을 추가합니다. 여기에는
레디스 메서드 지원을 추가합니다.
다음 메서드에 대한 지원을 추가하세요.
hybrid_searchmsetex
loop_factory에 대한 지원을 추가합니다.asyncio.Runner- 끌어오기 3.11에서는
asyncio.Runner클래스와loop_factory모듈이 추가되었습니다.loop_factory시위는 루프 정책에 대한 대체 방법을 제공합니다. 이제 생성된 루프는 전역 이벤트 루프 설정을 통하든 사용자 정의 대시보드 루프를 통하든 상관없이 승인됩니다.
- 끌어오기 3.11에서는
LLM 이벤트에서 LangChain 역할 할당 캡처
- LangChain
LlmChatCompletionMessage이벤트에는 이제 LangChain 에서 할당된 역할이 포함되어 있습니다.
- LangChain
LLM 요청 시점의 LLM 이벤트 타임스탬프를 캡처합니다.
- 이전에는 LLM 이벤트의 타임스탬프가 이벤트 생성 시점에 기록되었습니다. 이제는 LLM 요청 시점에 더욱 정확하게 기록됩니다.
버그 수정
ASGI 헤더 소비
ASGIWebTransaction이http.response.start이벤트의 헤더를 소비할 때, 허용되는 입력 유형을 고려하지 않고 그렇게 했습니다. 헤더가 생성기인 경우 생성기는process_response()호출에 의해 소비되어 웹 서버가 보낼 헤더가 남지 않습니다. 이제 이 문제는 해결되었습니다.
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
Notes
이번 끌어 당기는 에이전트 릴리스에는 끌어당김 3.14 지원, 속성 필터 설정을 위한 새로운 환경 변수, 프로세서 데코레이터의 비동기 생성기 지원, AWS Bedrock 의 추가 모델 및 AWS Kinesis 의 새로운 방법이 추가되었습니다. 이 릴리스에서는 ConnectionPool 여러 번 래핑하여 사용할 때 RecursionError 이 발생하는 aiomysql 의 버그, kombu 의 프로듀서에서 속성이 제대로 전달되지 않는 버그, 하베스트 스레드 내에서 shutdown_agent 호출될 때 발생하는 오류를 수정합니다.
easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.
특징
끌어당김 3.14 지원 추가
- 끌어오기 3.14에 대한 지원을 추가합니다.
속성 필터 설정에 대한 환경 변수 추가
다음 설정은 이제 환경 변수를 통해 설정할 수 있는 옵션이 생겼습니다.
구성 설정 환경 변수 attributes.enabledNEW_RELIC_ATTRIBUTES_ENABLEDattributes.excludeNEW_RELIC_ATTRIBUTES_EXCLUDEattributes.includeNEW_RELIC_ATTRIBUTES_INCLUDEbrowser_monitoring.attributes.enabledNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLEDbrowser_monitoring.attributes.excludeNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDEbrowser_monitoring.attributes.includeNEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDEerror_collector.attributes.enabledNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLEDerror_collector.attributes.excludeNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDEerror_collector.attributes.includeNEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDEspan_events.attributes.enabledNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLEDspan_events.attributes.excludeNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDEspan_events.attributes.includeNEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDEtransaction_events.attributes.enabledNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLEDtransaction_events.attributes.excludeNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDEtransaction_events.attributes.includeNEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDEtransaction_segments.attributes.enabledNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLEDtransaction_segments.attributes.excludeNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDEtransaction_segments.attributes.includeNEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDEtransaction_tracer.attributes.enabledNEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLEDtransaction_tracer.attributes.excludeNEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDEtransaction_tracer.attributes.includeNEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE
트랜잭션 데코레이터에 비동기 생성기 지원 추가
- 이전에는 트랜잭션 데코레이터가 비동기 생성기를 감싸는 것을 지원하지 않았습니다. 이 지원이 추가되어 이제 비동기 생성기 트랜잭션이 이벤트 루프 대기 시간과 기타 통계를 자동으로 측정합니다.
AWS Bedrock 측정, 로그에 추가 모델에 대한 지원 추가
다음 추가 모델을 지원하도록 botocore 및 aiobotocore 통해 AWS Bedrock 측정, 계측을 업데이트합니다.
- 클로드 소네트 3+ 모델
- 지역으로 접두사가 붙은 모델(지역 인식)
새로운 Kinesis 메서드에 대한 측정, 로그 추가
새로운 AWS Kinesis 메서드를 지원하기 위해 botocore 측정, 리소스 추가
describe_account_settingsupdate_account_settingsupdate_max_record_sizeupdate_stream_warm_throughput
버그 수정
aiomysql ConnectionPool에서 RecursionError 방지
- 이전에는 풀 연결을 사용할 때 aiomysql 에서
RecursionError이 발생했습니다. 반복적인 래핑으로 인해 풀링된 연결 주위에 깊은ObjectProxy체인이 생성되었습니다. 이 문제는 해결되었습니다.
- 이전에는 풀 연결을 사용할 때 aiomysql 에서
kombu 의 프로듀서에서 속성이 제대로 전달되지 않는 버그를 수정했습니다.
kombu.messaging.Producer.publish()에 대한 측정, 계측으로 인해 속성이 실수로 사전 내부에 중첩되어 속성이 잘못된 위치에 있고 다운스트림 패키지에서 읽히지 않는 버그를 수정했습니다.
shutdown_agent이 수확 스레드 내에서 호출될 때 발생하는 오류를 수정합니다.- 이전에는
shutdown_agent수확 스레드 내에서 호출되면RuntimeError이 발생할 수 있었습니다. 이렇게 하면 충돌을 방지하기 위한 보호 장치가 추가되어 문제가 해결됩니다.
- 이전에는
지지 성명
최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.
에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.
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
주의
This version of the agent has been yanked.
This release of the Python agent makes the following changes:
- Removes support for Python 3.7
- Removes and or deprecates various APIs and settings
- Deprecates aioredis instrumentation
- Raises the minimum supported version of
setuptoolsandsetuptools_scm - Adds new instrumentation for AutoGen
- Adds new instrumentation for Pyzeebe
- Adds new MCP (Model Context Protocol) named spans
- Fixes a crash in psycopg
- Ensures MCP spans are only recorded when AI monitoring is enabled
Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.
Removed features
Removes support for Python 3.7
- Python 3.7 was EOL'd June 27, 2023. The Python agent has dropped support for it.
Removes various deprecated APIs
The following APIs have been removed:
Legacy API Replacement API accept_distributed_trace_payloadaccept_distributed_trace_headersadd_custom_parameteradd_custom_attributeadd_custom_parametersadd_custom_attributescreate_distributed_trace_payloadinsert_distributed_trace_headersget_browser_timing_footerThe functionality of this has been wrapped into get_browser_timing_header()record_exceptionnotice_error()NewRelicLogHandlerNewRelicLogForwardingHandlerlambda_handler&LambdaHandlerWrapperThese APIs have moved to the newrelic-lambdapackage.
Removes various deprecated settings
The following settings have been removed:
Legacy Setting Replacement Setting 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.allowlistsslThis is now hardcoded to trueso it has been removed as a setting option.ignored_paramsUse newrelic.attributes.exclude = request.parameters.{name}instead. Add each request parameter key to thenewrelic.attributes.excludelist, delimited by commas. Be sure to prepend the key withrequest.parameters.agent_limits.merge_stats_maximumThis is now completely ignored in favor of serverside config.
Deprecated features
Instrumentation for aioredis has been deprecated
Deprecates some existing harvest settings to match other language agents
In order to be more consistent with the conventions of the other language agents, the following harvest settings are now deprecated:
Legacy Setting Replacement Setting 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_storedThis is a revert of a previous change that renamed these settings from
*.max_samples_storedto theevent_harvest_config.harvest_limits.*form. This decision has been reversed, and the original settings named have been restored to match the other language agents who did not change these settings names. The deprecated settings will continue to work for now, but they will be removed in a future release.
Deprecates configuration of the agent through the WSGI environ dictionary
The following settings which were previously possible to configure through the WSGI environ dictionary are now deprecated. Please configure these settings through environment variables or the config file.
newrelic.set_background_tasknewrelic.suppress_apdex_metricnewrelic.suppress_transaction_tracenewrelic.capture_request_paramsnewrelic.disable_browser_autorum
Deprecates support for building the agent with
setuptools<61.2orsetuptools_scm<6.4- The minimum supported versions of
setuptoolsandsetuptools_scmhave been increased to61.2and6.4respectively. This is to support the use ofpyproject.tomlfor configuring the package metadata and building instructions. The agent can now be built with more modern build tools which will no longer log warnings about the lack of apyproject.tomlfile. - This change adds new version attributes to the packages,
newrelic.__version__andnewrelic.__version_tuple__, which can be used to programmatically check the version of the agent at runtime.
- The minimum supported versions of
New features
Adds new instrumentation for AutoGen
- Adds instrumentation (named spans and custom
Llmevents) for agents and tools in AutoGen
- Adds instrumentation (named spans and custom
Adds new instrumentation for Pyzeebe
- Adds automatic instrumentation and framework-specific agent attributes for Pyzeebe
Adds new MCP (Model Context Protocol) named spans
- Adds new named spans for MCP (Model Context Protocol) tool calls made via tool manager to support Streamable HTTP
Bug fixes
Fixes a crash in
psycopg>=3.2.0when callingas_string()- Fixes an issue in
psycopg>=3.2.0where theas_string()method no longer required arguments, causing a potential crash. This has been fixed, and both signatures of this method are supported.
- Fixes an issue in
Ensures MCP (Model Context Protocol) spans are only recorded when AI monitoring is enabled
- Ensures MCP (Model Context Protocol) spans are only recorded when the setting
ai_monitoring.enabledis enabled.
- Ensures MCP (Model Context Protocol) spans are only recorded when the setting
Support statement
We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.
See the New Relic Python agent EOL policy for information about agent releases and support dates.