문서
Sophonz를 효과적으로 사용하기 위한 가이드와 레퍼런스입니다.
가이드
시작하기
프로덕션
요금과 미터링
프론트엔드 SDK
웹
설치
Sophonz Browser SDK를 CDN 또는 NPM으로 웹 프론트엔드 프로젝트에 설치하는 방법을 안내합니다.
폐쇄망(air-gapped) 설치
인터넷이 차단된 폐쇄망 환경에서 Sophonz Browser SDK를 설치하는 네 가지 방법을 안내합니다.
레거시 브라우저 (IE11)
IE11을 포함한 레거시 브라우저에서 Sophonz Browser SDK를 설치하는 방법을 안내합니다.
소스맵 업로드
Vite 플러그인을 사용해 빌드 후 소스맵을 Sophonz 서버에 자동 업로드하고 프로덕션 에러의 원본 소스 위치를 추적합니다.
설정 및 서비스 상태 관리
Sophonz Browser SDK의 초기화 옵션 전체 레퍼런스와 서비스 상태 동적 제어 방법을 설명합니다.
API 레퍼런스
Sophonz Browser SDK의 모든 공개 API 메서드에 대한 완전한 레퍼런스입니다.
Web Vitals
Sophonz Browser SDK가 Core Web Vitals를 어떤 형태로 내보내는지 — browser.web_vital Span·이벤트·히스토그램과 그 속성, 그리고 기존 web-vital.* 이름을 대체한 속성 변경을 설명합니다.
데이터 편집(Redaction)
URL 편집은 기본으로 적용되고 속성 편집은 선택 사항입니다. 기본으로 무엇을 URL에서 제거하는지, sanitizeUrl로 어떻게 확장하는지, attributeScrubbers로 속성 값을 어떻게 편집하는지 설명합니다.
WebView 연동 및 예제
Sophonz Browser SDK를 모바일 네이티브 앱의 WebView와 연동하는 방법과 동작 확인을 위한 예제 프로그램을 설명합니다.
지원 사양
Sophonz Browser SDK가 지원하는 브라우저, WebView 환경, 프레임워크, 패키지 매니저 요구사항을 정리합니다.
안드로이드
iOS
Flutter
React Native
백엔드 SDK
Node.js
Node.js
Sophonz Node.js SDK는 자동 계측, 프레임워크 미들웨어, 예외 캡처와 함께 Node.js 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.
설치
Sophonz Node.js SDK 설치 및 초기화 — init()을 사용한 프로그래밍 방식 또는 opentelemetry-instrument 프리로드 바이너리 방식.
설정
Sophonz Node.js SDK 설정 레퍼런스 — init()/initSDK()의 SDKConfig 옵션과 SOPHONZ_* / OTEL_* 환경 변수.
미들웨어
Sophonz Node.js SDK로 Express, Koa, Fastify, NestJS의 요청 스팬 보강하기 — baggage, 클라이언트 IP, user-agent, 사용자 지정 속성, 에러 핸들러.
API 레퍼런스
Sophonz Node.js SDK 공개 API — init, shutdown, 미들웨어, 에러 핸들러, 트레이스 속성, 로거 트랜스포트, 제공되는 공식 OpenTelemetry API.
예제
Sophonz Node.js SDK로 Express, Koa, Fastify, NestJS 서버를 계측하는 완전한 실행 예제 — 초기화 순서, 요청 미들웨어, 로깅, 에러 핸들러.
Next.js
Next.js
Sophonz Next.js SDK는 App Router 앱의 브라우저·서버 모니터링을 하나의 설정으로 구성합니다 — 클라이언트의 SophonzProvider와 서버의 register()가 하나의 trace를 공유합니다.
설치
@sophonz/nextjs 설치, instrumentation.ts에 register() 연결하기, App Router 루트 레이아웃에 SophonzProvider 마운트하기.
설정
@sophonz/nextjs 설정 전체 레퍼런스 — 공유 SophonzNextConfig 옵션, 환경 변수, 패키지가 지정하는 기본값, 하위 브라우저·Node SDK 옵션에 접근하는 방법.
Python
Java
Go
Rust
Elixir
대시보드
Grafana 대시보드
AI Agent
AI Agent
AI Agent 개요
Sophonz AI Agent가 실제 사용자 데이터에서 문제를 발견하고 코드 수정까지 자동으로 제안하는 방법을 소개합니다.
GitHub App
Sophonz GitHub App을 리포지토리에 설치하면 실제 사용자 에러 데이터를 분석해 자동으로 이슈를 생성하고 코드 수정 PR을 제안합니다.
GitLab App
Sophonz GitLab App을 프로젝트에 설치하면 실제 사용자 에러 데이터를 분석해 자동으로 이슈를 생성하고 코드 수정 MR을 제안합니다.
에러·크래시 자동 수정
프로덕션 에러·크래시를 AI 에이전트가 분석해 코드 수정 PR/MR까지 자동으로 작성하는 파이프라인입니다.
커버리지·테스트 생성
실제 사용자 세션에서 커버리지가 높은 경로를 찾아 자동 테스트 케이스로 변환하는 파이프라인입니다.
에이전트 오케스트레이션
에이전트를 정의·연결·실행·관찰하는 오케스트레이션 레이어와 에이전트 라이프사이클, MCP & Skills를 설명합니다.
활용 시나리오
Sophonz AI Agent가 실제 에러를 발견하고 이슈와 코드 수정 PR/MR을 자동으로 생성하는 엔드투엔드 시나리오를 설명합니다.