Mục lục

Tổng quan Kiểm tra Tình trạng Số liệu & Giám sát Thiết lập Cảnh báo Ghi nhật ký Yêu cầu Theo dõi Phân tán Giám sát SLA Bảng điều khiển Công cụ Giám sát Thực hành Tốt nhất

Tài liệu API

Giám sát API, Số liệu và Kiểm tra Tình trạng

Giám sát Smart Money API với các kiểm tra tình trạng toàn diện, số liệu hiệu suất và cảnh báo. Theo dõi thời gian hoạt động, độ trễ, tỷ lệ lỗi và tuân thủ SLA.

Đăng ngày 21 tháng 3, 2026 • 13 phút đọc • Vận hành

Tổng quan Giám sát

Smart Money API cung cấp khả năng giám sát toàn diện để theo dõi tình trạng dịch vụ, hiệu suất và độ tin cậy. Triển khai các chiến lược giám sát này để phát hiện sớm các vấn đề và duy trì thời gian hoạt động cao.

Ba lớp giám sát:

Kiểm tra Tình trạng — Khả năng truy cập và chức năng cơ bản của điểm cuối
Số liệu — Dữ liệu hiệu suất (độ trễ, thông lượng, tỷ lệ lỗi)
Ghi nhật ký — Chi tiết yêu cầu/phản hồi để gỡ lỗi và kiểm tra

Số liệu Mục tiêu: 99.9% thời gian hoạt động, độ trễ p95 <100ms, tỷ lệ lỗi <0.1%, thời gian phát hiện trung bình <5 giây.

Kiểm tra Tình trạng

Điểm cuối Tình trạng API

Kiểm tra Tình trạng
// Kiểm tra hoạt động đơn giản (không yêu cầu xác thực)
GET /health
// Phản hồi
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Tình trạng Chi tiết

Tình trạng Chi tiết
// Trạng thái chi tiết với tình trạng thành phần
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
  }
}

Nhận khóa API của bạn trong 30 giây

Sẵn sàng xây dựng? Lấy khóa API miễn phí (50 lượt gọi/ngày, không cần thẻ) và bắt đầu lấy dữ liệu cá voi, tài trợ và trên chuỗi trực tiếp.

Nhận khóa API →

Số liệu & Giám sát

Số liệu Chính cần Theo dõi

Số liệu	Mục tiêu	Ngưỡng Cảnh báo
Thời gian hoạt động	99.9%	<99.5%
Độ trễ P95	<100ms	>500ms
Tỷ lệ Lỗi	<0.1%	>1%
Yêu cầu/giây	Thay đổi	Tiếp cận giới hạn
Tỷ lệ Trúng Bộ nhớ đệm	>70%	<50%

Điểm cuối Số liệu API

Truy vấn Số liệu
// Lấy số liệu API để giám sát
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Trả về số liệu ở định dạng Prometheus
# HELP api_requests_total Tổng yêu cầu API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Thiết lập Cảnh báo

Cảnh báo Webhook

Tạo Cảnh báo
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Tỷ lệ Lỗi Cao",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Loại Cảnh báo

Cảnh báo Thời gian hoạt động — API không khả dụng trong 5+ phút
Cảnh báo Độ trễ — Độ trễ P95 vượt ngưỡng
Cảnh báo Tỷ lệ Lỗi — Tỷ lệ lỗi trên 1%
Cảnh báo Giới hạn Tốc độ — Tiếp cận giới hạn tốc độ
Cảnh báo Độ tươi Dữ liệu — Dữ liệu cũ hơn ngưỡng

Ghi nhật ký Yêu cầu

Mức độ Ghi nhật ký

Ví dụ Nhật ký
// Mục nhập nhật ký yêu cầu API điển hình
{
 "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
}

Ghi Log Có Cấu Trúc

Tất cả log đều có cấu trúc JSON để dễ phân tích:

Mốc thời gian theo chuẩn ISO 8601
ID yêu cầu để truy vết
Phương thức HTTP và đường dẫn
Trạng thái phản hồi và độ trễ
ID người dùng và dấu vân tay API key
Thông báo lỗi (nếu có)

