미터링 토큰

Sophonz의 사용량 과금 단위인 미터링 토큰 — 세션 단위 샘플링, 커스텀 로그, 스택트레이스 중복 제거 방식을 설명합니다.

미터링 토큰이란

미터링 토큰은 금액으로 환산되는 사용량 크레딧입니다. $20 상당의 토큰 ≈ 월 10만 스팬을 기준으로 합니다. 모든 플랜은 일정량의 미터링 토큰을 포함하며, 토큰은 스팬·커스텀 로그·스택트레이스 로그 어디에든 사용할 수 있습니다.

세션 단위 샘플링

SDK는 개별 요청이 아니라 세션 단위로 데이터를 샘플링합니다. 세션이 시작되면 SDK가 해당 프로젝트의 현재 사용량(잔여 토큰)을 확인하고, 한도에 맞춰 수집 비율을 자동으로 조정합니다.

• 세션 전체가 함께 샘플링되므로 수집된 트레이스는 항상 완전한 사용자 여정을 담습니다. 요청 단위로 끊겨 일부만 남는 일이 없습니다.
• 사용량이 한도에 가까워지면 샘플링 비율을 낮춰 토큰 소진을 방지합니다.
• 토큰이 충분하면 더 높은 비율로 수집합니다.

커스텀 로그

커스텀 로그도 미터링 토큰을 사용합니다. 로그는 ClickHouse에 압축 저장되며, 압축된 로그 1MB당 S3 표준 스토리지 요금($0.023/GB·월)을 기준으로 과금합니다. 즉 압축 1MB는 약 $0.0000225/월에 해당합니다.

로그는 압축률이 매우 높아 토큰을 거의 소비하지 않습니다. ClickHouse는 기본 LZ4(약 2–4배), 선택적으로 ZSTD(약 3–9배) 코덱을 사용하며, 컬럼 지향 저장과 결합하면 로그 데이터에서 10배 이상(구조화된 로그는 최대 170배까지) 압축됩니다.

스택트레이스 로그

에러·크래시의 스택트레이스는 같은 오류가 반복되는 경우가 많습니다. Sophonz는 에러 타이틀과 본문(스택 프레임)의 해시로 스택트레이스를 그룹화하여 샘플링합니다.

• 같은 해시(= 동일한 스택트레이스)는 본문을 한 번만 저장합니다.
• 콜렉터로 수집된 동일 해시의 중복 발생들은 대표 스택트레이스 1건에 여러 개의 spanId로 연결됩니다. 같은 에러가 수천 번 발생해도 본문은 1건만 보관하고 각 발생의 spanId만 누적합니다.
• 덕분에 대량으로 반복되는 에러도 토큰을 거의 추가로 소비하지 않으면서, 발생 빈도와 영향 범위(어떤 세션·요청에서 났는지)는 그대로 추적할 수 있습니다.

요금 방식

유료 플랜(Pro·Business)은 두 가지 요금 방식 중에서 선택할 수 있습니다.

• 정액 할인: 포함된 미터링 토큰을 할인가에 제공합니다. 사용량이 한도에 가까워지면 세션 단위로 자동 샘플링되어 추가 비용 없이 한도 안에서 동작합니다.
• 사용량 기반(Pay as you go): 더 낮은 기본료에 실제 사용한 만큼만 과금합니다. 미터링 상한을 직접 설정하고 고정 샘플링 비율로 수집하므로 비용과 데이터 충실도가 예측 가능합니다.

요금제

각 플랜은 월별 미터링 토큰을 포함합니다. 토큰은 스팬·커스텀 로그·스택트레이스에 함께 사용되며, 아래 스팬 수치는 토큰을 모두 스팬에 사용했을 때의 환산값입니다.

• 커스텀 로그와 스택트레이스는 압축·중복 제거 덕분에 같은 토큰으로 스팬보다 훨씬 많은 양을 수집할 수 있습니다.
• 사용량이 포함된 토큰을 초과하면 세션 샘플링 비율이 자동으로 낮아져 추가 비용 없이 한도 안에서 동작합니다.