AI Agent Observability 지원 환경
이 문서는 AI Agent Observability SDK의 언어별 지원 환경과 버전 요구사항을 안내합니다. SDK를 설치하기 전에 애플리케이션 환경이 지원 범위에 해당하는지 확인하세요.
Python 에이전트 지원 환경
와탭 Python 모니터링 에이전트를 설치하기 전에 지원 환경을 확인하세요.
최종 업데이트: 2026-09-07
지원 버전
| 애플리케이션 타입 | Python 버전 |
|---|---|
| WSGI Application | 3.7 ~ 3.13 |
| ASGI Application | 3.7 ~ 3.13 |
운영체제
| OS | 최소 버전 | 아키텍처 |
|---|---|---|
| Ubuntu | 12.04 | 64bit |
| Red Hat / CentOS | 6.x | 64bit |
| macOS | 10.15 Catalina | - |
| Windows | Windows Server 2008 R2, Windows 7 | 64bit |
애플리케이션 서버
| 프레임워크 | 지원 버전 |
|---|---|
| Bottle | - |
| Celery | - |
| CherryPy | - |
| Django | - |
| FastAPI | 0.84.0 |
| Flask | - |
| Frappe | - |
| Nameko | - |
| Odoo | v14 ~ v19 |
| Tornado | - |
라이브러리
| 카테고리 | 라이브러리 |
|---|---|
| 외부 호출 | HttpLib, HttpLib2, Requests, Urllib, HTTPX, HTTPX2 |
| 데이터 처리 | SQL Alchemy, GraphQL |
| 로깅 | smtplib, logging, loguru |
| 메시징 | Kombu, Pika |
| LLM SDK | OpenAI, Anthropic, Amazon Bedrock |
| Agent Orchestration | Hermes, LangGraph |
데이터베이스
| 데이터베이스 | 드라이버 |
|---|---|
| MongoDB | pymongo |
| MySQL | MySQLdb, pymysql |
| Neo4j | neo4j |
| Oracle | cxOracle |
| PostgreSQL | psycopg2, psycopg, psycopg_pool |
| Redis | redis |
| SQLite | sqlite3 |
whatap-python[llm] 패키지는 datasketches>=5.2.0, genai-prices 외부 라이브러리를 필요로 합니다.
LLM 프로바이더별 수집 범위
Python SDK는 LLM 프로바이더를 부르는 호출을 트랜잭션의 LLM API 스텝으로 수집합니다. 프로바이더 SDK 버전이나 호출 방식에 따라 수집 조건이 다르므로 아래 내용을 확인하세요.
OpenAI, Anthropic
openai 3.0.0 이상과 anthropic 1.0.0 이상은 HTTP 전송 라이브러리로 httpx 대신 httpx2를 사용합니다. 이 버전의 프로바이더 SDK에서 LLM API 스텝과 API 상태 코드 통계를 수집하려면 Python SDK 2.2.1 이상을 사용하세요.
Amazon Bedrock
Amazon Bedrock Runtime의 Converse, ConverseStream, InvokeModel, InvokeModelWithResponseStream 호출을 LLM API 스텝으로 수집합니다. Python SDK 2.2.1 이상에서 지원하며, llm_enabled=true로 설정해야 계측이 동작합니다.
Bedrock Runtime은 REST API라서 애플리케이션마다 호출 경로가 다릅니다. Python SDK가 수집하는 호출 경로는 다음과 같습니다.
| Path | Description |
|---|---|
boto3 | langchain-aws의 ChatBedrockConverse, ChatBedrock 포함 |
aioboto3, aiobotocore | 비동기 클라이언트 호출 |
| LiteLLM 등 HTTP 직접 호출 | httpx, httpx2, requests로 Bedrock Runtime REST 경로(POST /model/{modelId}/converse 등)를 부르는 호출 |
AnthropicBedrock | anthropic 패키지의 Bedrock 클라이언트 |
| OpenAI 호환 엔드포인트 | base_url에 bedrock-runtime 또는 bedrock-mantle이 포함된 클라이언트 |
- 프로바이더는 호출 경로와 관계없이
bedrock으로 수집합니다. - 한 호출이 여러 계층을 거쳐도 LLM API 스텝은 1개만 기록합니다.
us.,jp.,apac.같은 교차 리전 추론 프로파일 모델 ID도 비용을 계산합니다.- 트라젝토리 중지와 LLM 호출 차단 사용자(
llm_blocked_users) 설정은 Bedrock 호출에도 적용됩니다.
Bedrock 계측만 끄려면 whatap.conf에 ignore_instrumentation_set=bedrock을 추가하세요. boto3, aioboto3, aiobotocore, HTTP 직접 호출 경로의 수집을 중단합니다. AnthropicBedrock과 OpenAI 호환 엔드포인트 호출은 각각 anthropic, openai 계측으로 수집하므로 이 설정의 영향을 받지 않습니다. 옵션 설명은 Python 에이전트 기능 제어 문서를 참조하세요.
공통 지원 환경
서비스 제공 형태
와탭 모니터링은 SaaS 또는 온프레미스(설치형) 방식으로 이용할 수 있습니다. 어느 쪽을 선택해도 같은 에이전트로 같은 모니터링 기능을 사용합니다.
| Deployment | Support | Description |
|---|---|---|
| SaaS | ✅ | 와탭이 운영하는 수집 서버에 연결. 리전별 주소는 방화벽 항목 참조 |
| 온프레미스(설치형) | ✅ | 수집 서버를 직접 구축해 운영(폐쇄망 환경 지원). 도입 범위는 영업 담당자와 협의 |
인터넷에 연결하지 않는 폐쇄망 환경에서도 온프레미스로 구축할 수 있습니다.
제공 형태에 따른 기능 차이
어느 형태를 선택해도 모니터링 기능은 같습니다. 모바일 앱만 예외로 service.whatap.io SaaS에서만 사용할 수 있습니다.
온프레미스에서 일부 기능을 사용하려면 별도 계약이 필요합니다.
브라우저 지원
와탭 모니터링 서비스는 웹브라우저와 모바일 앱에서 이용할 수 있습니다.
| 브라우저 | 권장 여부 | 지원 버전 |
|---|---|---|
| Google Chrome | ✅ | 111 이상 |
| Mozilla FireFox | ❌ | 최신 버전 |
| Edge | ❌ | 최신 버전 |
| Safari | ❌ | 최신 버전 |
지원 안내
- 브라우저 호환성과 성능을 이유로 Chrome 최신 버전 사용을 권장합니다.
- 사용자 인터페이스(User Interface, UI)는 HTML5 표준 기술로 구현되어 Internet Explorer는 지원하지 않습니다.
제약 사항
와탭의 웹 인터페이스는 모바일 브라우저를 지원하지 않습니다. 모바일 기기에서 와탭에 접속하려면 Android 또는 iOS용 와탭 앱을 설치하세요. 와탭 모바일 앱은 모바일 환경에 최적화되어 있습니다. WhaTap 모바일 앱에 대한 자세한 내용은 다음 문서를 참고하세요.
방화벽
와탭 에이전트는 수집 서버 TCP 6600 포트로 접근할 수 있어야 합니다. 모니터링 대상과 가까운 수집 서버 주소를 허용하세요.
출발지: 와탭 에이전트
| 클라우드 | 목적지 | 목적지 IP | 포트 |
|---|---|---|---|
| AWS | 와탭 서울 수집 서버 | 13.124.11.223 / 13.209.172.35 | TCP 6600 |
| 와탭 도쿄 수집 서버 | 52.68.36.166 / 52.193.60.176 | TCP 6600 | |
| 와탭 싱가포르 수집 서버 | 18.138.0.93 / 18.139.67.236 | TCP 6600 | |
| 와탭 자카르타 수집 서버 | 108.136.91.69 / 108.137.158.44 | TCP 6600 | |
| 와탭 태국 수집 서버 | 43.209.109.219 / 43.209.48.86 | TCP 6600 | |
| 와탭 뭄바이 수집 서버 | 13.127.125.69 / 13.235.15.118 | TCP 6600 | |
| 와탭 캘리포니아 수집 서버 | 52.8.223.130 / 52.8.239.99 | TCP 6600 | |
| 와탭 버지니아 수집 서버 | 107.23.220.101 / 54.236.221.105 | TCP 6600 | |
| 와탭 프랑크프루트 수집 서버 | 3.125.142.162 / 3.127.76.140 | TCP 6600 | |
| Azure | 와탭 서울 수집 서버 | 52.231.66.38 / 20.194.5.115 | TCP 6600 |
| 와탭 도쿄 수집 서버 | 52.246.169.54 / 20.210.27.232 | TCP 6600 | |
| Kakao | 와탭 서울 수집 서버 | 61.109.237.237 / 61.109.238.166 | TCP 6600 |
인바운드 차단 정책을 쓴다면 응답 트래픽을 확인하세요.
에이전트가 수집 서버로 연결을 시작하므로 에이전트 호스트에 인바운드 6600 포트를 열 필요는 없습니다. 다만 수집 서버가 보내는 응답 패킷은 에이전트 호스트로 들어와야 합니다. 인바운드 정책에서 이미 연결된 세션의 응답 트래픽(established, related)까지 막고 있지 않은지 확인하세요.
응답 트래픽을 막아야 한다면 예외를 하나 두세요. 수집 서버 IP의 6600 포트에서 에이전트 호스트의 임시 포트 범위로 들어오는 트래픽만 허용하면 됩니다.
에이전트에서 수집 서버로 직접 접속할 수 없다면 제공하는 Proxy 모듈을 이용해 경유하세요.
