Python agent release notesRSS

Notes

This release of the Python agent adds support for time to first token and fixes an incompatible Flask add_url_rule function signature.

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.

New features

• Added time to first token for LLM response streams:

  • The agent records a new attribute,time_to_first_token on LlmChatCompletionSummary events for OpenAI and Bedrock response streams. This attribute measures the duration between the initial request and the first token received in the response.

Bugs fixes

• Resolved Flask add_url_rule function signature mismatch

  • Updated the instrumentation for Flask's to align its add_url_rule function signature with the native Flask implementation. This fix prevents potential application crashes caused by the previous signature mismatch.

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

이번 릴리스에서는 끌어 당기는 힘 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 정책을 참조하세요.

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