İçindekiler

Genel Bakış Sağlık Kontrolleri Metrikler & İzleme Uyarı Ayarları İstek Kayıtları Dağıtılmış İzleme SLA İzleme Gösterge Panoları İzleme Araçları En İyi Uygulamalar

API Dokümantasyonu

API İzleme, Metrikler ve Sağlık Kontrolleri

Smart Money API'yi kapsamlı sağlık kontrolleri, performans metrikleri ve uyarı sistemleri ile izleyin. Çalışma süresi, gecikme, hata oranları ve SLA uyumunu takip edin.

21 Mart 2026 tarihinde yayınlandı • 13 dakikalık okuma • Operasyonlar

İzleme Genel Bakış

Smart Money API, servis sağlığını, performansını ve güvenilirliğini takip etmek için kapsamlı izleme yetenekleri sunar. Sorunları erken tespit etmek ve yüksek çalışma süresi sağlamak için bu izleme stratejilerini uygulayın.

Üç katmanlı izleme:

Sağlık Kontrolleri — Uç nokta erişilebilirliği ve temel işlevsellik
Metrikler — Performans verileri (gecikme, iş hacmi, hata oranları)
Kayıt Tutma — Hata ayıklama ve denetim için istek/yanıt detayları

Hedef Metrikler: %99.9 çalışma süresi, <100ms p95 gecikme, <%0.1 hata oranı, <5 saniye ortalama tespit süresi.

Sağlık Kontrolleri

API Sağlık Uç Noktası

Sağlık Kontrolü
// Basit canlılık kontrolü (kimlik doğrulama gerekmez)
GET /health
// Yanıt
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Detaylı Sağlık Durumu

Detaylı Sağlık
// Bileşen sağlığı ile detaylı durum
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
  }
}

API anahtarınızı 30 saniyede alın

Hazır mısınız? Ücretsiz bir API anahtarı alın (günde 100 çağrı, kart gerekmez) ve canlı balina, fonlama ve zincir üstü verileri çekmeye başlayın.

API anahtarını al →

Metrikler & İzleme

Takip Edilecek Temel Metrikler

Metrik	Hedef	Uyarı Eşiği
Çalışma Süresi	99.9%	<99.5%
P95 Gecikme	<100ms	>500ms
Hata Oranı	<0.1%	>1%
İstek/sn	Değişken	Limite yaklaşıyor
Önbellek İsabet Oranı	>70%	<50%

Metrik API Uç Noktası

Metrik Sorgusu
// İzleme için API metriklerini alın
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Metrikleri Prometheus formatında döndürür
# HELP api_requests_total Toplam API istekleri
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Uyarı Ayarları

Webhook Uyarıları

Uyarı Oluştur
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Yüksek Hata Oranı",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Uyarı Türleri

Çalışma Süresi Uyarısı — API 5+ dakikadır kullanılamıyor
Gecikme Uyarısı — P95 gecikme eşiği aşıldı
Hata Oranı Uyarısı — Hata oranı %1'in üzerinde
Oran Limiti Uyarısı — Oran limitine yaklaşılıyor
Veri Tazeliği Uyarısı — Veri eşik değerinden eski

İstek Kayıtları

Günlük Seviyeleri

Günlük Örneği
// Tipik API istek günlük girişi
{
 "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
}

Yapılandırılmış Loglama

Tüm loglar kolay ayrıştırma ve analiz için JSON formatında yapılandırılmıştır:

ISO 8601 formatında zaman damgası
İzleme için istek kimliği
HTTP metodu ve yolu
Yanıt durumu ve gecikme süresi
Kullanıcı kimliği ve API anahtar parmak izi
Varsa hata mesajları

Dağıtılmış İzleme

İstek Kimliği Takibi

İzleme Başlıkları
// Tüm istekler izleme başlıkları içerir
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Yanıt aynı kimliği içerir
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

İz Bağlamı Yayılımı

Dağıtılmış sistemler için W3C İz Bağlamı standardını kullanın:

W3C İz Bağlamı
// İstek iz bağlamı içerir
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// İz Kimliği: 4bf92f3577b34da6a3ce929d0e0e4736
// Span Kimliği: 00f067aa0ba902b7
// Örneklenmiş: true (01)

SLA İzleme

Hizmet Seviyesi Hedefleri

Plan	Çalışma Süresi SLA	Yanıt Süresi	Destek
Ücretsiz	99%	En iyi çaba	Topluluk
Trader	99.5%	<200ms p95	E-posta
Pro	99.95%	<100ms p95	Öncelikli
Enterprise	99.99%	<50ms p95	Özel

SLA Kredileri

Çalışma süresi SLA'nın altına düşerse, hizmet kredileri alın:

99.0% - 99.5%: %10 aylık kredi
95.0% - 99.0%: %25 aylık kredi
< 95.0%: %100 aylık kredi

İzleme Panoları

Entegre Pano

Performans panosuna şu adresten erişin: https://status.smartmoney.io

Özel Pano Kurulumu

Prometheus Sorgusu
// API istek oranını sorgula
rate(api_requests_total[5m])
// Hata oranını sorgula
rate(api_requests_total{status=~"5.."}[5m])
// Gecikme yüzdesini sorgula
histogram_quantile(0.95, api_request_duration_ms)

İzleme Aracı Entegrasyonu

Desteklenen Platformlar

Araç	Entegrasyon	Özellikler
Prometheus	Yerel /metrics endpoint	Metrik tarama
Grafana	Veri kaynağı eklentisi	Özel panolar
Datadog	API entegrasyonu	APM izleme
New Relic	Ajan entegrasyonu	Tam gözlemlenebilirlik
PagerDuty	Webhook uyarıları	Olay yönetimi

İzleme En İyi Uygulamaları

1. Ana Metrikleri İzleyin

İşinizi doğrudan etkileyen metrikler üzerinde odaklanın: çalışma süresi, gecikme, hata oranı.

2. Uygun Uyarıları Ayarlayın

Sadece eşik değerlerine değil, semptomlara göre uyarı verin. Uyarıları önem derecesine göre yönlendirin.

3. İstek Kimlikleri Kullanın

Uçtan uca izleme için istekleri her zaman benzersiz kimliklerle ilişkilendirin.

4. Dağıtılmış İzleme Uygulayın

Mikroservisler arasında görünürlük için W3C İz Bağlamı'nı kullanın.

5. Düzenli Uyarı Testleri

Eskalasyonun çalıştığından emin olmak için uyarı kanallarını aylık olarak test edin.

6. Uyarı Yanıtını Belgeleyin

Çözüm adımlarıyla birlikte yaygın uyarılar için çalışma kitapları oluşturun.

%99,9 Çalışma Süresi Sağlayın

Kapsamlı sağlık kontrolleri, metrikler ve uyarılar ile Smart Money API'ınızı izleyin. Entegre gözlemlenebilirlik araçları ile SLA uyumluluğunu koruyun.

Başlayın

Pro ve Enterprise planları özel destek ve SLA izleme içerir.