မာတိကာ

အခြေခံအကျဉ်း Health Checks Metrics & Monitoring Alerting Setup Request Logging Distributed Tracing SLA Monitoring Dashboards Monitoring Tools Best Practices

API Documentation

API Monitoring, Metrics, and Health Checks

Smart Money API ကို ကျန်းမာရေးစစ်ဆေးမှုများ၊ စွမ်းဆောင်ရည်မက်ထရစ်များနှင့် အချက်ပေးစနစ်များဖြင့် စောင့်ကြည့်ပါ။ အလုပ်လုပ်ချိန်၊ နှောင့်နှေးမှု၊ အမှားနှုန်းနှင့် SLA လိုက်နာမှုကို ခြေရာခံပါ။

မတ်လ ၂၁၊ ၂၀၂၆ တွင် ထုတ်ဝေသည် • ၁၃ မိနစ် ဖတ်ရန် • လုပ်ငန်းဆောင်တာများ

Monitoring Overview

Smart Money API သည် ဝန်ဆောင်မှုကျန်းမာရေး၊ စွမ်းဆောင်ရည်နှင့် ယုံကြည်စိတ်ချရမှုကို ခြေရာခံရန် ကျယ်ပြန့်သော စောင့်ကြည့်မှုစွမ်းရည်များကို ပေးစွမ်းသည်။ ပြဿနာများကို အစောပိုင်းသိရှိရန်နှင့် အလုပ်လုပ်ချိန်မြင့်မားစွာထိန်းသိမ်းရန် ဤစောင့်ကြည့်မှုဗျူဟာများကို အကောင်အထည်ဖော်ပါ။

စောင့်ကြည့်မှုအလွှာ သုံးခု-

Health Checks — Endpoint ရရှိနိုင်မှုနှင့် အခြေခံလုပ်ဆောင်ချက်
Metrics — စွမ်းဆောင်ရည်ဒေတာ (နှောင့်နှေးမှု၊ စီးဆင်းမှု၊ အမှားနှုန်း)
Logging — ချွင်းချက်ရှာဖွေရေးနှင့် စစ်ဆေးရေးအတွက် တောင်းဆိုမှု/တုံ့ပြန်မှုအသေးစိတ်

Target Metrics- 99.9% uptime, <100ms p95 latency, <0.1% error rate, <5 second mean time to detect.

Health Checks

API Health Endpoint

Health Check
// Simple liveness check (no auth required)
GET /health
// Response
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Detailed Health Status

Detailed Health
// Detailed status with component health
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
  }
}

Get your API key in 30 seconds

Ready to build? Grab a free API key (200 calls/day, no card) and start pulling live whale, funding and on-chain data.

Get your API key →

Metrics & Monitoring

Key Metrics to Track

Metric	Target	Alert Threshold
Uptime	99.9%	<99.5%
P95 Latency	<100ms	>500ms
Error Rate	<0.1%	>1%
Requests/sec	Varies	Approaching limit
Cache Hit Rate	>70%	<50%

Metrics API Endpoint

Metrics Query
// Get API metrics for monitoring
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Returns metrics in Prometheus format
# HELP api_requests_total Total API requests
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Alerting Setup

Webhook Alerts

Create Alert
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "High Error Rate",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Alert Types

Uptime Alert — API unavailable for 5+ minutes
Latency Alert — P95 latency exceeds threshold
Error Rate Alert — Error rate above 1%
Rate Limit Alert — Approaching rate limit
Data Freshness Alert — Data older than threshold

Request Logging

Log Levels

