概要ヘルスチェックメトリクスとモニタリングアラート設定リクエストロギング分散トレーシング SLAモニタリングダッシュボードモニタリングツールベストプラクティス

APIドキュメント

APIモニタリング、メトリクス、ヘルスチェック

Smart Money APIを包括的なヘルスチェック、パフォーマンスメトリクス、アラートで監視。稼働時間、レイテンシー、エラー率、SLA遵守状況を追跡。

公開日: 2026年3月21日 • 読了時間13分 • 運用

モニタリング概要

Smart Money APIは、サービスの健全性、パフォーマンス、信頼性を追跡する包括的なモニタリング機能を提供します。これらの監視戦略を実装して、問題を早期に検出し、高い稼働率を維持します。

3層のモニタリング:

ヘルスチェック — エンドポイントの可用性と基本機能
メトリクス — パフォーマンスデータ（レイテンシー、スループット、エラー率）
ロギング — デバッグと監査のためのリクエスト/レスポンス詳細

目標メトリクス: 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
  }
}

30秒でAPIキーを取得

構築準備はOK？無料APIキー（200コール/日、カード不要）を取得して、ライブの鯨情報、資金調達、オンチェーンデータを取得開始。

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形式のタイムスタンプ
トレーシング用のリクエスト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トレースコンテキスト標準を使用：

W3Cトレースコンテキスト
// リクエストにはトレースコンテキストが含まれます
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// トレースID: 4bf92f3577b34da6a3ce929d0e0e4736
// スパンID: 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	ウェブフックアラート	インシデント管理

モニタリングベストプラクティス

1. 主要なメトリクスを監視する

ビジネスに直接影響を与えるメトリクスに焦点を当てる：稼働時間、レイテンシ、エラーレート。

2. 適切なアラートを設定する

しきい値だけでなく症状に基づいてアラートを設定する。重大度に応じてアラートをルーティングする。

3. リクエストIDを使用する

エンドツーエンドのトレーシングのために、常にリクエストを一意のIDと関連付ける。

4. 分散トレーシングを実装する

マイクロサービス全体の可視性のためにW3Cトレースコンテキストを使用する。

5. 定期的なアラートテスト

エスカレーションが機能することを確認するために、毎月アラートチャネルをテストする。

6. アラート対応を文書化する

解決手順を含む一般的なアラートのための実行マニュアルを作成する。

99.9%の稼働時間を確保

包括的なヘルスチェック、メトリクス、アラートでSmart Money APIを監視。組み込みの可観測性ツールでSLA準拠を維持。

始める

プロおよびエンタープライズプランには専用サポートとSLAモニタリングが含まれます。