Python agent release notesRSS

Notes

이번 파이썬 에이전트 릴리스에서는 Azure App Services에 대한 활용, Azure Service Bus에 대한 계측, 새로운 Kinesis 메서드에 대한 지원 및 v2.10.0 이상에 대한 Google ADK 지원을 추가합니다. 이번 릴리스에서는 setup.py 설치 파일뿐만 아니라 httplib에서 분산 트레이스 헤더가 중복되는 문제도 수정합니다.

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

제거된 기능

• 파이썬 3.9에 대한 지원을 제거했습니다.

  * 파이썬 3.9는 2025년 10월 31일에 수명이 종료되었으며 에이전트에서 더 이상 지원하지 않습니다. 파이썬 에이전트의 업데이트를 계속 받으려면 애플리케이션을 지원되는 파이썬 버전으로 업그레이드하시기 바랍니다.

새로운 기능

• Azure App Service 사용률

  • 엔티티 관계 매핑을 활성화하기 위해 Azure App Service 사용률이 추가되었습니다.
  • 또한 새로운 설정이 추가되었습니다, utilization.detect_azureappservice

• Azure Service Bus에 대한 새로운 계측

  • Microsoft Azure Service Bus에 대한 계측이 추가되었습니다.

• 새로운 Kinesis 메서드를 위한 새로운 계측

  • 이제 Kinesis에서 update_stream_record_distribution_strategy 메서드가 지원됩니다.

보안 업데이트

• urllib3의 모든 현재 CVE를 해결하기 위해 내부 urllib3 패키지가 2.8.0 (으)로 업데이트되었습니다.

  • 이는 현재까지 에이전트에 알려진 모든 CVE를 해결합니다.

향상된 기능

• Google ADK v2.10.0 이상 버전을 지원합니다.

  • 버전 2.10.0 이상의 Google ADK에 대한 계측이 업데이트되었습니다.

벌레

• httplib의 중복된 분산 추적 헤더

  • httplib 계측이 traceparent에 대해 중복 헤더를 생성하여 잘못된 형식의 값을 초래할 수 있는 문제를 수정했습니다.

• setup.py 이제 설치 파일이 지원되는 모든 파이썬 버전에서 작동합니다

  • 사용자가 setup.py 파일을 직접 사용하여 파이썬 3.12 이상에 파이썬 에이전트를 설치하려는 경우 ImportError에 직면하게 됩니다. 이는 파이썬 3.10부터 distutils이(가) 더 이상 사용되지 않으며 파이썬 3.12의 표준 라이브러리에서 완전히 제거되었기 때문입니다.

지지 성명

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

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

Notes

이번 파이썬 에이전트 릴리스는 botocore(SigV4)의 서명된 헤더 문제를 수정합니다.

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

벌레

• botocore (SigV4)의 서명된 헤더 문제를 수정했습니다

  • 중복 헤더가 전송되는 것을 방지하기 위해 botocore 분산 추적 헤더에 대한 이전 변경 사항이 되돌려졌습니다.
  • 이전에는 다른 추적 라이브러리에서 생성된 모든 분산 추적 헤더가 헤더 서명으로 인해 botocore의 계측에 문제를 일으킬 수 있었습니다. botocore 내에서 이러한 헤더에 대한 서명을 비활성화하여 이 문제가 해결되었습니다.

지지 성명

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

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

Notes

이번 파이썬 에이전트 릴리스에서는 OpenSearch, Microsoft Azure SQL, 새로운 Kinesis 메서드 및 새로운 browser_monitoring.version 설정에 대한 지원이 추가되었습니다. 또한, Anthropic, MCP 및 Google ADK 계측이 개선되었습니다. 이번 릴리스에서는 botocore(SigV4)의 서명된 헤더 및 Gemini 도구 구문 분석과 관련된 문제도 수정되었습니다.

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

새로운 기능

• opensearch-py를 위한 새로운 계측

  • 공식 OpenSearch 데이터베이스 커넥터에 대한 계측이 추가되었습니다.

• mssql-python에 대한 새로운 계측

  • Microsoft Azure SQL에 대한 계측이 추가되었습니다.

• 새로운 Kinesis 메서드를 위한 새로운 계측

  • 이제 Kinesis에서 다음 메서드가 지원됩니다:

    • create_channel
    • delete_channel
    • describe_channel
    • list_channels
    • update_channel

• 다음에 대한 새로운 설정 browser_monitoring.version

  • 새로운 설정 browser_monitoring.version을(를) 통해 사용자는 삽입할 브라우저 모니터링 에이전트의 특정 버전을 지정할 수 있습니다.
  • 선택할 수 있는 지원되는 브라우저 에이전트 버전 목록을 참조하십시오.

개선된 기능

• anthropic 지원 개선.

  • 버전 1.0.0 이상의 Anthropic SDK에 대한 요청 파라미터 파싱이 개선되었습니다.
  • Messages.with_raw_response.create을(를) 통한 응답에 대한 새로운 파싱을 통해 LangChain과의 호환성이 향상되었습니다.

• mcp v2.0.0 이상을 지원합니다.

  • mcp v2.0.0에서 수행된 주요 리팩터링에 따라 계측이 업데이트되었으며 다시 예상대로 작동합니다.

• Google ADK v2.9.0 이상 지원.

  • 버전 2.9.0 이상에서 Google ADK에 대한 계측이 업데이트되었습니다.

벌레