Log Example
// Typical API request log entry
{
 "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 ဖော်မတ်ဖြင့် အချိန်တံဆိပ်
တစ်ဆင့်ပြီးတစ်ဆင့် ခြေရာခံရန် Request ID
HTTP method နှင့် path
တုံ့ပြန်မှု status နှင့် latency
User ID နှင့် API key fingerprint
အမှားတစ်ခုဖြစ်ပါက အမှားအကြောင်းအရာ

ဖြန့်ဝေထားသော ခြေရာခံခြင်း

Request 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

Trace Context ဖြန့်ဝေခြင်း

ဖြန့်ဝေထားသော စနစ်များအတွက် W3C Trace Context စံနှုန်းကို အသုံးပြုပါ။

W3C Trace Context
// တောင်းဆိုမှုတွင် trace context ပါဝင်သည်
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Trace ID: 4bf92f3577b34da6a3ce929d0e0e4736
// Span ID: 00f067aa0ba902b7
// Sampled: true (01)

SLA စောင့်ကြည့်ခြင်း

ဝန်ဆောင်မှု အဆင့်ဆင့် ရည်မှန်းချက်များ

အစီအစဉ်	Uptime SLA	တုံ့ပြန်မှုအချိန်	အထောက်အပံ့
အခမဲ့	99%	အကောင်းဆုံးကြိုးစားမှု	အသိုင်းအဝိုင်း
ကုန်သည်တစ်ဦး	99.5%	<200ms p95	အီးမေးလ်
Pro	99.95%	<100ms p95	ဦးစားပေး
Enterprise	99.99%	<50ms p95	သီးသန့်

SLA ခရက်ဒစ်များ

Uptime သည် SLA အောက်သို့ ကျဆင်းပါက ဝန်ဆောင်မှု ခရက်ဒစ်များ ရရှိမည်။

99.0% - 99.5%: 10% လစဉ်ခရက်ဒစ်
95.0% - 99.0%: 25% လစဉ်ခရက်ဒစ်
< 95.0%: 100% လစဉ်ခရက်ဒစ်

စောင့်ကြည့်ရေး ဒိုင်ခွက်များ

ပါဝင်သော ဒိုင်ခွက်

စွမ်းဆောင်ရည်ဒက်ရှ်ဘုတ်ကို ဤနေရာတွင် ဝင်ရောက်ကြည့်ရှုပါ: https://status.smartmoney.io

စိတ်ကြိုက်ဒက်ရှ်ဘုတ်ပြင်ဆင်ခြင်း

Prometheus Query
// Query API request rate
rate(api_requests_total[5m])
// Query error rate
rate(api_requests_total{status=~"5.."}[5m])
// Query latency percentile
histogram_quantile(0.95, api_request_duration_ms)

စောင့်ကြည့်ရေးကိရိယာများနှင့်ပေါင်းစည်းခြင်း

ပံ့ပိုးထားသောပလက်ဖောင်းများ

ကိရိယာ	ပေါင်းစည်းခြင်း	အင်္ဂါရပ်များ
Prometheus	Native /metrics endpoint	Metrics scraping
Grafana	Datasource plugin	စိတ်ကြိုက်ဒက်ရှ်ဘုတ်များ
Datadog	API integration	APM tracing
New Relic	Agent integration	Full observability
PagerDuty	Webhook alerts	အရေးပေါ်အခြေအနေစီမံခန့်ခွဲမှု

စောင့်ကြည့်ရေးအကောင်းဆုံးလုပ်ထုံးလုပ်နည်းများ

1. အဓိကစံညွှန်းများကိုစောင့်ကြည့်ပါ

သင့်လုပ်ငန်းကိုတိုက်ရိုက်အကျိုးသက်ရောက်မှုရှိသော စံညွှန်းများကို အာရုံစိုက်ပါ - uptime, latency, error rate။

2. သင့်တော်သော အသိပေးချက်များသတ်မှတ်ပါ

အခြေအနေကိုသာအသိပေးပါ၊ အတိုင်းအတာများသာမက။ အသိပေးချက်များကို အရေးကြီးမှုအလိုက်လမ်းကြောင်းသတ်မှတ်ပါ။

3. Request IDs များကိုအသုံးပြုပါ

End-to-end tracing အတွက် request များကို unique IDs များနှင့်အမြဲဆက်စပ်ပါ။

4. Distributed Tracing ကိုအကောင်အထည်ဖော်ပါ

Microservices များကိုဖြတ်သန်းမြင်နိုင်ရန် W3C Trace Context ကိုအသုံးပြုပါ။

5. အသိပေးချက်စမ်းသပ်မှုများကိုပုံမှန်ပြုလုပ်ပါ

အဆင့်မြှင့်တင်မှုများအလုပ်လုပ်ကြောင်းသေချာစေရန် အသိပေးချက်လမ်းကြောင်းများကို လစဉ်စမ်းသပ်ပါ။

6. အသိပေးချက်တုံ့ပြန်မှုကိုမှတ်တမ်းတင်ပါ

အဖြေရှာခြင်းအဆင့်များပါရှိသော အသိပေးချက်များအတွက် runbooks များဖန်တီးပါ။

99.9% Uptime သေချာစေပါ

Smart Money API ကို ကျန်းမာရေးစစ်ဆေးမှုများ၊ စံညွှန်းများနှင့် အသိပေးချက်များဖြင့် စောင့်ကြည့်ပါ။ SLA လိုက်နာမှုကို built-in observability ကိရိယာများဖြင့် ထိန်းသိမ်းပါ။

စတင်လိုက်ပါ

Pro နှင့် Enterprise အစီအစဉ်များတွင် အထူးပံ့ပိုးမှုနှင့် SLA စောင့်ကြည့်မှုပါဝင်သည်။