Python agent release notesRSS

Notes

이번 끌어 당기는 에이전트 릴리스에는 끌어당김 3.14 지원, 속성 필터 설정을 위한 새로운 환경 변수, 프로세서 데코레이터의 비동기 생성기 지원, AWS Bedrock 의 추가 모델 및 AWS Kinesis 의 새로운 방법이 추가되었습니다. 이 릴리스에서는 ConnectionPool 여러 번 래핑하여 사용할 때 RecursionError 이 발생하는 aiomysql 의 버그, kombu 의 프로듀서에서 속성이 제대로 전달되지 않는 버그, 하베스트 스레드 내에서 shutdown_agent 호출될 때 발생하는 오류를 수정합니다.

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

특징

• 끌어당김 3.14 지원 추가

  • 끌어오기 3.14에 대한 지원을 추가합니다.

• 속성 필터 설정에 대한 환경 변수 추가

  • 다음 설정은 이제 환경 변수를 통해 설정할 수 있는 옵션이 생겼습니다.

    구성 설정	환경 변수
    attributes.enabled	NEW_RELIC_ATTRIBUTES_ENABLED
    attributes.exclude	NEW_RELIC_ATTRIBUTES_EXCLUDE
    attributes.include	NEW_RELIC_ATTRIBUTES_INCLUDE
    browser_monitoring.attributes.enabled	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
    browser_monitoring.attributes.exclude	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
    browser_monitoring.attributes.include	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
    error_collector.attributes.enabled	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
    error_collector.attributes.exclude	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
    error_collector.attributes.include	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
    span_events.attributes.enabled	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
    span_events.attributes.exclude	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
    span_events.attributes.include	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
    transaction_events.attributes.enabled	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
    transaction_events.attributes.exclude	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
    transaction_events.attributes.include	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
    transaction_segments.attributes.enabled	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLED
    transaction_segments.attributes.exclude	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE
    transaction_segments.attributes.include	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE
    transaction_tracer.attributes.enabled	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
    transaction_tracer.attributes.exclude	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
    transaction_tracer.attributes.include	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE

• 트랜잭션 데코레이터에 비동기 생성기 지원 추가

  • 이전에는 트랜잭션 데코레이터가 비동기 생성기를 감싸는 것을 지원하지 않았습니다. 이 지원이 추가되어 이제 비동기 생성기 트랜잭션이 이벤트 루프 대기 시간과 기타 통계를 자동으로 측정합니다.

• AWS Bedrock 측정, 로그에 추가 모델에 대한 지원 추가

  • 다음 추가 모델을 지원하도록 botocore 및 aiobotocore 통해 AWS Bedrock 측정, 계측을 업데이트합니다.

    • 클로드 소네트 3+ 모델
    • 지역으로 접두사가 붙은 모델(지역 인식)

• 새로운 Kinesis 메서드에 대한 측정, 로그 추가

  • 새로운 AWS Kinesis 메서드를 지원하기 위해 botocore 측정, 리소스 추가

    • describe_account_settings
    • update_account_settings
    • update_max_record_size
    • update_stream_warm_throughput

버그 수정

• aiomysql ConnectionPool에서 RecursionError 방지

  • 이전에는 풀 연결을 사용할 때 aiomysql 에서 RecursionError 이 발생했습니다. 반복적인 래핑으로 인해 풀링된 연결 주위에 깊은 ObjectProxy 체인이 생성되었습니다. 이 문제는 해결되었습니다.

• kombu 의 프로듀서에서 속성이 제대로 전달되지 않는 버그를 수정했습니다.

  • kombu.messaging.Producer.publish() 에 대한 측정, 계측으로 인해 속성이 실수로 사전 내부에 중첩되어 속성이 잘못된 위치에 있고 다운스트림 패키지에서 읽히지 않는 버그를 수정했습니다.

• shutdown_agent 이 수확 스레드 내에서 호출될 때 발생하는 오류를 수정합니다.

  • 이전에는 shutdown_agent 수확 스레드 내에서 호출되면 RuntimeError 이 발생할 수 있었습니다. 이렇게 하면 충돌을 방지하기 위한 보호 장치가 추가되어 문제가 해결됩니다.

지지 성명

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

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

Notes

이 끌어 당기는 에이전트 릴리스는 Django 측정의 초기 활성화, 소스, 무시되는 max_samples_stored 에 대한 서버 측 재정의 및 Python trace_cache.pop() 의 충돌 방지에 대한 수정 사항을 제공합니다.

끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

버그 수정

• Django 측정, 로그의 조기 활성화 방지

  • Django 측정에서 application_settings() 에 대한 호출을 제거하여 pre-fork의 초기 활성화 관련 문제를 방지합니다.

