Python agent release notesRSS

Notes

This release of the Python agent removes support for Cross Application Tracing (CAT), Python 3.8, and the bundled SSL certificates. It also updates all vendored packages to their latest versions, and adds support for free-threaded CPython, Windows operating systems, and improved instrumentation for Microsoft AG2 (Autogen). Additionally, this release includes a new optional extra for installing SSL certificates through certifi. This release also fixes a bug in Strands Agents instrumentation which caused duplicate exceptions to be reported.

Install the agent using easy_install/pip/distribute via the Python Package Index, using conda via the Conda-Forge Package Index, or download it directly from the New Relic download site.

Removed features

• Cross Application Tracing (CAT) has been removed in favor of Distributed Tracing (DT).

  • Cross Application Tracing (CAT) was deprecated in agent version 7.0.0.166, and has been removed in this release. If you are still using Cross Application Tracing (CAT), we recommend migrating to Distributed Tracing (DT) as soon as possible to avoid disruption.

• The bundled SSL certificates have been removed.

  • If you require certificates for your environment, you can either install them via your operating system's package manager or install the agent with the optional newrelic[certificates] extra.

• Python 3.8 support has been removed.

  • Python 3.8 reached End-of-Life on 2024-10-07 and is no longer supported by the agent. Please consider upgrading your application to a supported version of Python in order to continue to receive updates to the Python Agent.

Security

• All internal packages updated to their latest versions.

  • urllib3 updated to v2.6.3
    • This fixes all open CVEs on urllib3 as of the date of this release.
  • opentelemetry_proto updated to v1.40.0
  • wrapt updated to v2.1.2
  • asgiref updated to v3.11.1

New features

• New newrelic[certificates] extra for installing SSL certificates through certifi.

  • The agent now provides an optional newrelic[certificates] extra which can be used to install the bundled SSL certificates. This is intended for users who require certificates but are unable to install them via their operating system's package manager.

• Free-Threaded CPython support

  • Starting with Python 3.13, CPython releases builds of Python with the Global Interpreter Lock (GIL) disabled, allowing for true multi-threading.
  • This release adds support for this behavior, allowing the agent to safely run in a free-threaded environment.
  • This release also includes pre-built binaries for free-threaded CPython on Linux and Windows, allowing for easy installation in these environments.

• Windows Support

  • This release includes pre-built binaries for CPython 3.13 or higher on Windows.
  • Note that Python 3.12 or lower is not officially supported on Windows due to large variances in the resolution of timers. It's still possible to install and use the agent from source, but users may experience issues with inaccurate timing data and should upgrade to Python 3.13 or higher for the best experience.

• Improved instrumentation for Microsoft AG2 (Autogen)

  • Added support for streaming responses through the asynchronous generator method on_messages_stream().
  • Instrumentation now includes a subcomponent attribute on spans that represent tool or agent calls. This is used to provide more enhanced entity mapping in the New Relic UI.

Bugs

• Duplicate exceptions in Strands Agents

  • After an update to Strands Agents which encapsulates some exceptions in a new EventLoopException type, duplicate errors could be reported. This has been fixed and the underlying error should only be reported once.

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.

Notes

이번 끌어오기 에이전트 릴리스에는 하이브리드 에이전트에 대한 트레이스/스팬 지원, 뉴렐릭과 OpenTelemetry 의 통합이 추가되었습니다. 또한 에이전트 제어 상태 확인 파일에 안테나 GUID를 추가하고, 에이전트 AI 측정에 대한 subcomponent 속성, 소스, 새 레디스 클라이언트 메서드에 대한 지원, 중복된 ImportHookFinderex가 있을 수 있는 버그 및 OracleDB Cursor.callproc() 측정의 버그 수정을 추가합니다.

easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

특징

• 하이브리드 에이전트 추적 지원 추가

  • 하이브리드 계측은 기존 신경 계측과의 하위 호환성을 유지하면서 OpenTelemetry 표준을 도입하려는 팀을 위해 설계되었습니다. 하이브리드 방식은 뉴럴릭의 심층적인 가시성과 OpenTelemetry API 호환성을 결합하여 "두 가지 장점을 모두 갖춘" 경험을 제공합니다. 이 솔루션은 다음과 같은 OpenTelemetry API에 대한 통합 지원을 제공하는 옵저버빌리티 솔루션입니다.

    • 트레이싱
    • 독립 실행형 라이브러리 및 네이티브 프레임워크 측정, 로그

  • 스팬 링크 및 스팬 이벤트와 같은 주요 개선 사항이 이제 제공되어 혼합 모드 환경에서 원활한 상호 운용성을 보장합니다.

