جدول المحتويات

نظرة عامة فحوصات الصحة المقاييس والمراقبة إعداد التنبيهات تسجيل الطلبات التتبع الموزع مراقبة SLA لوحات التحكم أدوات المراقبة أفضل الممارسات

توثيق API

مراقبة API، المقاييس، وفحوصات الصحة

راقب Smart Money API مع فحوصات صحة شاملة، مقاييس أداء، وتنبيهات. تتبع وقت التشغيل، زمن الوصول، معدلات الأخطاء، والالتزام بـ SLA.

نشر في 21 مارس 2026 • 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
  }
}

احصل على مفتاح API في 30 ثانية

هل أنت مستعد للبناء؟ احصل على مفتاح 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

إعداد التنبيهات

تنبيهات Webhook

إنشاء تنبيه
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
معرف الطلب للتتبع
طريقة HTTP والمسار
حالة الاستجابة وزمن الوصول
معرف المستخدم وبصمة مفتاح API
رسائل الخطأ إن وجدت

تتبع موزع

تتبع معرف الطلب

رؤوس التتبع
// جميع الطلبات تتضمن رؤوس تتبع
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// الرد يتضمن نفس المعرف
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

نشر سياق التتبع

استخدم معيار W3C Trace Context للأنظمة الموزعة:

W3C Trace Context
// الطلب يتضمن سياق التتبع
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// معرف التتبع: 4bf92f3577b34da6a3ce929d0e0e4736
// معرف الامتداد: 00f067aa0ba902b7
// تم أخذ العينة: صحيح (01)

مراقبة SLA

أهداف مستوى الخدمة

الخطة	وقت التشغيل SLA	زمن الاستجابة	الدعم
مجاني	99%	أفضل جهد	المجتمع
متداول	99.5%	<200ms p95	البريد الإلكتروني
Pro	99.95%	<100ms p95	أولوية
Enterprise	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. استخدم معرفات الطلبات

اربط الطلبات دائمًا بمعرفات فريدة للتتبع من البداية إلى النهاية.

4. نفذ التتبع الموزع

استخدم W3C Trace Context للرؤية عبر الخدمات المصغرة.

5. اختبار التنبيهات بانتظام

اختبر قنوات التنبيه شهريًا لضمان عمل التصعيد.

6. توثيق استجابة التنبيه

أنشئ كتيبات تشغيل للتنبيهات الشائعة مع خطوات الحل.

ضمان 99.9% وقت تشغيل

راقب Smart Money API بفحوصات صحية شاملة ومقاييس وتنبيهات. حافظ على الامتثال لـ SLA باستخدام أدوات المراقبة المدمجة.

ابدأ الآن

تتضمن خطط Pro وEnterprise دعمًا مخصصًا ومراقبة SLA.