• 서버 설정을 로컬 설정 동기화 문제 수정

  • 이는 event_harvest_config.harvest_limits.* 설정이 *.max_samples_stored 설정으로 인해 더 이상 사용되지 않을 때 발생한 버그를 수정합니다. 일부 서버측 설정이 클라이언트측 설정을 재정의하지 않아 사용자가 이를 비활성화했음에도 불구하고 데이터가 수집기로 전송되었습니다.

• 충돌로부터 보호하세요 trace_cache.pop()

  • ContextOf 클래스에서 기본값 없이 pop(key) 통해 trace_cache 에 안전하지 않은 액세스가 발생했습니다. 사전의 weakref 이 이미 가비지 수집된 경우 충돌이 발생했습니다.

지지 성명

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

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

Notes

이번 릴리스 에이전트에는 다음과 같은 변경 사항이 적용됩니다.

• 끌어당김 3.7에 대한 지원 제거
• 다양한 API 및 설정을 제거하거나 더 이상 사용하지 않습니다.
• aioredis 측정, 로그 사용 중단
• setuptools 의 최소 지원 버전을 올립니다. setuptools_scm
• AutoGen에 대한 새 측정, 로그를 추가합니다.
• Pyzeebe에 대한 새로운 측정, 로그를 추가합니다.
• 새로운 MCP(모델 컨텍스트 프로토콜)라는 이름의 span을 추가합니다.
• psycopg에서 충돌이 발생하는 문제를 해결합니다.
• AI 모니터링이 활성화된 경우에만 MCP 스팬이 기록되도록 보장합니다.

끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

제거된 기능

• 끌어당김 3.7에 대한 지원 제거

  • 끌어3.7은 2023년 6월 27일에 단종되었습니다. 접착제 에이전트가 이에 대한 지원을 중단했습니다.

• 다양한 더 이상 사용되지 않는 API를 제거합니다.

  • 다음 API가 제거되었습니다.

    구형 API	대체 API
    accept_distributed_trace_payload	accept_distributed_trace_headers
    add_custom_parameter	add_custom_attribute
    add_custom_parameters	add_custom_attributes
    create_distributed_trace_payload	insert_distributed_trace_headers
    get_browser_timing_footer	이 기능은 get_browser_timing_header()에 래핑되었습니다.
    record_exception	notice_error()
    NewRelicLogHandler	NewRelicLogForwardingHandler
    lambda_handler & LambdaHandlerWrapper	이러한 API는 newrelic-lambda 패키지로 이동되었습니다.

• 다양한 더 이상 사용되지 않는 설정을 제거합니다.

  • 다음 설정이 제거되었습니다.

    구형 설정	교체 설정
    transaction_tracer.capture_attributes	transaction_tracer.attributes.enabled
    error_collector.capture_attributes	error_collector.attributes.enabled
    browser_monitoring.capture_attributes	browser_monitoring.attributes.enabled
    analytics_events.enabled	transaction_events.enabled
    analytics_events.capture_attributes	transaction_events.attributes.enabled
    error_collector.ignore_errors	error_collector.ignore_classes
    strip_exception_messages.whitelist	strip_exception_messages.allowlist
    ssl	이제 이 항목은 true 에 하드코딩되어 설정 옵션에서 제거되었습니다.
    ignored_params	대신 newrelic.attributes.exclude = request.parameters.{name} 사용하세요. 각 요청 템플릿, 키를 쉼표로 구분하여 newrelic.attributes.exclude 목록에 추가합니다. 키 앞에 request.parameters 꼭 추가하세요.
    agent_limits.merge_stats_maximum	이제 서버 측 구성을 선호하여 이 문제는 완전히 무시되었습니다.

더 이상 사용되지 않는 기능

• aioredis 에 대한 측정, 사용이 더 이상 사용되지 않습니다.

  • aioredis 패키지는 더 이상 사용되지 않으며, 이제 하위 모듈 redis.asyncio 포함된 redis가 사용됩니다. 결과적으로 aioredis 에 대한 측정, 계측도 더 이상 사용되지 않습니다. 대신 redis 라이브러리를 사용하세요. 이 측정, 로그는 향후 릴리스에서 제거될 예정입니다.