• botocore (SigV4)의 서명된 헤더 문제를 수정했습니다

  • 이전에는 다른 추적 라이브러리에서 생성된 분산 추적 헤더가 헤더 서명으로 인해 botocore의 계측에 문제를 일으킬 수 있었습니다. 이 문제가 수정되었으며, 이제 서명 전에 분산 추적 헤더가 변경됩니다.

• Gemini 도구 파싱 수정

  • 이전에는 Gemini로 생성된 도구의 일부 인스턴스가 파싱에 실패하고 조용히 실패하여 해당 특정 요청에 대한 응답이 없었습니다. 이 문제가 수정되었습니다.

지지 성명

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

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

Notes

이번 파이썬 에이전트 릴리스에서는 Azure CosmosDB에 대한 지원을 추가하고, HTTPX2 및 새로운 LangChain/LangGraph 스트리밍 이벤트 API에 대한 계측을 추가하며, 최신 OpenTelemetry 데이터베이스 시맨틱 규칙에 대한 지원을 추가하고, 불완전한 패키지 보고, 패키지 조회 성능 저하, MySQL 데이터베이스 이름 보고 버그를 포함한 여러 문제를 해결합니다.

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

새로운 기능

• Azure CosmosDB 지원 추가

  • 이제 파이썬 에이전트는 Azure Cosmos DB 클라이언트 작업을 계측하여 azure-cosmos SDK를 통해 수행되는 데이터베이스, 컨테이너 및 사용자 작업에 대한 데이터스토어 메트릭과 트레이스를 보고합니다.

• HTTPX2 지원을 추가했습니다.

  • 이제 파이썬 에이전트는 Pydantic 팀에서 적극적으로 유지 관리하는 HTTPX2의 포크인 HTTPX를 지원합니다. HTTPX2에 대한 외부 호출 계측은 동기 및 비동기 클라이언트 모두에 대한 에이전트의 기존 HTTPX 지원을 반영합니다.

• LangChain/LangGraph 스트리밍 이벤트 계측을 추가했습니다.

  • LangChain 에이전트에 대한 astream_events 계측 지원이 추가되었습니다.
  • GraphRunStream 객체에 대한 반복을 포함하여 LangChain/LangGraph v3에 대한 stream_events/astream_events 계측을 추가했습니다.

• 최신 OpenTelemetry 데이터베이스 시맨틱 규칙 지원 추가

  • OpenTelemetry와 함께 파이썬 에이전트를 실행할 때(하이브리드 에이전트 모드), 에이전트는 이제 구형 및 최신 OpenTelemetry 데이터베이스 스팬 속성 이름(db.name/db.namespace, db.statement/db.query.text, db.mongodb.collection/db.collection.name)을 모두 읽으므로 OpenTelemetry 계측 라이브러리가 내보내는 시맨틱 규칙 버전에 관계없이 데이터베이스 트레이싱이 계속 올바르게 작동합니다.

벌레

• 뉴렐릭에 대한 불완전한 패키지 보고를 수정했습니다.

  • 이전에는 느린 하베스트 주기 동안 할당된 고정 시간 창보다 모듈 검색에 시간이 더 오래 걸리고 에이전트 재시작 후 패키지 목록이 새로 고쳐지지 않은 경우, 파이썬 에이전트가 뉴렐릭에 보고된 환경 데이터에서 일부 설치된 패키지를 누락할 수 있었습니다. 이제 패키지 캡처가 빠른 하베스트 주기 동안 실행되고 에이전트 종료/재시작 시 완전히 다시 캡처되므로 보고된 패키지 목록이 완전합니다.

• 패키지 버전 조회의 오버헤드를 줄였습니다.

  • 이전에는 설치된 패키지 버전을 조회할 때마다 모든 패키지에 대해 파일 시스템을 다시 스캔하여 에이전트 초기화 중 설치된 패키지 수에 비례하는 O(n^2) 시간 페널티가 발생했습니다. 이 오버헤드를 방지하기 위해 이제 첫 번째 조회 후 importlib.metadata.packages_distributions()의 결과가 캐시됩니다.

• 지정된 애플리케이션을 올바르게 통과하도록 get_linking_metadata을(를) 수정했습니다.

  • 이전에는 newrelic.agent.get_linking_metadata(application=...)을(를) 호출하면 application 인수를 무시하고 항상 기본 애플리케이션에 대한 연결 메타데이터를 반환했습니다. 이는 둘 이상의 애플리케이션에 보고하는 프로세스에 영향을 미쳤습니다. 지정된 애플리케이션이 이제 올바르게 전달됩니다.
  • 기여해 주신 ckarnell 님께 감사드립니다!

• database 키워드 인수를 사용할 때 MySQL 데이터베이스 이름 보고를 수정했습니다.

  • 이전에는 에이전트가 mysql-connector-python 연결 인수에서 데이터베이스 이름을 구문 분석할 때 구형 db 키워드 인수만 확인했기 때문에 최신 database 키워드 인수를 사용하여 만든 연결은 데이터스토어 메트릭에 데이터베이스 이름을 보고하지 않았습니다. 이제 에이전트는 database을(를) 먼저 확인하고 db(으)로 대체합니다.

• LangGraph v1.1+ GraphOutput 값에 액세스할 때 발생하는 경고 수정

  • 이전에는 LangGraph v1.1+ 계측이 더 이상 사용되지 않는 항목 액세스 구문을 사용하여 GraphOutput 반환 값에 액세스하여 사용 중단 경고를 트리거했습니다. 이제 에이전트는 GraphOutput.value을(를) 직접 읽습니다.

지지 성명

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

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