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