• 새로운 트레이스 ID 비율 기반 샘플러를 소개합니다.

  • 새로운 트레이스 ID 비율 기반 샘플러. 이 샘플링 알고리즘은 OpenTelemetry의 동일한 이름의 샘플러를 기반으로 하며, 트랜잭션의 일정 비율을 샘플링하도록 구성할 수 있습니다.

• 에이전트 AI 측정, 로그에 subcomponent 속성 추가

  • LangChain, MCP 및 Strands 에 대한 측정, 리소스에는 이제 도구 또는 에이전트 호출을 나타내는 범위에 대한 subcomponent 속성이 포함됩니다. 이는 뉴렐릭 UI 에서 더욱 향상된 회의 매핑을 제공하는 데 사용됩니다.

• 에이전트 제어 상태 점검 파일에 엔티티 GUID를 추가합니다.

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

• 새로운 레디스 메서드에 대한 측정, 로그 추가

  • 레디스 클라이언트에서 다음 메소드에 대한 측정, 로그를 추가합니다.

    • 핫키 가져오기
    • 핫키 재설정
    • 핫키_시작
    • 핫키 정지
    • 브랑게
    • xcfgset

벌레

• 중복된 ImportHookFinder 인스턴스를 수정합니다.

  • 이전에는 가져오기 후크 찾기의 중복이 sys.meta_path 에 추가될 수 있었습니다.

• OracleDB에서 잘못된 서명을 수정합니다. Cursor.callproc()

  • 이전에는 측정, 계측에서 인자 이름이 잘못되어 Cursor.callproc() 과 함께 키워드 인자를 사용하려고 시도하면 충돌이 발생했습니다. 이 문제는 해결되었으며, 이제 추가 인수 keyword_parameters 도 지원됩니다.

지지 성명

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.

Notes

이번 릴리스 에이전트에는 LangGraph 에이전트에 대한 지원이 추가되었습니다.

easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

특징

• LangGraph 에이전트 지원을 추가합니다.

  • LangChain 의 create_agent() 을 통해 LangGraph 에이전트 호출을 위한 측정, 리소스를 추가합니다. 여기에는 invoke(), ainvoke(), stream(), astream() 에 대한 에이전트 통화가 포함됩니다.

지지 성명

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 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 반응, in asyncio.Runner

이번 릴리스에서는 웹 서버에서 헤더가 보고되지 않는 ASGI 측정 및 계측의 버그도 해결되었습니다.

easy_install/pip/distribute 사용하여 에이전트를 설치하세요. 파이썬 패키지 인덱스를 통해 conda 사용하거나, Conda-Forge 패키지 인덱스를 통해 을 사용하거나, 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

특징

• Strands지원을 추가합니다.

  • 단일 및 다중 에이전트(군집, 그래프 등) 설정에서 Strands 도구 및 에이전트에 대한 측정, 리소스 추가

• AWS Bedrock Converse Streaming지원을 추가합니다.

  • Converse API 스트리밍에 대한 모니터링 지원을 추가합니다. 여기에는 converse_stream() 을 사용하여 boto3 및 aioboto3 클라이언트로 수행되는 Converse 채팅 완료 호출에 대한 지원이 포함됩니다.

• 레디스 메서드 지원을 추가합니다.

  • 다음 메서드에 대한 지원을 추가하세요.

    • hybrid_search
    • msetex

• loop_factory 에 대한 지원을 추가합니다. asyncio.Runner

  • 끌어오기 3.11에서는 asyncio.Runner 클래스와 loop_factory 모듈이 추가되었습니다. loop_factory 시위는 루프 정책에 대한 대체 방법을 제공합니다. 이제 생성된 루프는 전역 이벤트 루프 설정을 통하든 사용자 정의 대시보드 루프를 통하든 상관없이 승인됩니다.

• LLM 이벤트에서 LangChain 역할 할당 캡처

  • LangChain LlmChatCompletionMessage 이벤트에는 이제 LangChain 에서 할당된 역할이 포함되어 있습니다.

• LLM 요청 시점의 LLM 이벤트 타임스탬프를 캡처합니다.

  • 이전에는 LLM 이벤트의 타임스탬프가 이벤트 생성 시점에 기록되었습니다. 이제는 LLM 요청 시점에 더욱 정확하게 기록됩니다.

버그 수정

• ASGI 헤더 소비

  • ASGIWebTransaction 이 http.response.start 이벤트의 헤더를 소비할 때, 허용되는 입력 유형을 고려하지 않고 그렇게 했습니다. 헤더가 생성기인 경우 생성기는 process_response() 호출에 의해 소비되어 웹 서버가 보낼 헤더가 남지 않습니다. 이제 이 문제는 해결되었습니다.

지지 성명

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요.

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 끌어 당기는 에이전트 EOL 정책을 참조하세요.