개요 헬스 체크 메트릭 및 모니터링 알림 설정 요청 로깅 분산 추적 SLA 모니터링 대시보드 모니터링 도구 모범 사례

API 문서

API 모니터링, 메트릭 및 헬스 체크

Smart Money API를 종합적인 헬스 체크, 성능 메트릭, 알림으로 모니터링하세요. 가동 시간, 지연 시간, 오류율 및 SLA 준수 여부를 추적할 수 있습니다.

2026년 3월 21일 게시 • 13분 읽기 • 운영

모니터링 개요

Smart Money API는 서비스 상태, 성능 및 안정성을 추적하기 위한 종합적인 모니터링 기능을 제공합니다. 이러한 모니터링 전략을 구현하여 문제를 조기에 감지하고 높은 가동 시간을 유지하세요.

모니터링의 세 가지 계층:

헬스 체크 — 엔드포인트 가용성 및 기본 기능
메트릭 — 성능 데이터 (지연 시간, 처리량, 오류율)
로깅 — 디버깅 및 감사를 위한 요청/응답 상세 정보

목표 메트릭: 99.9% 가동 시간, <100ms p95 지연 시간, <0.1% 오류율, <5초 평균 감지 시간.

헬스 체크

API 헬스 엔드포인트

헬스 체크
// 간단한 활성 상태 확인 (인증 불필요)
GET /health
// 응답
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

상세 헬스 상태

상세 헬스
// 구성 요소 상태 포함 상세 상태
GET /v1/status
  -H "Authorization: Bearer token"
{
 "status": "operational",
 "components": {
 "api": "healthy",
 "database": "healthy",
 "cache": "healthy",
 "exchanges": "healthy"
  },
 "metrics": {
 "p95_latency_ms": 85,
 "error_rate": 0.0012,
 "uptime_percent": 99.95
  }
}

30초 내 API 키 발급

빌드할 준비가 되셨나요? 무료 API 키(하루 100회 호출, 카드 불필요)를 받아 실시간 고래, 펀딩 및 온체인 데이터를 가져오세요.

API 키 받기 →

메트릭 및 모니터링

추적할 주요 메트릭

메트릭	목표	알림 임계값
가동 시간	99.9%	<99.5%
P95 지연 시간	<100ms	>500ms
오류율	<0.1%	>1%
초당 요청 수	다양함	한계에 근접
캐시 적중률	>70%	<50%

메트릭 API 엔드포인트

메트릭 쿼리
// 모니터링을 위한 API 메트릭 가져오기
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Prometheus 형식으로 메트릭 반환
# HELP api_requests_total 총 API 요청 수
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

알림 설정

웹훅 알림

알림 생성
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "높은 오류율",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

알림 유형

가동 시간 알림 — API 5분 이상 사용 불가
지연 시간 알림 — P95 지연 시간 임계값 초과
오류율 알림 — 오류율 1% 이상
속도 제한 알림 — 속도 제한에 근접
데이터 신선도 알림 — 임계값보다 오래된 데이터

요청 로깅

로그 수준

로그 예시
// 일반적인 API 요청 로그 항목
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 method: GET,
 path: /v1/whales/btc,
 status: 200,
 duration_ms: 45,
 user_id: acct_12345
}

구조화된 로깅

모든 로그는 분석 및 파싱이 용이하도록 JSON 구조로 제공됩니다:

ISO 8601 형식의 타임스탬프
추적을 위한 요청 ID
HTTP 메소드 및 경로
응답 상태 및 지연 시간
사용자 ID 및 API 키 지문
해당 시 오류 메시지

분산 추적

요청 ID 추적

추적 헤더
// 모든 요청에는 추적 헤더가 포함됩니다
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// 응답에도 동일한 ID가 포함됩니다
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

추적 컨텍스트 전파

분산 시스템을 위한 W3C 추적 컨텍스트 표준 사용:

W3C 추적 컨텍스트
// 요청에 추적 컨텍스트 포함
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// 추적 ID: 4bf92f3577b34da6a3ce929d0e0e4736
// 스팬 ID: 00f067aa0ba902b7
// 샘플링됨: true (01)

SLA 모니터링

서비스 수준 목표

플랜	가동 시간 SLA	응답 시간	지원
무료	99%	최선의 노력	커뮤니티
트레이더	99.5%	<200ms p95	이메일
프로	99.95%	<100ms p95	우선 순위
엔터프라이즈	99.99%	<50ms p95	전용

SLA 크레딧

가동 시간이 SLA 미달 시 서비스 크레딧 제공:

99.0% - 99.5%: 10% 월간 크레딧
95.0% - 99.0%: 25% 월간 크레딧
< 95.0%: 100% 월간 크레딧

모니터링 대시보드

내장 대시보드

성능 대시보드 접속: https://status.smartmoney.io

커스텀 대시보드 설정

Prometheus 쿼리
// API 요청률 쿼리
rate(api_requests_total[5m])
// 오류율 쿼리
rate(api_requests_total{status=~"5.."}[5m])
// 지연 시간 백분위수 쿼리
histogram_quantile(0.95, api_request_duration_ms)

모니터링 도구 통합

지원 플랫폼

도구	통합	기능
Prometheus	네이티브 /metrics 엔드포인트	메트릭 스크래핑
Grafana	데이터소스 플러그인	커스텀 대시보드
Datadog	API 통합	APM 추적
New Relic	에이전트 통합	완전한 관측 가능성
PagerDuty	웹훅 알림	사고 관리

모니터링 모범 사례

1. 핵심 메트릭 모니터링

비즈니스에 직접적인 영향을 미치는 메트릭(가동 시간, 지연 시간, 오류율)에 집중하세요.

2. 적절한 알림 설정

임계값뿐만 아니라 증상에 대해 알림을 설정하세요. 심각도별로 알림을 라우팅하세요.

3. 요청 ID 사용

엔드투엔드 추적을 위해 항상 고유 ID로 요청을 연관시키세요.

4. 분산 추적 구현

마이크로서비스 간 가시성을 위해 W3C 추적 컨텍스트를 사용하세요.

5. 정기적인 알림 테스트

에스컬레이션이 작동하는지 확인하기 위해 매월 알림 채널을 테스트하세요.

6. 알림 응답 문서화

해결 단계가 포함된 일반적인 알림에 대한 실행 문서를 작성하세요.

99.9% 가동 시간 보장

포괄적인 상태 점검, 메트릭 및 알림으로 Smart Money API를 모니터링하세요. 내장된 관측 가능성 도구로 SLA 준수를 유지하세요.

시작하기

프로 및 엔터프라이즈 플랜에는 전용 지원 및 SLA 모니터링이 포함됩니다.