Python agent release notesRSS

Notes

This release of the Python agent removes support for Python lambda function in the config file, excludes the newrelic header by default, adds support for exclude and include settings for Hybrid Agent traces, anthropic instrumentation, gemini response streaming, improves caching of IS_PYPY in gc_data.py for performance, and adds http.statusCode attribute in transaction events. This release also resends modules during reconnect ensuring they are recorded, guards garbage collection metrics against re-entrant calls, fixes task propagation in async generators and starlette context propagation in StreamingResponse.

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

• Remove support for Python lambda functions in the config file

  • Previously, the agent allowed specifying a Python lambda function to dynamically name transactions, background task, database trace, profile trace, external trace url and method, function trace, generator trace, and memcache trace. Since support for this feature exposes a security vulnerability in the agent this feature is being removed.

Deprecations

• The response.status attribute in WebTransactions is considered deprecated and will be removed in the upcoming 14.0.0 release. It is being replaced by http.statusCode. We recommend replacing all references to response.status with http.statusCode.

New features

• Exclude the newrelic header by default

  • The newrelic distributed tracing header is now no longer sent by default. Only the W3C traceparent and tracestate headers will be sent.

• Add exclude and include settings for Hybrid Agent traces

  • opentelemetry.traces.include for the configuration file or NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE to be used as an environment variable
  • opentelemetry.traces.exclude for the configuration file or NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE to be used as an environment variable

  The Hybrid Agent's default behavior will be different as well. Now, only libraries and tracers that are supported by OpenTelemetry but not already supported by New Relic will utilize OpenTelemetry's instrumentation. Otherwise, the agent will default to the New Relic instrumentation hooks.

  More information about these settings can be found in the Python Agent configuration page as well as the OpenTelemetry API support page.

• Add Anthropic streaming instrumentation

  • Adds instrumentation support for anthropic.

• Improve caching of IS_PYPY in gc_data.py for performance

• Now checks and caches IS_PYPY once when the module is loaded.

• Add Gemini response streaming

  • Add response streaming support to Gemini through the google-genai package.

• Add http.statusCode attribute to transaction events

  • To conform with the rest of the language agents, the Python agent now sends the http status to the WebTransaction attribute http.statusCode. The Python agent will continue to send the attribute to response.status as well, but the response.status attribute will be removed in the future.

Bugs

• Resend modules during reconnect

  • The agent previously only sent the module list periodically after the first connect cycle. If the agent reconnected to the collector, this data would not be resubmitted, so the UI would no longer show the module data. This has now been fixed.

• Guard garbage collection metrics against re-entrant calls

  • Adds a flag to prevent re-entrant calls to _GCDataSource.record_gc() to prevent infinite recursion on Python 3.13+.

• Enable task propagation in async generators

  • Fixes an issue where AsyncGeneratorProxy would not properly handle transaction context propagation if spread over multiple tasks.

• Fix Starlette context propagation in StreamingResponse

  • Adds trace context propagation to starlette StreamingResponse for both synchronous and asynchronous generators.

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

이번 릴리스 에이전트는 첫 번째로 시간에 대한 지원을 추가하고 호환되지 않는 Flask add_url_rule 함수 서명을 수정합니다.

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

새로운 기능

• LLM 응답 스트림의 첫 번째 토큰에 시간을 추가했습니다.

  • 에이전트는 OpenAI 및 Bedrock 응답 스트림에 대한 LlmChatCompletionSummary 이벤트에 새로운 속성 time_to_first_token 기록합니다. 이 속성은 최초 요청과 응답에서 수신된 첫 번째 토큰 사이의 기간을 측정합니다.

버그 수정

• Flask add_url_rule 함수 시그니처 불일치 문제 해결

  • Flask 의 측정, 계측 기능을 업데이트하여 add_url_rule 함수의 시그니처를 Flask 네이티브 구현과 일치시켰습니다. 이 수정 사항은 이전 서명 불일치로 인해 발생할 수 있는 애플리케이션 충돌을 방지합니다.

지지 성명

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

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

Notes

이번 릴리스에서는 끌어 당기는 힘 Tracing(CAT), 끌어당김 3.8 및 번들로 제공되는 SSL 인증에 대한 지원이 제거됩니다. 또한 모든 벤더링 패키지를 최신 버전으로 업데이트하고, 자유 스레드 CPython, Windows 운영 체제 및 Microsoft AG2(Autogen)용 개선된 측정 및 계측 기능을 지원합니다. 또한 이번 릴리스에는 certifi를 통해 SSL 인증서를 설치할 수 있는 새로운 선택적 추가 기능이 포함되어 있습니다. 이번 릴리스에서는 Strands 측정에서 중복 예외가 보고되는 버그도 수정되었습니다.

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