• 다른 언어 에이전트와 일치하도록 일부 기존 수확 설정을 더 이상 사용하지 않습니다.

  • 다른 언어 에이전트의 규칙과 일관성을 유지하기 위해 다음 수확 설정은 더 이상 사용되지 않습니다.

    구형 설정	교체 설정
    event_harvest_config.harvest_limits.analytic_event_data	transaction_events.max_samples_stored
    event_harvest_config.harvest_limits.span_event_data	span_events.max_samples_stored
    event_harvest_config.harvest_limits.error_event_data	error_collector.max_event_samples_stored
    event_harvest_config.harvest_limits.custom_event_data	custom_insights_events.max_samples_stored
    event_harvest_config.harvest_limits.log_event_data	application_logging.forwarding.max_samples_stored

    이는 이러한 설정의 이름을 *.max_samples_stored 에서 event_harvest_config.harvest_limits.* 형식으로 변경한 이전 변경 사항을 되돌린 것입니다. 이 결정은 뒤집혔고, 원래 설정은 이러한 설정 이름을 변경하지 않은 다른 언어 에이전트와 일치하도록 복원되었습니다. 더 이상 사용되지 않는 설정은 현재로는 계속 작동하지만, 향후 릴리스에서는 제거될 예정입니다.

• WSGI 환경 사전을 통해 에이전트 설정을 더 이상 사용하지 않습니다.

  • 이전에는 WSGI environ 사전을 통해 구성할 수 있었던 다음 설정은 더 이상 사용되지 않습니다. 환경 변수나 구성 파일을 통해 이러한 설정을 구성하세요.

    • newrelic.set_background_task
    • newrelic.suppress_apdex_metric
    • newrelic.suppress_transaction_trace
    • newrelic.capture_request_params
    • newrelic.disable_browser_autorum

• setuptools<61.2 또는 를 사용하여 에이전트를 빌드하는 데 대한 지원을 더 이상 사용하지 않습니다. setuptools_scm<6.4

  • setuptools 및 setuptools_scm 의 최소 지원 버전이 각각 61.2 및 6.4 으로 증가했습니다. 이는 패키지 메타데이터 구성 및 빌드 지침에 pyproject.toml 를 사용할 수 있도록 지원하기 위한 것입니다. 이제 에이전트는 더 현대적인 빌드 도구로 빌드될 수 있으며, 더 이상 pyproject.toml 파일이 없다는 경고를 발생시키지 않습니다.
  • 이 변경 사항은 패키지 newrelic.__version__ 및 newrelic.__version_tuple__ 에 새로운 버전 속성을 추가합니다. 이를 통해 런타임에 에이전트 버전을 프로그래밍 방식으로 확인할 수 있습니다.

새로운 기능

• AutoGen에 대한 새 측정, 로그를 추가합니다.

  • AutoGen의 에이전트 및 도구에 대한 측정, 로그(명명된 범위 및 사용자 정의 Llm 이벤트)를 추가합니다.

• Pyzeebe에 대한 새로운 측정, 로그를 추가합니다.

  • Pyzeebe에 대한 자동 측정, 리소스 및 프레임워크 관련 에이전트 속성을 추가합니다.

• 새로운 MCP(모델 컨텍스트 프로토콜)라는 이름의 span을 추가합니다.

  • Streamable HTTP를 지원하기 위해 도구 관리자를 통해 수행된 MCP(모델 컨텍스트 프로토콜) 도구 호출에 대한 새로운 명명된 스팬을 추가합니다.

버그 수정

• psycopg>=3.2.0 에서 호출 시 발생하는 충돌을 수정합니다. as_string()

  • as_string() 메서드가 더 이상 인수를 필요로 하지 않아 잠재적인 충돌을 일으키는 psycopg>=3.2.0 의 문제를 해결합니다. 이 문제는 해결되었으며, 이 메서드의 두 가지 서명이 모두 지원됩니다.

• AI 모니터링이 활성화된 경우에만 MCP(모델 컨텍스트 프로토콜) 스팬이 기록되도록 보장합니다.

  • MCP(모델 컨텍스트 프로토콜) 스팬은 설정 ai_monitoring.enabled 활성화된 경우에만 기록됩니다.

지지 성명

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

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

Notes

이번 릴리스 에이전트에는 다음에 대한 지원이 추가되었습니다.

• Celery의 사용자 정의 작업
• 그래핀-Django 모니터링
• Django의 미들웨어 필터링
• AWS Bedrock Converse API
• W3CTraceParent 헤더 샘플링 플래그

이 릴리스에서는 다음과 같은 수정 사항도 제공됩니다.

• GraphQL에서 가장 깊은 고유 경로에 대한 보호 장치
• 웹 URL 요청 구문 분석을 위한 보안 조치
• ElasticSearch 및 GraphQL에 대한 대체 trace.settings==None
• 비동기 ElasticSearch 클라이언트 목록에서 options 메서드 제거

