Python agent release notesRSS

Notes

이번 파이썬 에이전트 릴리스에서는 구성 파일의 파이썬 Lambda 함수에 대한 지원을 제거하고, 기본적으로 newrelic 헤더를 제외하며, 하이브리드 에이전트 트레이스에 대한 제외 및 포함 설정, anthropic 계측, gemini 응답 스트리밍에 대한 지원을 추가하고, 성능을 위해 gc_data.py 에서 IS_PYPY의 캐싱을 개선하며, 트랜잭션 이벤트에 http.statusCode 속성을 추가합니다. 이번 릴리스에서는 또한 재연결 중에 모듈을 다시 전송하여 기록되도록 보장하고, 재진입 호출로부터 가비지 컬렉션 메트릭을 보호하며, 비동기 생성기에서의 작업 전파 및 StreamingResponse에서의 starlette 컨텍스트 전파를 수정합니다.

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

제거된 기능

• 구성 파일에서 파이썬 Lambda 함수 지원 제거

  • 이전에는 에이전트에서 파이썬 Lambda 함수를 지정하여 트랜잭션, 백그라운드 작업, 데이터베이스 트레이스, 프로필 트레이스, 외부 트레이스 URL 및 메서드, 함수 트레이스, 제너레이터 트레이스 및 memcache 트레이스의 이름을 동적으로 지정할 수 있었습니다. 이 기능을 지원하면 에이전트의 보안 취약점이 노출되므로 이 기능은 제거됩니다.

사용 중단

• WebTransaction의 response.status 속성은 더 이상 사용되지 않는 것으로 간주되며 다가오는 14.0.0 릴리스에서 제거될 예정입니다. http.statusCode(으)로 대체됩니다. response.status 에 대한 모든 참조를 http.statusCode(으)로 교체할 것을 권장합니다.

새로운 기능

• 기본적으로 newrelic 헤더를 제외합니다

  • 이제 newrelic 분산 추적 헤더는 더 이상 기본적으로 전송되지 않습니다. W3C traceparent 및 tracestate 헤더만 전송됩니다.

• 하이브리드 에이전트 트레이스에 대한 제외 및 포함 설정 추가

  • opentelemetry.traces.include 설정 파일 또는 환경 변수로 사용할 NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE 의 경우
  • opentelemetry.traces.exclude 설정 파일 또는 환경 변수로 사용할 NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE 의 경우

  하이브리드 에이전트의 기본 동작 또한 다를 것입니다. 이제 OpenTelemetry에서 지원하지만 뉴렐릭에서는 아직 지원하지 않는 라이브러리 및 트레이서만 OpenTelemetry의 계측을 활용합니다. 그렇지 않으면 에이전트는 뉴렐릭 계측 후크를 기본값으로 사용합니다.

  이러한 설정에 대한 자세한 내용은 파이썬 에이전트 설정 페이지와 OpenTelemetry API 지원 페이지에서 확인할 수 있습니다.

• Anthropic 스트리밍 계측 추가

  • anthropic에 대한 계측 지원을 추가합니다.

• 성능을 위해 gc_data.py에서 IS_PYPY의 캐싱 개선

• 이제 모듈이 로드될 때 IS_PYPY를 한 번 확인하고 캐시합니다.

• Gemini 응답 스트리밍 추가

  • google-genai 패키지를 통해 Gemini에 응답 스트리밍 지원을 추가합니다.

• 트랜잭션 이벤트에 http.statusCode 속성 추가

  • 나머지 언어 에이전트와 일치하도록 파이썬 에이전트는 이제 http 상태를 WebTransaction 속성 http.statusCode에 전송합니다. 파이썬 에이전트는 response.status 에도 속성을 계속 전송하지만, response.status 속성은 향후 제거될 예정입니다.

벌레

• 재연결 중 모듈 재전송

  • 이전에는 에이전트가 첫 번째 연결 주기 이후에 주기적으로만 모듈 목록을 전송했습니다. 에이전트가 수집기에 다시 연결되더라도 이 데이터는 다시 제출되지 않으므로 UI에 모듈 데이터가 더 이상 표시되지 않습니다. 이제 수정되었다.

• 재진입 호출로부터 가비지 컬렉션 메트릭을 보호합니다.

  • 파이썬 3.13 이상에서 무한 재귀를 방지하기 위해 _GCDataSource.record_gc() 에 대한 재진입 호출을 방지하는 플래그를 추가합니다.

• 비동기 제너레이터에서 작업 전파 활성화

  • 여러 작업에 분산될 경우 AsyncGeneratorProxy 이(가) 트랜잭션 컨텍스트 전파를 제대로 처리하지 못하는 문제를 수정합니다.

• Starlette 컨텍스트 전파 수정 StreamingResponse

  • 동기 및 비동기 제너레이터 모두에 대해 starlette StreamingResponse 에 트레이스 컨텍스트 전파를 추가합니다.

지지 성명

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

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

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