Python Agent Release Notes
2026-10-19
v2.2.2
Fixed LLM 모드에서 네이티브 에이전트가 중복 기동되던 현상 수정
- v2.2.1에서 수정한 중복 기동 현상이 LLM 모드에서는 계속 발생하던 문제 해결
2026-09-29
v2.2.1
New AWS Bedrock Runtime 계측 지원
bedrock-runtime의Converse,ConverseStream,InvokeModel,InvokeModelWithResponseStream호출을 LLM API 스텝으로 수집
New 액티브 트라젝토리 중지 기능 추가
- 액티브 LLM 화면에서 실행 중인 트라젝토리를 중지 가능
- 진행 중인 LLM 호출을 끊고 해당 트랜잭션을 종료하며, 이후 같은 트라젝토리에서 발생하는 LLM 호출도 차단함
- 중지 지점은 트랜잭션 프로파일에
WhaTap: LLM trajectory stopped by control메시지 스텝으로 기록되어 애플리케이션 오류와 구분 가능
New llm_blocked_users String 옵션 추가
- 기본값:
"" - 지정한 사용자 ID의 LLM 호출 차단. 쉼표로 구분하며 대소문자는 구분하지 않음
- 예:
llm_blocked_users=u-1024,abuse@example.com
- 예:
- 차단된 호출은 해당 SDK의 연결 오류(예:
APIConnectionError)로 반환하고, 트랜잭션 프로파일에WhaTap: LLM call blocked for user …메시지 스텝 기록됨
New llm_httpc_step_enabled Boolean 옵션 추가
- 기본값: true
- LLM 워크플로우 안에서 발생한 HTTP 호출(MCP, REST 도구 호출 등)을 LLM 스텝과 함께 수집
- false로 설정하면 LLM API 호출만 수집
New 트라젝토리 신규 시작 건수 메트릭 추가
- 액티브 트라젝토리 메트릭에 5초 동안 새로 시작된 트라젝토리 수(
new_count) 추가
Fixed openai 3.x, anthropic 1.x 환경에서 LLM API 스텝과 API 상태 코드 통계가 수집되지 않던 현상 수정
Fixed 짧게 실행하고 종료하는 프로세스에서 LLM 트랜잭션이 유실되던 현상 수정
- CLI 실행, 자 식 프로세스처럼 한 번 실행하고 끝나는 프로세스에서 트랜잭션 종료 정보와 LLM 로그가 전송되지 않던 문제 해소
New httpx2 라이브러리 계측 추가
Changed 스트리밍 HTTP 응답의 경과 시간을 응답 종료 시점 기준으로 측정
- SSE 등 스트리밍 응답은 헤더를 받은 시점이 아니라 응답이 끝난 시점까지를 스텝 경과 시간으로 수집
Fixed Linux에서 whatap_code_start를 true로 설정하면 멀티 워커(uvicorn --workers 등) 환경에서 네이티브 에이전트가 워커 수만큼 중복 기동되던 현상 수정
2026-09-01
v2.2.0
New LLM 워크플로우 트랜잭션 계측 추가
- 애플리케이션 트랜잭션 내의 LLM 실행 구간을 트랜잭션 단위로 수집
New 대화 좌표(User / Session / Turn) 수집 추가
- 사 용자 ID와 세션 ID를 HTTP 헤더 또는 LLM SDK 호출 인자에서 자동 수집
- 턴 ID는 트랜잭션 진입 시 자동 부여
New 평가(Evaluation) 판정 모델 설정 옵션 추가
New llm_prompt_default_version 옵션 추가
- 타입: String, 기본값:
v1
New 액티브 트라잭토리 추적 기능 추가
New 액티브 LLM API 추적 기능 추가
New anthropic SDK 자동 계측 추가
New langgraph 자동 계측 추가
New hermes-agent 게이트웨이 자동 계측 추가
Changed 평가 구간 지정이 전역 설정 및 샘플링과 독립적으로 동작하도록 개선
Fixed LLM API 스텝의 경과 시간이 실제보다 짧게 수집되던 현상 수정
Fixed 동시 LLM 호출 시 액티브 게이지가 실제보다 적게 집계되던 현상 수정
Fixed LLM 호출 건수가 유실되던 현상 수정
New llm_apm_txn_enabled 옵션 추가
- 타입: Boolean, 기본값:
false - 옵션을 켜면 APM 프로젝트에서도 LLM 트랜잭션 조회 가능
New 프로세스 경계(exec / spawn) 트레이스 전파 추가
- 자식 프로세스로 트랜잭션 연결 정보를 전달해 멀티 프로세스 구조에서 호출 관계 연결
New 워커 스레드(ThreadPoolExecutor) 트레이스 컨텍스트 전파 추가
ThreadPoolExecutor.submit으로 실행된 작업이 상위 트랜잭션에 연결
Fixed apm_enabled가 false인 설정에서도 APM UDP 소켓을 생성하던 현상 수정
Fixed hook_method_patterns 등 패턴 옵션에 지정한 모듈명이 자동 계측 대상 모듈과 겹칠 때 해당 모듈의 계측이 유실되던 현상 수정
Fixed subprocess.Popen 호출 시 env를 위치 인자로 전달하면 애플리케이션 호출이 실패할 수 있던 현상 수정
2026-08-18
v2.1.4
Fixed 진입 모듈이 계측 대상일 때 에이전트 오류가 발생하던 현상 수정
2026-08-05
v2.1.3
New hook_service_patterns 옵션 추가
- 지정한 메소드를 트랜잭션 진입점으로 래핑
- 클래스 단위 메소드 추적 시
hook_service_patterns= “패키지:클래스.메소드”# 예) myPackage:MyClass.__init__ - 함수 단위 추적 시
hook_service_patterns= “패키지:함수명”# 예) myPackage:my_function
New Odoo 프레임워크 지원 버전 확장
- v16, v17 → v14~v19 지원
2026-07-22
v2.1.2
Fixed 에이전트 2.0.0 이후 버전에서 액티브 스택이 수집되지 않던 현상 수정
2026-06-22
v2.1.1
Fixed LiteLLM(in-process) 사용 시 LLM 호출이 실패하던 문제 수정
Fixed 스트리밍 tool_calls / reasoning 응답에서 TTFT·TPOT가 기록되지 않던 문제 수정
2026-06-10
v2.1.0
New LLM 호출 자동 평가(Evaluation) 기능, 오퍼레이션 타입(Operation Type) 계측 기능 추가
Changed LLM 메트릭 구조 개선
- 메트릭 카테고리 분리
finish_reason메트릭 추가- 리스트형 메트릭 태그를 평행 배열 필드로 평탄화
- 토큰/호출 통계 정리
New 특정 라이브러리 자동 계측을 선택적으로 비활성화하는 옵션 추가
ignore_instrumentation_setString: 해당 옵션으로 등록된 라이브러리는 계측 로직이 활성화되지 않습니다. 대상이 여러 개인 경우,로 구분합니다.- 기본값 없음, 애플리케이션 재기동 필요
- 예시:
redis,openai
New wheel(bdist_wheel) 패키지 동시 배포 추가
Fixed 라이선스 미설정 시 accesskey 접근에서 AttributeError가 발생하던 현상 수정
Fixed profile_http_parameter_enabled 사용 시 일부 HTTP 클라이언트 호출에서 인자 접근으로 비정상 종료될 수 있던 현상 수정
2026-04-28
v2.0.2
Changed LLM 로그싱크 UDP 전송 방식을 단일 전송에서 48KB 누적 버퍼링 방식으로 변경
New Windows 서비스(NSSM) Session 0에서 에이전트 실행 지원
New FastAPI 프레임워크의 BaseHTTPMiddleware 추적 기능 추가
Changed FastAPI 추적 로직 안정성 개선
Changed whatap.conf 미설정 값 환경변수 fallback 지원
Fixed 에이전트 로그에 불필요한 정보 기록 현상 수정
2026-04-08
v2.0.1
New openai 라이브러리 추적 지원
New LLM 전용 Metric, Log 지원
New LLM 비용(Pricing) 산정 — genai-prices 연동을 통한 모델별 입출력 토큰 단가 계산 지원(실패 시 내장 fallback)
New vLLM 호환 — openai SDK 호환 vLLM 서버에 대한 Chat Completions / Completions API 후킹 및 delta.text fallback 지원
New whatap-llm-setting-config LM 모드 설정 파일을 자동 생성/갱신하는 명령어 추가
New LLM 추적 옵션 추가
- llm_api_hosts String
해당 옵션으로 등록된 HTTPC의 호스트는 LLM API 경로로 인식하고 호스트가 여러 개인 경우,로 구분함- 기본값 없음
- 예시:
localhost:8000,api.openai.com:443
- llm_model_pricing String
LLM 모델의 1M 토큰당 가격을 수동으로 입력, 해당 옵션으로 등록된 가격이 1순위로 계산되어 데이터가 저장됨- 형식:
[모델 이름]|[입력 토큰]|[출력 토큰]|[캐시 토큰] - 예시:
gpt-4o|2.50|10.00|1.25,gpt-4o-mini|0.15|0.60|0.075,my-custom-model|1.00|5.00
- 형식:
New FastAPI SSE 응답 스트리밍 추적 지원
New LLM & APM 듀얼 에이전트 모드 개발
- apm_enabled Boolean
- APM 모드로 에이전트를 가동함
license,whatap.server.host
주의해당 라이센스와 서버 주소는 반드시 APM 프로젝트의 키로 입력해야 함
- llm_enabled Boolean
- LLM 모드로 에이전트를 가동함
llm_license,llm.whatap.server.host
주의해당 라이센스와 서버 주소는 반드시 LLM 프로젝트의 키로 입력해야 함
2026-03-24
v1.9.2
New UDP 포트 강제 할당 옵션 추가
- Go 모듈과의 통신에 사용되는 UDP 포트를 사용자가 직접 지정할 수 있는
force_net_udp_port옵션 추가
파이썬 에이전트 프로세스를 여러개 실행하는 경우, 포트 충돌 위험이 있으므로 특정 환경에서 UDP 포트 고정이 필요한 경우에만 사용을 권장합니다. (기본값: 미사용)
Feature httpx 비동기 추적 지원
- 비동기 HTTP 클라이언트인
httpx.AsyncClient계측 추가
Changed 에이전트에서 필수적으로 요구되던 setuptools 모듈 의존성 제거
Changed PEP 517 기반 빌드 시스템 지원
Fixed DB Connection 재사용 시 수집 누락 문제 해결
- 데이터베이스 커넥션을 재사용하거나 싱글톤으로 선언하여 사용할 때, Step에서 연결 정보가 정상적으로 수집되지 않던 현상 수정
2026-01-26
v1.9.1
Fixed logging, loguru 추적 모듈 수정
- 옵션 값이
False일 때 후킹하지 않도록 수정
Fixed trace_user_enabled 옵션 로직 수정
ValueError에러가 발생하던 현상 수정
Fixed greenlet 환경 추적 로직 수정
- 해당 환경에서 에러 발생 시 현재 프레임을 찾지 못해 예외 객체를 잡지 못하는 현상 수정
2025-12-23
v1.9.0
New Windows OS 지원
- Windows Server 2008 R2, Windows 7 이상
Fixed ACTIVE_STATUS 모니터링 버그 수정
- 멀티트랜잭션 발생 시 데이터가 정상적으로 정리되지 않는 현상 수 정
Fixed HTTPC추적 버그 수정
- 원본 함수의 리턴값이 정상적으로 전달되지 않는 현상 수정
Fixed 쿠버네티스 컨테이너 환경에서 Container ID가 비정상 값으로 수집되던 현상 수정
2025-11-11
v1.8.14
Fixed psycopg_pool 모듈 수정
pool_connection수동 호출 시 연결이 pool에 반환되지 않던 현상 수정
Fixed psycopg 모듈 수정
특정 로직이 psycopg2와 충돌이 발생하던 현상 수정
Fixed ACTIVE_STATUS 모니터링 기능 수정
불필요한 상황에서 ACTIVE_STATUS 데이터가 보내지던 현상 수정
2025-10-01
v1.8.13
Fixed fastapi 모듈 수정
특정 함수들이 두 번 이상 실행되던 현상 수정
Fixed httpx 모듈 수정
Streaming 방식으로 호출 시 추적 에러가 발생하던 현상 수정
Fixed psycopg 모듈 수정
rowcount 속성 접근 에러 수정
커넥션 정보 추출 로직의 안정성 향상
Fixed 쿠버네티스 컨테이너 환경에서 Container ID가 매핑되지 않는 현상 수정
쿠버네티스 에이전트 v1.8.8 이상 지원
2025-09-12
v1.8.12
New LLM 로그 모니터링에 @step_id 필드 추가
New LLM 메트릭스 수집 기능 추가
llm_stat_enabled Boolean
false: 기본값true: 해당 옵션과 trace_llm_log_enabled, counter_thread_enabled이 모두true인 경우 메트릭스 수집 기능 활성화
llm_stat_interval Number
- LLM 메트릭스 수집 주기를 초 단위로 설정하는 옵션
5: 기본값
- LLM 메트릭스 수집 주기를 초 단위로 설정하는 옵션
Feature counter_thread_enabled 옵션 추가
: 기본값false
: llm_stat, app_filedescriptor 메트릭스를 수집하는 스레드(counter_thread) 활성화ture
Changed psycopg_pool 추적 모듈의 안정성 향상
Changed psycopg, psycopg_pool 두 모듈의 비동기 추적 안정성 향상
Changed open_file_descriptor_enabled 옵션이 더 이상 counter_thread 활성화 유무에 영향을 주지 않음
2025-09-01
v1.8.11
New psycopg_pool 모듈 추적 기능 추가
Fixed sqlAlchemy 모듈 수정
asyncmy드라이브의 쿼리 매개변수가 치환되지 않던 현상 수정
2025-08-22
v1.8.10
New psycopg 모듈 추적 기능 추가
New WHATAP_PYTHON_AGENT_PATH 환경변수를 통해 whatap_python 실행 파일 경로 지정 가능
해당 환경변수를 설정하지 않으면
WHATAP_HOME으로 대체됨
Fixed neo4j 모듈 수정
DB 연결 시점이 정상적으로 수집되지 않던 현상 수정
2025-08-12
v1.8.9
New sqlite3 모듈 추적 기능 추가
Fixed DB Connection 중복 노출 현상 수정
- DB 쿼리만 실행해도 Step에서 DB Connection Step이 노출되던 현상 수정
2025-08-04
v1.8.8
New httpx 모듈 추적 기능 추가
New openai 모듈 추적 기능 추가
trace_llm_log_enabled Boolean
기본값
falsetrue설정 시, openai API 로그 모니터링으로 추적함
2025-07-29
v1.8.7
New whatap_code_start 옵션 추가 Boolean 기본값 false
true설정 시, sitecustomize.py에서import whatap후whatap.agent()실행 가능하여, whatap-start-agent 명령어 없이 기존 파이썬 실행 명령어로 에이전트 실행 가능
Fixed open_file_descriptor_enabled 옵션 수정 Boolean
false설정 시, 파일 디스크립터를 추적하는 스레드도 비활성화됨
2025-07-15
v1.8.6
New URL을 정규화한 경우, 원본 URL이 step에서 노출되는 옵션 추가
step_origin_url_enabled Boolean
기본값
false
New standalone Python 프로세스 추적 옵션 추가
standalone_enabled Boolean
기본값
falsestandalone_type String
single-transaction: 기본값, 하나의 트랜잭션으로 모니터링multiple-transaction: 모듈·클래스·메소드 단위 트랜잭션 지정 가능standalone_transaction_patterns String
기본값 없음
형식:
[MODULE]:[CLASS].[FUNC]또는[MODULE]:[FUNC]예:
myPackage:MyClass.__init__, myPackage:my_function
New Neo4j 드라이브 모듈 추적 기능 추가 (v5.0 이상)
Fixed URL 정규화 시 레코드 요약에서 원본 URL이 노출되지 않던 문제 수정
2025-06-18
v1.8.5
New whatap.conf에 매트릭스 카테고리 app_context_stat 관련 옵션 추가
app_context_enabled Boolean
기본값
falsetrue로 설정 시app_context_stat수집 기능 전체 활성화app_context_parser
default: 기본 파서 (첫 번째 경로 세그먼트 추출)prefix: 접두사 매칭 파서 (가장 유연함)match: 정확한 매칭 파서 (완전 일치만)app_context_parser_reset Number
기본값0파서의 내부 캐시와 설정을 강제로 재설정하는 카운터
app_context_path_depth Number
기본값1URL에서 추출할 경로 세그먼트의 깊이 지정 (
default파서에서만 사용)app_context_path_set String
기본값 없음
모니터링할 경로와 해당 이름을 정의하는 매핑 설정 (쉼표
,로 구분)예:
name1@url1,name2@url2,url3,name4@url4
2025-06-09
v1.8.4
Fixed fastAPI 호출 시, StreamingResponse가 없이 호출되던 현상 수정
2025-05-19
v1.8.3
New Odoo 프레임워크(v16,v17) 추적 기능 추가
Fixed SQLAlchemy 관련 오류 수정
-
추적 중인 DB 드라이버와 충돌하여 쿼리 메시지가 중복 노출되던 문제 수정
-
쿼리문에 매개변수가 바인딩되지 않던 문제 수정
-
DB 연결 시
user값을 입력하지 않으면 에러가 발생하던 문제 수정
Fixed Flask 예외 객체가 아닌 다른 예외 객체를 정상적으로 처리하지 못하던 문제 수정
2025-04-28
v1.8.2
Fixed ignore_whatap_stdout 옵션 미적용 현상 수정
2025-04-23
v1.8.1
New starlette 기반의 WebSocket 송신 추적 기능 추가
-
trace_websocket_enabled Boolean
기본값
false
:true로 설정 시 해당 WebSocket 추적 기능 활성화
2025-04-14
v1.8.0
New Python 3.12 , 3.13 지원
New FastAPI의 StreamingResponse 추적 기능 추가
2025-03-31
v1.7.9
New HTTP 트랜잭션의 정상 신호(Status: 2xx, 3xx) 수집 및 표시 기능 추가
Fixed Tornado 모듈에서 에러 발생 시 정상 신호로 표시되는 현상 수정
2025-03-24
v1.7.8
New HTTP 트랜잭션의 요청 Method 수집 및 표시 기능 추가
New HTTP 트랜잭션 에러 발생 시 HTTP Status 수집 및 표시 기능 추가
Fixed Python 3.8 이하 버전에서 DB 모듈 사용 시 오류가 발생하던 현상 수정
2025-03-11
v1.7.7
New whatap.conf에서 와탭 모듈 로그 출력 제어 옵션 추가
-
ignore_whatap_stdout Boolean
기본값
falsetrue로 설정 시 와탭 Python 에이전트 모듈에서 발생하는 모든 표준 출력 로그를 비활성화합니다.
Fixed 환경변수 OKIND 설정 후 멀티 트랜잭션 추적 시 오류 발생 문제 수정
Fixed SQL Connection이 2개 이상일 경우 execute 실행 시 DB 모니터링 오류 개선
Fixed sqlalchemy