Зміст

Огляд Перевірка стану Метрики та моніторинг Налаштування сповіщень Логування запитів Розподілена трасування Моніторинг 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

Налаштування сповіщень

Сповіщення через вебхук

Створити сповіщення
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 Trace Context для розподілених систем:

W3C Trace Context
// Запит включає контекст трасування
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID трасування: 4bf92f3577b34da6a3ce929d0e0e4736
// ID спану: 00f067aa0ba902b7
// Відібрано: true (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. Використовуйте ID запитів

Завжди корелюйте запити з унікальними ID для сквозного трасування.

4. Впровадьте розподілене трасування

Використовуйте W3C Trace Context для видимості в мікросервісах.

5. Регулярно тестуйте сповіщення

Тестуйте канали сповіщень щомісяця, щоб переконатися у працездатності ескалації.

6. Документуйте реакцію на сповіщення

Створюйте інструкції для поширених сповіщень з кроками вирішення.

Забезпечте 99.9% доступності

Моніторьте Smart Money API з комплексними перевірками здоров'я, метриками та сповіщеннями. Дотримуйтесь SLA за допомогою вбудованих інструментів спостереження.

Розпочати

Плани Pro та Enterprise включають персональну підтримку та моніторинг SLA.