끌어오기 패키지 색인을 통해 easy_install/pip/distribute 사용하여 에이전트를 설치하거나 뉴렐릭 다운로드 사이트 에서 직접 다운로드하세요.

새로운 기능

• Celery에서 사용자 정의 작업에 대한 지원을 추가합니다.

  • Celery 에서 사용자 정의 작업 클래스에 대한 모니터링 지원을 추가합니다. 이전에는 기본 작업 클래스를 사용하는 작업만 모니터링할 수 있었습니다. 참고: 이 버전의 끌어당김 에이전트는 더 이상 v5.2.0 미만의 Celery 버전을 지원하지 않습니다.

• Graphene-Django에 대한 지원을 추가합니다.

  • Graphene-Django 로 생성된 동기 스키마에 대한 모니터링 지원을 추가합니다. 이전에는 Graphene-Django로 생성된 스키마가 부분적으로만 모니터링되어 GraphQL 관련 속성이 누락되었습니다.

• Django에서 미들웨어 필터링에 대한 지원을 추가합니다.

  • 이제 사용자는 모니터링할 Django 미들웨어를 필터링할 수 있습니다. 이제 세 가지 추가 설정이 있습니다.

    • instrumentation.middleware.django.enabled (기본값은 true 입니다)
    • instrumentation.middleware.django.exclude
    • instrumentation.middleware.django.include

  자세한 내용과 예제는 Django 미들웨어 필터링 페이지를 참조하세요.

• AWS Bedrock Converse API에 대한 지원을 추가합니다.

  • 스트리밍이 아닌 Converse API에 대한 모니터링 지원을 추가합니다. 여기에는 boto3 및 aioboto3 클라이언트를 사용하여 수행된 converse 채팅 완료 호출에 대한 지원이 포함됩니다.

• W3CTraceParent 헤더 샘플링 플래그에 대한 지원을 추가합니다.

  • 업스트림 서비스가 샘플링 플래그가 설정된 W3CTraceParent 헤더를 보내면 뉴렐릭은 currentResources를 샘플링할지 여부를 결정할 때 해당 샘플링 결정을 고려합니다.

• 원격 부모가 샘플링되었는지 여부에 따라 샘플링 결정에 대한 지원이 추가되었습니다.

  • 두 가지 새로운 설정 옵션에 대한 지원이 추가되었습니다.

    • distributed_tracing.sampler.remote_parent_sampled
    • distributed_tracing.sampler.remote_parent_not_sampled

  • default 기본 동작이며 이 변경 이전과 동일하게 동작합니다(트랜잭션을 샘플링할지 여부를 결정하기 위해 샘플링 결정을 적응형 샘플링 알고리즘에 전달함).

  • always_on 즉, 원격 부모가 샘플링되었거나 샘플링되지 않은 트레이스는 항상 샘플링됩니다.

  • always_off 즉, 원격 부모가 샘플링되었거나 샘플링되지 않은 원격 부모가 있는 트레이스는 절대 샘플링되지 않습니다.

버그 수정

• GraphQL에서 가장 깊은 고유 경로에 대한 보호 기능 추가

  • 일부 사용자는 GraphQL 에서 필드 이름이 None 반환하여 가장 깊은 고유 경로가 생성되지 않는 문제를 경험했습니다. 이 문제는 해결되었습니다.

• 웹 요청 구문 분석을 위한 보호 기능 추가

  • 일부 사용자는 request_uri 잘못 형식화되었거나 잘못된 문자를 포함하고 있어 구문 분석 오류를 경험했습니다. 요청 헤더의 request_uri 이 유효하지 않고 원래 제공된 (유효한) URL과 일치하지 않는 경우 이 문제가 발생할 수 있습니다. 이 보호 장치는 현재 뉴렐릭에 적용되었지만, urllib 에서는 2025년 1월 31일 이후에 출시된 버전에 대한 이 문제를 해결했습니다.

• ElasticSearch 및 GraphQL에서 충돌을 수정합니다. trace.settings==None

  • trace.settings 이 None 인 경우 ElasticSearch에 대한 측정, 리소스가 작동을 중단했습니다. global_settings 대안이 마련되었습니다. 이는 GraphQL에서 발견되는 동일한 문제를 해결합니다.

• 비동기 ElasticSearch 클라이언트 목록에서 options 메서드 제거

  • 이전 측정, ElasticSearch의 계측은 options 비동기 메서드 목록에 있기 때문에 충돌이 발생했습니다. 이 메서드는 어떠한 데이터스토어 작업/requests 도 수행하지 않으므로 더 이상 DatastoreTrace 에 래핑되지 않습니다.

지지 성명

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

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