문서

Sophonz를 효과적으로 사용하기 위한 가이드와 레퍼런스입니다.

가이드

시작하기

소개

Sophonz가 무엇이고 애플리케이션에 어떤 도움을 주는지 알아봅니다.

빠르게 시작하기

SDK를 설치하고 5분 이내에 텔레메트리 수집을 시작하세요.

프로덕션

베스트 프랙티스

프로덕션 환경에서 Sophonz를 가장 효과적으로 활용하는 방법.

요금과 미터링

미터링 토큰

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 메서드에 대한 완전한 레퍼런스입니다.

WebView 연동 및 예제

Sophonz Browser SDK를 모바일 네이티브 앱의 WebView와 연동하는 방법과 동작 확인을 위한 예제 프로그램을 설명합니다.

지원 사양

Sophonz Browser SDK가 지원하는 브라우저, WebView 환경, 프레임워크, 패키지 매니저 요구사항을 정리합니다.

안드로이드

Android SDK 설치 가이드

Sophonz Android SDK v1.0 설치 및 설정 방법을 안내합니다.

Android SDK 설치 가이드 (Extension v1.1)

Sophonz Android SDK v1.1 Extension 설치 및 설정 방법을 안내합니다.

Android SDK 설치 가이드 (Vanilla)

Sophonz Android Vanilla SDK v1.1 설치 및 설정 방법을 안내합니다.

iOS

iOS SDK 설치

Sophonz iOS SDK를 XCFramework, CocoaPods, Swift Package Manager로 설치하는 방법을 안내합니다.

API 및 설정

Sophonz iOS SDK의 Options 클래스, 주요 API, 그리고 초기화 예제를 설명합니다.

웹뷰 연동 및 통합

Sophonz iOS SDK의 WebView 세션 연결, Objective-C 프로젝트 통합, 권장 사항 및 지원 안내입니다.

Flutter

Sophonz Flutter SDK는 Flutter 앱에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

React Native

Sophonz React Native SDK는 React Native 앱에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

백엔드 SDK

Node.js

Sophonz Node.js SDK는 Node.js 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

Python

Sophonz Python SDK는 Python 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

Java

Sophonz Java SDK는 Java 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

Go

Sophonz Go SDK는 Go 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

Rust

Sophonz Rust SDK는 Rust 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

Elixir

Sophonz Elixir SDK는 Elixir 서버 애플리케이션에 OpenTelemetry 기반 옵저버빌리티를 제공합니다.

대시보드

Grafana 대시보드

Grafana 대시보드 개요

Sophonz가 수집한 OpenTelemetry 원격 측정 데이터를 Grafana에서 시각화하는 방법을 설명합니다.

대시보드 설정

Sophonz 인프라의 Grafana 데이터소스와 대시보드를 프로비저닝하는 방법을 설명합니다.

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을 자동으로 생성하는 엔드투엔드 시나리오를 설명합니다.

API 레퍼런스

플랫폼별 Sophonz SDK API를 한곳에서 모아 봅니다.