Содержание

Обзор Health Checks Metrics & Monitoring Настройка оповещений Логирование запросов Распределенная трассировка Мониторинг SLA Дашборды Инструменты мониторинга Лучшие практики

Документация API

API Monitoring, Metrics, and Health Checks

Мониторьте Smart Money API с помощью комплексных проверок работоспособности, метрик производительности и оповещений. Отслеживайте время безотказной работы, задержку, частоту ошибок и соответствие SLA.

Опубликовано 21 марта 2026 • 13 минут чтения • Операции

Обзор мониторинга

Smart Money API предоставляет комплексные возможности мониторинга для отслеживания работоспособности, производительности и надежности сервиса. Реализуйте эти стратегии мониторинга, чтобы обнаруживать проблемы на ранних этапах и поддерживать высокую доступность.

Три уровня мониторинга:

Health Checks — Доступность конечной точки и базовая функциональность
Metrics — Данные о производительности (задержка, пропускная способность, частота ошибок)
Logging — Детали запросов/ответов для отладки и аудита

Целевые метрики: 99.9% времени безотказной работы, <100ms p95 задержки, <0.1% частота ошибок, <5 секунд среднее время обнаружения.

Health Checks

Конечная точка работоспособности API

Health Check
// Простая проверка работоспособности (без авторизации)
GET /health
// Ответ
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Подробный статус работоспособности

Detailed 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
  }
}

Получите ваш API-ключ за 30 секунд

Готовы начать разработку? Получите бесплатный API-ключ (100 вызовов/день, без карты) и начните получать данные о китах, финансировании и блокчейне в реальном времени.

Получите ваш API-ключ →

Metrics & Monitoring

Ключевые метрики для отслеживания

Метрика	Цель	Порог оповещения
Время безотказной работы	99.9%	<99.5%
P95 Latency	<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 span: 00f067aa0ba902b7
// Включен в выборку: true (01)

Мониторинг SLA

Целевые показатели уровня сервиса

Тариф	SLA доступности	Время ответа	Поддержка
Бесплатный	99%	Минимальная	Сообщество
Трейдер	99.5%	<200ms p95	Email
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 Query
// Запрос частоты 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. Используйте ID запросов

Всегда связывайте запросы с уникальными ID для сквозной трассировки.

4. Внедрите распределенную трассировку

Используйте W3C Trace Context для видимости в микросервисах.

5. Регулярно тестируйте алерты

Проверяйте каналы алертов ежемесячно, чтобы убедиться в их работе.

6. Документируйте реакцию на алерты

Создавайте руководства для типовых алертов с шагами решения.

Обеспечьте 99.9% доступности

Мониторьте Smart Money API с проверками здоровья, метриками и алертами. Соблюдайте SLA с встроенными инструментами наблюдаемости.

Начать

Тарифы Pro и Enterprise включают персональную поддержку и мониторинг SLA.