단계별 지연 시간 및 비용
각 노드의 토큰 사용량과 실제 경과 시간을 측정해 느리고 비용이 큰 단계를 찾아보세요.
단계별 지연 시간 및 비용은(는) CoddyKit의 무료 AI Agents 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 AI Agents 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. AI Agents 강의에는 총 4개의 강의가 포함되어 있습니다.
단계별 지표가 필요한 이유
전체 지연 시간과 비용만으로는 시스템이 느리거나 비싸다는 사실만 알 수 있고, 어느 단계가 느리거나 비싼지는 알 수 없습니다. 문제를 해결하려면 단계별 측정이 필요합니다.
지연 시간 기록
모든 스팬에 추가합니다:
start = time.time()
# ... do work ...
span.duration_ms = (time.time() - start) * 1000지연 시간 범주
에이전트에서 흔히 느린 단계는 다음과 같습니다:
- LLM 호출 — 500ms~10초
- 웹 검색 — 200ms~2초
- 임베딩 — 50ms~200ms
- 데이터베이스 query — 5ms~500ms
비용 기록
LLM 단계에서는 토큰 수에 가격을 곱합니다:
PRICES = {
'gpt-4o-mini': {'in': 0.150 / 1e6, 'out': 0.600 / 1e6},
'gpt-4o': {'in': 2.50 / 1e6, 'out': 10.00 / 1e6},
'claude-sonnet-4-5': {'in': 3.00 / 1e6, 'out': 15.00 / 1e6}
}
def compute_cost(model, tokens_in, tokens_out):
p = PRICES[model]
return tokens_in * p['in'] + tokens_out * p['out']
cost = compute_cost('gpt-4o-mini', 1000, 500)
print(f"Cost for 1000 in / 500 out tokens on gpt-4o-mini: ${cost:.6f}")
트레이스별 집계
스팬을 트레이스 수준까지 합산합니다:
def trace_metrics(spans):
return {
'duration_ms': sum(s.duration_ms for s in spans),
'cost_usd': sum(s.cost_usd or 0 for s in spans),
'tokens': sum((s.tokens_in or 0) + (s.tokens_out or 0) for s in spans),
'step_count': len(spans)
}
from types import SimpleNamespace
spans = [
SimpleNamespace(duration_ms=120, cost_usd=0.002, tokens_in=100, tokens_out=50),
SimpleNamespace(duration_ms=340, cost_usd=0.005, tokens_in=200, tokens_out=80),
]
print(trace_metrics(spans))
p50 / p95 / p99
평균값만 보지 마십시오. 에이전트의 지연 시간은 꼬리가 긴 분포를 보이므로 백분위수를 보고해야 합니다:
import numpy as np
durations = [t.duration_ms for t in last_1000_traces]
print('p50:', np.percentile(durations, 50))
print('p95:', np.percentile(durations, 95))
print('p99:', np.percentile(durations, 99))사용자별 비용
매일 사용자 ID별로 비용을 합산합니다:
SELECT user_id, SUM(cost_usd) AS daily_cost
FROM traces
WHERE created_at::date = current_date
GROUP BY user_id
ORDER BY daily_cost DESC
LIMIT 100단계 이름별 비용
어떤 단계가 비용의 대부분을 차지할까요? 이름별로 그룹화합니다:
SELECT name, SUM(cost_usd) AS total
FROM spans
WHERE trace_id IN (SELECT id FROM traces WHERE created_at::date = current_date)
GROUP BY name
ORDER BY total DESC지연 시간 워터폴
하나의 트레이스에 대해 스팬을 간트 차트 스타일의 워터폴로 표시합니다. 가장 긴 막대가 병목입니다.
대부분의 트레이싱 UI는 이 작업을 자동으로 수행합니다.
이상값 알림
- p95 지연 시간이 전주 대비 두 배가 되면 알림
- 일일 비용이 평소의 2배를 초과하여 급증하면 알림
- 단일 사용자의 일일 비용이 $X를 초과하면 알림
두 모델 비교
단계별 지표를 사용하면 모델을 A/B 방식으로 비교할 수 있습니다:
# Run 100 traces with gpt-4o-mini and 100 with haiku
# Compare p95 latency and average cost
# Pick the winner for the use case
print("Run 100 traces with gpt-4o-mini and 100 with haiku")
print("Compare p95 latency and average cost")
print("Pick the winner for the use case")
토큰 분포 추적
입력 토큰과 출력 토큰의 히스토그램을 보면 문제를 발견할 수 있습니다. 예를 들어 최대 토큰 수에 계속 도달한다면 출력이 잘리고 있다는 뜻이며, 이는 버그입니다.
백분위수를 사용하는 이유
평균 대신 p95 지연 시간을 보고하는 이유는 무엇일까요?
정리
단계별 지연 시간과 비용을 트레이스별·사용자별로 집계하고, 평균이 아닌 백분위수를 사용하며, 이상값에 대해 알림을 설정합니다. 이것이 대시보드의 핵심입니다.
자주 묻는 질문
“단계별 지연 시간 및 비용” 강의는 무료인가요?
네 — “단계별 지연 시간 및 비용” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 AI Agents 강의 전체를 잠금 해제할 수 있습니다. AI Agents 강의에는 총 4개의 강의가 포함되어 있습니다.
“단계별 지연 시간 및 비용”에서 뭘 배우나요?
각 노드의 토큰 사용량과 실제 경과 시간을 측정해 느리고 비용이 큰 단계를 찾아보세요. 브라우저에서 직접 실행하는 실습 코드로 AI Agents을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
AI Agents을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 AI Agents은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“단계별 지연 시간 및 비용” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 AI Agents 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 AI Agents 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.