فهرست مطالب

مرور کلی بررسی‌های وضعیت متریک‌ها و مانیتورینگ تنظیم هشدارها ثبت درخواست‌ها ردیابی توزیع‌شده مانیتورینگ SLA داشبوردها ابزارهای مانیتورینگ بهترین روش‌ها

مستندات API

مانیتورینگ API، متریک‌ها و بررسی‌های وضعیت

Smart Money API را با بررسی‌های جامع وضعیت، متریک‌های عملکرد و هشدارها مانیتور کنید. زمان فعالیت، تاخیر، نرخ خطا و انطباق با SLA را ردیابی کنید.

منتشر شده در 21 مارس 2026 • 13 دقیقه مطالعه • عملیات

مرور کلی مانیتورینگ

Smart Money API قابلیت‌های جامع مانیتورینگ را برای ردیابی وضعیت سرویس، عملکرد و قابلیت اطمینان ارائه می‌دهد. این استراتژی‌های مانیتورینگ را برای تشخیص زودهنگام مشکلات و حفظ زمان فعالیت بالا پیاده‌سازی کنید.

سه لایه مانیتورینگ:

بررسی‌های وضعیت — دسترسی و عملکرد پایانه‌های پایه
متریک‌ها — داده‌های عملکرد (تاخیر، توان عملیاتی، نرخ خطا)
ثبت رویدادها — جزئیات درخواست/پاسخ برای اشکال‌زدایی و حسابرسی

متریک‌های هدف: 99.9% زمان فعالیت، تاخیر p95 کمتر از 100ms، نرخ خطا کمتر از 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
// نمونه‌برداری شده: 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	هشدارهای Webhook	مدیریت حوادث

بهترین روش‌های نظارتی

1. نظارت بر معیارهای کلیدی

بر روی معیارهایی تمرکز کنید که مستقیماً بر کسب‌وکار شما تأثیر می‌گذارند: زمان فعالیت، تأخیر، نرخ خطا.

2. تنظیم هشدارهای مناسب

بر اساس علائم هشدار دهید، نه فقط آستانه‌ها. هشدارها را بر اساس شدت مسیریابی کنید.

3. استفاده از شناسه‌های درخواست

همیشه درخواست‌ها را با شناسه‌های منحصر به فرد برای ردیابی end-to-end مرتبط کنید.

4. پیاده‌سازی ردیابی توزیع‌شده

از W3C Trace Context برای دید در میکروسرویس‌ها استفاده کنید.

5. آزمایش‌های منظم هشدار

کانال‌های هشدار را ماهانه آزمایش کنید تا از کارکرد فرآیند اسکالیت اطمینان حاصل کنید.

6. مستندسازی پاسخ هشدار

راهنماهایی برای هشدارهای متداول با مراحل حل ایجاد کنید.

اطمینان از 99.9% زمان فعالیت

Smart Money API را با بررسی‌های جامع سلامت، معیارها و هشدارها نظارت کنید. با ابزارهای داخلی قابلیت مشاهده، از انطباق SLA اطمینان حاصل کنید.

شروع کنید

طرح‌های Pro و Enterprise شامل پشتیبانی اختصاصی و نظارت بر SLA هستند.