Python agent release notesRSS

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을(를) 직접 읽습니다.

레디스 v8.10.0 및 redis-py v8.1.0에 도입된 레디스 명령을 추가했습니다.

• 이제 파이썬 에이전트는 레디스에서 최근 추가된 다음 명령을 지원합니다:

  • himport_discard_all
  • himport_discard
  • himport_prepare
  • lmovem
  • nrange
  • nrevrange
  • querylabels
  • read
  • sdiffcard
  • sunioncard
  • aliaslist

MCP 도구를 사용할 때 Gemini에서 누락된 LlmChatCompletion 이벤트를 수정했습니다.

• 이전에는LlmChatCompletionMessages LlmChatCompletionSummary 응답 형식이 기본 JSON이 아닌 경우 LangChain 에이전트에서 도구를 사용할 때 Gemini 에서 및 이벤트가 누락되었습니다. 이 문제가 해결되었습니다.

LangChain 및 에이전트 프레임워크에서 트레이스 캐시 ID로 교체되었습니다.

• 컨텍스트 전파 목적으로 LangChain 및 에이전트 프레임워크 계측을 교체하여 참조 속성에 전체 트레이스 대신 트레이스 캐시 ID만 저장하십시오. 이는 누출이 발생할 경우 이러한 객체가 예기치 않게 직렬화되는 것을 방지하기 위함입니다. 트레이스에는 수 MB의 데이터가 포함될 수 있는 반면 ID는 훨씬 작은 객체입니다.

AI 모니터링 서버 측 설정 지원 추가

• 이제 파이썬 에이전트는 AI 모니터링의 서버 측 설정 을 지원합니다. 설정된 경우 서버 측 ai_monitoring.enabled, ai_monitoring.record_content.enabled 및 ai_monitoring.streaming.enabled 값이 로컬 설정보다 우선합니다.

에이전트 프레임워크를 통한 Bedrock 호출에 대한 컨텍스트 전파를 추가합니다.

• Microsoft 에이전트 프레임워크의 Bedrock 통합으로 생성된 스레드 경계를 넘어 트레이스 컨텍스트를 전파합니다. 이를 통해 에이전트의 기존 botocore 계측이 에이전트 프레임워크를 통해 이루어진 Bedrock 호출에 대한 LLM 이벤트를 캡처할 수 있습니다. 이는 에이전트 프레임워크 자체에 대한 전체 계측을 추가하지 않습니다.

Wagtail 사용 시 일관되지 않은 트랜잭션 이름을 수정했습니다.

• 이전에는 Wagtail 을 기반으로 구축된 앱의 트랜잭션 이름이 일관되지 않았으며 다른 페이지 뷰에 대해 동일할 수 있었습니다. 이 문제가 수정되었습니다.

원격 MCP 서버를 기반으로 하는 LangChain 도구의 중복 도구 엔티티를 수정합니다.

• 이전에는 LangChain 도구가 별도로 계측된 원격 MCP 서버에 의해 지원될 때 UI에 중복된 도구 엔티티가 나타났습니다. 알려진 원격 도구가 감지될 때 LangChain 도구에서 하위 구성 요소 속성을 차단하여 이 문제가 해결되었습니다.

LangChain 및 LangGraph MCP 도구 호출에 대한 누락된 사용자 입력 필드를 수정합니다.

• 이전에는 LangChain 또는 LangGraph가 MCP 서버의 도구를 사용했을 때, 입력 메시지가 스트리밍된 시퀀스의 마지막 메시지가 아닌 경우 AI 모니터링 데이터에서 사용자 입력 필드가 누락될 수 있었습니다. 이 문제가 수정되었으며, 이제 에이전트가 이러한 경우에 입력 메시지를 올바르게 추출합니다.

가비지 컬렉션 데이터 샘플러에서 경쟁 조건 위험을 줄입니다.

• 이전에는 에이전트가 설정에 관계없이 가비지 수집기 객체 수를 샘플링하기 위해 항상 gc.get_objects() 을(를) 호출했습니다. 가비지 수집기가 수집한 객체 유형을 추적하지 않는 고객을 위해 불필요한 힙 반복을 방지하도록, top_object_count_limit 이(가) 0보다 높게 설정된 경우에만 gc.get_objects() 이(가) 호출되도록 변경되었습니다.

아웃바운드 Kombu 분산 추적 헤더에서 바이트 인코딩을 제거합니다

• 이전에는 Kombu 계측에 의해 추가된 분산 추적 헤더가 바이트 인코딩되어, 표준 라이브러리 json 모듈을 사용하여 페이로드를 직렬화하는 전송(예: SQLAlchemy 기반 전송)이 손상되었습니다. 이러한 전송이 올바르게 작동하도록 바이트 인코딩이 제거되었습니다.

Google ADK에 대한 계측 추가

• 파이썬 에이전트는 이제 Google ADK (에이전트 개발 키트) AI 에이전트 워크플로우를 계측합니다.

• 계측된 구성 요소는 다음과 같습니다:

  • LlmAgent google.genai을(를) 통해 Gemini 또는 VertexAI 백앤드에 연결됨
  • 사용자 정의 FunctionTool 인스턴스
  • 하위 에이전트 및 AgentTool 인스턴스를 포함하는 하위 에이전트 워크플로우
  • Workflow 클래스와 더 이상 사용되지 않는 LoopAgent, ParallelAgent 및 SequentialAgent 클래스를 포함하는 다중 에이전트 워크플로우

Anthropic, Gemini, OpenAI 및 Bedrock에 대한 토큰 계산 추가

• 파이썬 에이전트는 이제 여러 AI 제공업체의 모든 LLM 호출에 대한 토큰 수를 보고합니다:

  • Anthropic SDK
  • Google 생성형 AI SDK
  • OpenAI SDK
  • botocore 및 aiobotocore를 통한 AWS Bedrock

graphql-core v3.2.10의 계측 충돌 수정

• 이전에 graphql-core v3.2.10에서 ExecutionContext의 errors 속성 이름을 collected_errors (으)로 변경하여 에이전트 충돌이 발생했습니다. 이 문제가 수정되었으며, 이제 에이전트가 graphql-core v3.2.10 이상에서 올바르게 작동합니다.

아웃바운드 tracestate 헤더에서 spanId 제거

• 이전에 에이전트는 아웃바운드 tracestate 헤더에 spanId 을(를) 포함했습니다. spanId 이(가) 이미 traceparent 헤더에 있으므로 이는 불필요한 중복이었습니다. 아웃바운드 헤더 크기를 줄이기 위해 tracestate 에서 spanId 이(가) 제거되었습니다.