Truy Vết Phân Tán

Theo Dõi ID Yêu Cầu

Tiêu Đề Truy Vết
// Tất cả yêu cầu đều bao gồm tiêu đề truy vết
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Phản hồi bao gồm cùng ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Lan Truyền Ngữ Cảnh Truy Vết

Sử dụng chuẩn W3C Trace Context cho hệ thống phân tán:

W3C Trace Context
// Yêu cầu bao gồm ngữ cảnh truy vết
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID Truy Vết: 4bf92f3577b34da6a3ce929d0e0e4736
// ID Nhánh: 00f067aa0ba902b7
// Đã lấy mẫu: true (01)

Giám Sát SLA

Mục Tiêu Cấp Dịch Vụ

Gói	SLA Thời Gian Hoạt Động	Thời Gian Phản Hồi	Hỗ Trợ
Miễn Phí	99%	Nỗ lực tốt nhất	Cộng Đồng
Nhà Giao Dịch	99.5%	<200ms p95	Email
Pro	99.95%	<100ms p95	Ưu Tiên
Doanh Nghiệp	99.99%	<50ms p95	Riêng Biệt

Tín Dụng SLA

Nếu thời gian hoạt động dưới SLA, nhận tín dụng dịch vụ:

99.0% - 99.5%: 10% tín dụng hàng tháng
95.0% - 99.0%: 25% tín dụng hàng tháng
< 95.0%: 100% tín dụng hàng tháng

Bảng Điều Khiển Giám Sát

Bảng Điều Khiển Tích Hợp

Truy cập bảng điều khiển hiệu suất tại: https://status.smartmoney.io

Thiết Lập Bảng Điều Khiển Tùy Chỉnh

Truy Vấn Prometheus
// Truy vấn tỷ lệ yêu cầu API
rate(api_requests_total[5m])
// Truy vấn tỷ lệ lỗi
rate(api_requests_total{status=~"5.."}[5m])
// Truy vấn phân vị độ trễ
histogram_quantile(0.95, api_request_duration_ms)

Tích Hợp Công Cụ Giám Sát

Nền Tảng Hỗ Trợ

Công Cụ	Tích Hợp	Tính Năng
Prometheus	Endpoint /metrics gốc	Thu thập metrics
Grafana	Plugin nguồn dữ liệu	Bảng điều khiển tùy chỉnh
Datadog	Tích hợp API	Truy vết APM
New Relic	Tích hợp agent	Quan sát toàn diện
PagerDuty	Cảnh báo webhook	Quản lý sự cố

Thực Hành Giám Sát Tốt Nhất

1. Giám Sát Chỉ Số Chính

Tập trung vào các chỉ số ảnh hưởng trực tiếp đến nghiệp vụ: thời gian hoạt động, độ trễ, tỷ lệ lỗi.

2. Thiết Lập Cảnh Báo Phù Hợp

Cảnh báo dựa trên triệu chứng, không chỉ ngưỡng. Định tuyến cảnh báo theo mức độ nghiêm trọng.

3. Sử Dụng ID Yêu Cầu

Luôn liên kết yêu cầu với ID duy nhất để truy vết end-to-end.

4. Triển Khai Truy Vết Phân Tán

Sử dụng W3C Trace Context để quan sát xuyên suốt microservices.

5. Kiểm Tra Cảnh Báo Định Kỳ

Kiểm tra kênh cảnh báo hàng tháng để đảm bảo quy trình leo thang hoạt động.

6. Tài Liệu Hóa Phản Hồi Cảnh Báo

Tạo runbook cho các cảnh báo phổ biến với các bước xử lý.

Đảm Bảo 99.9% Thời Gian Hoạt Động

Giám sát Smart Money API với kiểm tra sức khỏe toàn diện, chỉ số và cảnh báo. Duy trì tuân thủ SLA bằng công cụ quan sát tích hợp.

Bắt Đầu

Gói Pro và Doanh nghiệp bao gồm hỗ trợ riêng và giám sát SLA.