제거된 기능

• CAT(잡잡 추적)이 제거되고 DT(독일 추적)가 사용됩니다.

  • CAT(낚싯대 추적)은 에이전트 버전 7.0.0.166에서 더 이상 사용되지 않으며, 이번 릴리스에서는 제거되었습니다. 아직도 CAT(강력 추적)을 사용하고 계시다면 중단을 피하기 위해 가능한 한 빨리 DT(절당 추적)로 전환하는 것이 좋습니다.

• 번들로 제공되던 SSL 인증서가 제거되었습니다.

  • 환경에 인증서가 필요한 경우 운영 시스템의 패키지 매니저를 통해 인증서를 설치하거나 선택적 newrelic[certificates] extra를 사용하여 에이전트를 설치할 수 있습니다.

• 끌어오기 3.8 지원이 제거되었습니다.

  • 끌어오기 3.8은 2024-10-07에 수명이 종료되어 더 이상 에이전트에서 지원되지 않습니다. 끌어당김 에이전트에 대한 업데이트를 계속 받으려면 끌어당김 지원 버전으로 업그레이드하는 것을 고려해 보십시오.

보안

• 모든 내부 패키지가 최신 버전으로 업데이트되었습니다.

  • urllib3 버전 2.6.3으로 업데이트되었습니다.
    • 이번 릴리스 날짜 기준으로 urllib3 에 있는 모든 미해결 CVE가 수정되었습니다.
  • opentelemetry_proto 버전 1.40.0으로 업데이트되었습니다.
  • wrapt 버전 2.1.2로 업데이트되었습니다.
  • asgiref 버전 3.11.1로 업데이트되었습니다.

새로운 기능

• certifi를 통해 SSL 인증서를 설치하기 위한 새로운 newrelic[certificates] 추가 기능입니다.

  • 이제 에이전트는 번들로 제공되는 SSL 인증서를 설치하는 데 사용할 수 있는 선택적 newrelic[certificates] 추가 기능을 제공합니다. 이는 인증서가 필요하지만 운영 시스템의 패키지 매니저를 통해 인증서를 설치할 수 없는 사용자를 위한 것입니다.

• 자유 스레드 CPython 지원

  • Python 3.13부터 CPython은 전역 인터프리터 잠금(GIL)이 비활성화된 Python 빌드를 배포하여 진정한 멀티스레딩을 지원합니다.
  • 이번 릴리스에서는 이러한 동작에 대한 지원이 추가되어 에이전트가 자유 스레드 환경에서 안전하게 실행될 수 있습니다.
  • 이번 릴리스에는 Linux 및 Windows용 자유 스레드 CPython용 사전 빌드된 바이너리도 포함되어 있어 이러한 환경에 쉽게 설치할 수 있습니다.

• Windows 지원

  • 이번 릴리스에는 Windows에서 CPython 3.13 이상 버전용으로 미리 빌드된 바이너리가 포함되어 있습니다.
  • 참고로, 타이머 해상도 편차가 크기 때문에 Python 3.12 이하 버전은 Windows 에서 공식적으로 지원되지 않습니다. 소스 코드에서 해당 도구를 설치하고 사용하는 것은 여전히 가능하지만, 사용자는 타이밍 데이터가 부정확하여 문제가 발생할 수 있으며 최상의 환경을 위해서는 파이썬 3.13 이상으로 업그레이드하는 것이 좋습니다.

• Microsoft AG2(Autogen)에 대한 향상된 측정, 로그

  • 비동기 생성기 메서드 on_messages_stream() 통한 스트리밍 응답 지원이 추가되었습니다.
  • 측정, 도구에는 이제 도구 또는 에이전트 호출을 나타내는 범위에 대한 subcomponent 속성이 포함됩니다. 이는 뉴렐릭 UI 에서 더욱 향상된 회의 매핑을 제공하는 데 사용됩니다.

벌레

• Strands 에이전트의 중복 예외

  • Strands를 업데이트한 후 일부 예외를 새로운 EventLoopException 유형으로 캡슐화하면서 중복 오류가 보고될 수 있습니다. 이 문제는 해결되었으며, 근본적인 오류는 한 번만 보고될 것입니다.

지지 성명

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

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

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 정책을 참조하세요.