MygramDB

日本語

English

日本語

English

Appearance

HTTP API ガイド ​

MygramDB は、WebアプリケーションやHTTPクライアントとの統合を容易にするRESTful JSON APIを提供します。

TCP APIとの違い

HTTP APIは検索・カウント・ファセット・ドキュメント取得をJSONで扱うための入口です。SYNC、DUMP、SET などの運用コマンドはTCP/CLI側で実行します。

設定 ​

config.yaml でHTTPサーバーを有効化します：

yaml
api:
  tcp:
    bind: "127.0.0.1"
    port: 11016
  admin_token: "replace-with-a-secret"
  http:
    enable: true          # HTTPサーバーを有効化
    bind: "127.0.0.1"     # バインドアドレス（デフォルト: ローカルホストのみ）
    port: 8080            # HTTPポート（デフォルト: 8080）
    max_connections: 10000 # HTTP ワーカー待ちのソケットも含む
    max_body_bytes: 16777216 # リクエスト本文上限（既定は16 MiB）
    trusted_proxies: []   # X-Forwarded-For を信頼する数値形式のプロキシ IP
    enable_cors: false    # ブラウザ公開時のみ有効化
    cors_allow_origin: "" # CORS有効時は許可するOriginを指定

公開時のセキュリティ

デフォルトでは TCP/HTTP サーバーはループバックにのみバインドします。公開する必要がある場合は api.tcp.bind / api.http.bind を明示的に設定し、network.allow_cidrs で許可 IP を厳密に指定し、MygramDB の前段に TLS/認証付きリバースプロキシ等を配置してください。CORS はデフォルトで無効であり、信頼できるOriginに限定して使用します。

api.http.max_connections は、HTTP ワーカーを待つソケットも含めて受け入れる接続数を制限します。api.http.max_body_bytes を超える POST 本文は、ルーティング前に 413 Payload Too Large で拒否されます。既定値は 16 MiB です。api.http.trusted_proxies には数値形式のプロキシ IP アドレスを列挙します。MygramDB は直接の TCP 接続元がこの一覧と完全一致した場合だけ X-Forwarded-For を信頼し、それ以外のクライアントが直接付けたヘッダーは無視します。ACL はレート制限より先に評価され、どちらもこの条件を満たしたクライアント識別子を使います。

用語補足

CORS はブラウザが別ドメインのAPIを呼ぶための仕組みです。サーバー間通信では通常不要です。ブラウザから直接MygramDBを呼ぶ場合だけ、信頼できるOriginに限定して有効化してください。

API エンドポイント ​

ハンドラーが生成するレスポンスは、/metrics を除き Content-Type: application/json の JSON を返します。/metrics は Prometheus テキストを返します。CORS プリフライトの OPTIONS リクエストは本文なしの 204 No Content を返します。テーブルルートは単一の 識別子セグメント /tables/{identity} を使用します。{identity} は DB 修飾名 `database.table` です（たとえば app_db データベースの articles テーブルは /tables/app_db.articles と指定します）。 単一データベース構成（設定されている個別のデータベースが1つだけ）の場合は、修飾なしの table 名も そのデータベースに解決されます。たとえば /tables/articles です。2つ以上のデータベースにまたがる構成の 場合にのみ修飾が必要となり、修飾なしの名前は曖昧として拒否されます。

v1.7.0 で旧ルートの /{table}/search、/{table}/count、/{table}/{primary_key} は削除されました。テーブル操作はすべて /tables/{identity}/... を使ってください。

identity の考え方

identity は「検索対象テーブルを一意に表す名前」です。単一DBでは articles、複数DBでは app_db.articles のように指定します。

POST /tables/{identity}/search ​

フィルタとページネーションを使用した全文検索。

リクエスト:

http
POST /tables/app_db.threads/search HTTP/1.1
Content-Type: application/json

{
  "q": "breaking news AND tech",
  "mode": "boolean",
  "filters": {
    "status": 1,
    "category": "tech"
  },
  "limit": 50,
  "offset": 0
}

リクエストボディパラメータ:

フィールド型必須説明
qstringはい検索テキスト。mode が "boolean" でない限りリテラルとして扱う
modestringいいえ"literal"（既定）または "boolean"
filtersobjectいいえフィルタ条件（カラム: 値のペア）
limitintegerいいえ返す最大結果数（デフォルト: 100、最大: 1000）
offsetintegerいいえスキップする結果数（デフォルト: 0）
sortobjectいいえソート設定（例: {"column": "_score", "order": "DESC"}）
highlightobjectいいえハイライト設定（下記参照）
fuzzyintegerいいえあいまい検索の編集距離（1 または 2）

リテラル検索とBoolean検索 ​

HTTPでは、既定で q をリテラルな検索テキストとして扱います。たとえば AND や LIMIT は演算子や制御句ではなく、通常の検索語です。Boolean式を送るときだけ、"mode": "boolean" を明示してください。

json
{
  "q": "tech AND (AI OR machine learning) NOT old",
  "mode": "boolean",
  "limit": 50
}

Booleanクエリ構文（mode: "boolean"）:

  • シンプル検索: "keyword"
  • 引用符付きフレーズ: "\"breaking news\"" （語句の並びを保ったフレーズを検索）
  • AND演算子: "tech AND AI AND machine learning"
  • OR演算子: "(mysql OR postgresql) AND performance"
  • NOT演算子: "news NOT sports"
  • AND NOT形式: "news AND NOT sports"（同じ除外条件）
  • 組み合わせ: "tech AND AI NOT old"

limit、offset、sort、filters、highlight、fuzzy はJSONフィールドで指定してください。q にこれらの制御句は書けません。リテラルモードでは LIMIT や SORT のような文字列も検索テキストの一部として扱われます。

レスポンス (200 OK):

json
{
  "count": 2,
  "limit": 50,
  "offset": 0,
  "results": [
    {
      "primary_key": "article_101",
      "filters": {
        "status": 1,
        "category": "tech"
      }
    },
    {
      "primary_key": "article_205",
      "filters": {
        "status": 1,
        "category": "tech"
      }
    }
  ]
}

エラーレスポンス (400 Bad Request):

json
{
  "error": "Missing required field: q",
  "error_code": 3000
}

エラーレスポンス (500 Internal Server Error):

json
{
  "error": "Internal server error",
  "error_code": 5
}

ハイライト設定:

フィールド型デフォルト説明
open_tagstring<em>ハイライトする語句の開始タグ
close_tagstring</em>ハイライトする語句の終了タグ
snippet_lengthinteger100スニペットあたりの最大コードポイント数（1-10,000）
max_fragmentsinteger3スニペットフラグメントの最大数（1-100）

ハイライト付き検索の例:

http
POST /tables/app_db.articles/search HTTP/1.1
Content-Type: application/json

{
  "q": "機械学習",
  "highlight": {
    "open_tag": "<strong>",
    "close_tag": "</strong>",
    "snippet_length": 150,
    "max_fragments": 5
  },
  "sort": {"column": "_score", "order": "DESC"},
  "limit": 10
}

POST /tables/{identity}/count ​

全文クエリと任意のフィルタに一致するドキュメント数をカウントします。COUNT は合計件数のみを返します。 ページネーション、ハイライト、あいまい検索、_score ソートは検索専用の機能であり、このエンドポイントでは拒否されます。

リクエスト:

http
POST /tables/app_db.threads/count HTTP/1.1
Content-Type: application/json

{
  "q": "breaking news AND tech",
  "mode": "boolean",
  "filters": {
    "status": 1
  }
}

レスポンス (200 OK):

json
{
  "count": 42
}

POST /tables/{identity}/facet ​

カラムのファセットバケットを返します。クエリとフィルタでスコープを限定することもできます。

リクエストボディパラメータ:

フィールド型必須説明
columnstringはい集計対象のフィルタカラム
qstringいいえファセット対象を絞る検索クエリ
modestringいいえq の "literal"（既定）または "boolean"
filtersobjectいいえ追加のフィルタ条件
limitintegerいいえ返すファセットバケット数の上限（1-1000）
offsetintegerいいえスキップするファセットバケット数（既定: 0）

sort、highlight、fuzzy は FACET ではサポートされず、指定するとエラーになります。

リクエスト:

http
POST /tables/app_db.articles/facet HTTP/1.1
Content-Type: application/json

{
  "column": "category",
  "q": "database OR mysql",
  "mode": "boolean",
  "filters": {
    "status": 1
  },
  "limit": 10
}

レスポンス (200 OK):

json
{
  "column": "category",
  "count": 2,
  "facets": [
    {"value": "tech", "count": 15},
    {"value": "ops", "count": 7}
  ]
}

HTTP API の公開範囲 ​

HTTP API は検索、カウント、ドキュメント取得、ヘルス、メトリクス、レプリケーションステータス、機密値を伏せた設定の参照、POST /optimize を公開します。SET、SHOW VARIABLES、SYNC、DUMP は TCP/CLI コマンドであり、HTTP ルートはありません。

POST /optimize ​

1つのテーブル、または設定済みの全テーブルのポスティングリストを最適化します。JSON オブジェクトに任意の修飾済み table 名を指定します。空のオブジェクトは全テーブルを対象にします。

http
POST /optimize HTTP/1.1
Content-Type: application/json
Authorization: Bearer <token>

{"table":"app_db.articles"}

Content-Type は application/json でなければなりません。api.admin_token が空でない場合、このエンドポイントには正確な Authorization: Bearer <token> ヘッダーが必要です。満たさない場合は WWW-Authenticate: Bearer と error_code: 7 を含む 401 を返します。トークンは定数時間で比較します。ほかの HTTP ルートで Bearer トークンを管理セッションとして使うことはできません。

成功時は { "status": "ok", "result": "OPTIMIZED ..." } を含む 200 を返します。本文で受け付けるフィールドは table だけです。未知のフィールドまたは文字列以外のテーブル名は 400 のリクエストエラーになります。

GET /tables/{identity}/ ​

プライマリキーで単一のドキュメントを取得します。

リクエスト:

http
GET /tables/app_db.threads/thread_12345 HTTP/1.1

レスポンス (200 OK):

json
{
  "primary_key": "thread_12345",
  "filters": {
    "status": 1,
    "user_id": 42
  }
}

エラーレスポンス (404 Not Found):

json
{
  "error": "Document not found",
  "error_code": 8
}

GET /info ​

サーバー情報と詳細統計（Redis風の監視情報）。

/info の用途

/info は人が読んだり、簡単な監視スクリプトからJSONとして扱ったりする用途に向いています。Prometheus/Grafanaで継続監視する場合は /metrics を使ってください。

リクエスト:

http
GET /info HTTP/1.1

レスポンス (200 OK):

json
{
  "server": "MygramDB",
  "version": "1.0.0",
  "uptime_seconds": 3600,
  "total_requests": 15000,
  "total_commands_processed": 15000,
  "memory": {
    "used_memory_bytes": 524288000,
    "used_memory_human": "500.00 MB",
    "peak_memory_bytes": 629145600,
    "peak_memory_human": "600.00 MB",
    "used_memory_index": "400.00 MB",
    "used_memory_documents": "100.00 MB",
    "total_system_memory": 17179869184,
    "total_system_memory_human": "16.00 GB",
    "available_system_memory": 9126805504,
    "available_system_memory_human": "8.50 GB",
    "system_memory_usage_ratio": 0.47,
    "process_rss": 545259520,
    "process_rss_human": "520.00 MB",
    "process_rss_peak": 629145600,
    "process_rss_peak_human": "600.00 MB",
    "memory_health": "HEALTHY"
  },
  "index": {
    "total_documents": 1000000,
    "total_terms": 1500000,
    "total_postings": 5000000,
    "avg_postings_per_term": 3.33,
    "delta_encoded_lists": 1200000,
    "roaring_bitmap_lists": 300000
  },
  "tables": {
    "products": {
      "documents": 500000,
      "terms": 800000,
      "postings": 2500000,
      "ngram_size": 2,
      "memory_bytes": 262144000,
      "memory_human": "250.00 MB"
    },
    "users": {
      "documents": 500000,
      "terms": 700000,
      "postings": 2500000,
      "ngram_size": 1,
      "memory_bytes": 262144000,
      "memory_human": "250.00 MB"
    }
  }
}

レスポンスフィールド:

フィールド説明
serverサーバー名（MygramDB）
versionサーバーバージョン
uptime_secondsサーバー稼働時間（秒）
total_requests処理されたリクエストの総数
total_commands_processed処理されたコマンドの総数
メモリ（アプリケーション）
memory.used_memory_bytes現在のメモリ使用量（バイト）（インデックス + ドキュメント）
memory.used_memory_human人間が読みやすい形式の現在のメモリ使用量
memory.peak_memory_bytesピーク時のメモリ使用量（バイト）
memory.peak_memory_human人間が読みやすい形式のピークメモリ使用量
memory.used_memory_indexインデックスが使用しているメモリ
memory.used_memory_documentsドキュメントストアが使用しているメモリ
メモリ（システム）
memory.total_system_memory物理RAM総容量（バイト）
memory.total_system_memory_human人間が読みやすい形式のシステムメモリ総容量
memory.available_system_memory利用可能な物理RAM（バイト）
memory.available_system_memory_human人間が読みやすい形式の利用可能メモリ
memory.system_memory_usage_ratioシステム全体のメモリ使用率（0.0-1.0）
メモリ（プロセス）
memory.process_rssプロセスRSS（使用中の物理メモリ）（バイト）
memory.process_rss_human人間が読みやすい形式のプロセスRSS
memory.process_rss_peakプロセス開始以降のRSSピーク値（バイト）
memory.process_rss_peak_human人間が読みやすい形式のRSSピーク値
メモリ（ヘルス）
memory.memory_healthメモリヘルスステータス（HEALTHY/WARNING/CRITICAL/UNKNOWN）
インデックス（集計）
index.total_documents全テーブルのドキュメント総数
index.total_termsユニーク語句の総数
index.total_postingsポスティングの総数
index.avg_postings_per_term語句あたりの平均ポスティング数
index.delta_encoded_listsDelta圧縮を使用しているポスティングリスト数
index.roaring_bitmap_listsRoaring Bitmapを使用しているポスティングリスト数
テーブル（テーブルごと）
tables.<name>.documentsテーブル内のドキュメント数
tables.<name>.termsテーブル内の語句数
tables.<name>.postingsテーブル内のポスティング数
tables.<name>.ngram_sizeテーブルのN-gramサイズ
tables.<name>.memory_bytesテーブルのメモリ使用量（バイト）
tables.<name>.memory_human人間が読みやすい形式のテーブルメモリ使用量

メモリヘルスステータス:

  • HEALTHY: システムメモリの20%以上が利用可能
  • WARNING: システムメモリの10-20%が利用可能
  • CRITICAL: システムメモリの10%未満が利用可能（OPTIMIZEは拒否されます）
  • UNKNOWN: ステータスを判定できない

このエンドポイントはJSON形式をサポートする監視ツールとの統合に適しています。

GET /metrics ​

監視とアラーティングのためのPrometheus Exposition Format形式のメトリクスエンドポイント。

用語補足

Prometheus Exposition Format は、Prometheusがメトリクスを収集するためのテキスト形式です。値だけでなく、Counter/Gaugeなどの型やラベルを持てるため、Grafanaなどで時系列として扱いやすくなります。

リクエスト:

http
GET /metrics HTTP/1.1

レスポンス (200 OK):

prometheus
# HELP mygramdb_server_info MygramDB server information
# TYPE mygramdb_server_info gauge
mygramdb_server_info{version="1.0.0"} 1

# HELP mygramdb_server_uptime_seconds Server uptime in seconds
# TYPE mygramdb_server_uptime_seconds counter
mygramdb_server_uptime_seconds 3600

# HELP mygramdb_memory_used_bytes Current memory usage in bytes
# TYPE mygramdb_memory_used_bytes gauge
mygramdb_memory_used_bytes{type="index"} 419430400
mygramdb_memory_used_bytes{type="documents"} 104857600
mygramdb_memory_used_bytes{type="total"} 524288000

# HELP mygramdb_memory_health_status Memory health status (0=UNKNOWN, 1=HEALTHY, 2=WARNING, 3=CRITICAL)
# TYPE mygramdb_memory_health_status gauge
mygramdb_memory_health_status 1

# HELP mygramdb_index_documents_total Total number of documents in the index
# TYPE mygramdb_index_documents_total gauge
mygramdb_index_documents_total{table="products"} 500000
mygramdb_index_documents_total{table="users"} 500000

# HELP mygramdb_command_total Total number of commands executed by type
# TYPE mygramdb_command_total counter
mygramdb_command_total{command="search"} 10000
mygramdb_command_total{command="count"} 2000
mygramdb_command_total{command="get"} 3000

Content-Type: text/plain; version=0.0.4; charset=utf-8

メトリクスカテゴリ:

カテゴリ説明
サーバーメトリクスサーバーバージョン、稼働時間、処理されたコマンド数
コマンド統計コマンドタイプ別の実行回数（search、count、get、infoなど）
メモリメトリクスアプリケーションメモリ（index/documents）、システムメモリ、プロセスRSS、ヘルスステータス
インデックスメトリクスドキュメント数、term数、posting数、最適化ステータス（tableラベル付きテーブル別）
クライアントメトリクス現在の接続数、累計接続数
レプリケーションメトリクスレプリケーションステータス、処理イベント数、操作別カウンタ（MySQLビルドのみ）

メトリクスタイプ:

  • Counter: 単調増加する値（例: mygramdb_command_total）
  • Gauge: 増減する値（例: mygramdb_memory_used_bytes）

Prometheusスクレイプ設定:

yaml
scrape_configs:
  - job_name: 'mygramdb'
    scrape_interval: 15s
    static_configs:
      - targets: ['localhost:8080']
        labels:
          environment: 'production'

主要機能:

  • 標準Prometheus形式: すべてのPrometheusベースの監視スタックと互換性あり
  • 多次元メトリクス: ラベルによるグルーピング（例: table、command、status）
  • メモリヘルストラッキング: アラーティング用の数値ステータス値（1=HEALTHY、2=WARNING、3=CRITICAL）
  • テーブル別メトリクス: テーブル名ごとに分類されたインデックス統計
  • 後方互換性: 既存の/infoエンドポイントは変更なし

/infoとの比較:

機能/info/metrics
フォーマットJSONPrometheusテキスト
用途一般的な監視、デバッグPrometheus/Grafana統合
メトリクスタイプ汎用的な値型付きメトリクス（Counter/Gauge）
多次元対応限定的完全なラベルサポート
互換性任意のHTTPクライアントPrometheusエコシステム

両方のエンドポイントは同じ基礎データを提供しますが、異なる形式です。Prometheus統合には/metricsを使用し、一般的な監視や人間が読みやすい出力には/infoを使用してください。

GET /health ​

ロードバランサーと監視用のヘルスチェックエンドポイント。

リクエスト:

http
GET /health HTTP/1.1

レスポンス (200 OK):

json
{
  "status": "ok",
  "timestamp": 1699000000
}

GET /health/live ​

ライブネスプローブです。HTTPサーバープロセスが稼働していれば、ロード中またはレプリケーションが degraded の場合でも 200 OK を返します。

GET /health/ready ​

トラフィック制御用のレディネスプローブです。初期データの読み込みが完了し、サーバーがロード中ではなく、SYNC が実行中ではなく、設定済みレプリケーションを利用できる場合だけ 200 OK を返します。JSON 本文には data_initialized、loading、status（"ready" または "not_ready"）が含まれます。条件を満たさない場合は 503 Service Unavailable を返します。テーブル読み取りルート（search、count、facet、ドキュメントGET）も、対象テーブルの同期中は 503 を返します。

live と ready の使い分け

Kubernetesでは /health/live をLiveness Probe、/health/ready をReadiness Probeに使ってください。live は「プロセスを再起動すべきか」、ready は「検索トラフィックを流してよいか」を見るためのものです。

GET /health/detail ​

詳細な監視スナップショットです。"status": "healthy" または "status": "degraded" を含む 200 OK を返します。ロードバランサーのレディネス判定にはこのエンドポイントではなく /health/ready を使用してください。/health、/health/live、/health/ready を含め、すべての HTTP ルートが CIDR 許可リストの対象です。

GET /config ​

現在のサーバー設定サマリ（機密値は返却されません）。

リクエスト:

http
GET /config HTTP/1.1

レスポンス (200 OK):

json
{
  "mysql": {
    "configured": true,
    "database_defined": true
  },
  "api": {
    "tcp": {
      "enabled": true
    },
    "http": {
      "enabled": true,
      "cors_enabled": false
    }
  },
  "network": {
    "allow_cidrs_configured": false
  },
  "replication": {
    "enable": true
  },
  "notes": "機密情報はHTTP経由では提供されません。安全な接続上で CONFIG SHOW を利用してください。"
}

GET /replication/status ​

MySQLレプリケーションステータス（レプリケーション有効時のみ）。

リクエスト:

http
GET /replication/status HTTP/1.1

レスポンス (200 OK):

json
{
  "enabled": true,
  "status": "running",
  "current_gtid": "3E11FA47-71CA-11E1-9E33-C80AA9429562:1-5",
  "processed_events": 12345,
  "queue_size": 0
}

エラーレスポンス (503 Service Unavailable):

json
{
  "error": "Replication not configured",
  "error_code": 4
}

CORS サポート ​

ブラウザから直接アクセスする場合は api.http.enable_cors: true を設定し、api.http.cors_allow_origin に信頼できる Origin を指定します。Origin が空の場合、MygramDB は CORS を有効にせず、ワイルドカード Origin も返しません。不要な場合は CORS を無効のままにしてください。

CORS ヘッダー:

Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization

使用例 ​

以下の例では修飾なしの threads 識別子を使用しており、これは単一データベース構成で動作します。 2つ以上のデータベースがある場合は app_db.threads のように修飾してください（例: /tables/app_db.threads/search）。

cURL ​

検索:

bash
curl -X POST http://localhost:8080/tables/threads/search \
  -H "Content-Type: application/json" \
  -d '{
    "q": "機械学習 AND Python",
    "filters": {"status": 1},
    "limit": 10
  }'

ファセット:

bash
curl -X POST http://localhost:8080/tables/threads/facet \
  -H "Content-Type: application/json" \
  -d '{
    "column": "category",
    "q": "機械学習",
    "filters": {"status": 1},
    "limit": 10
  }'

ドキュメント取得:

bash
curl http://localhost:8080/tables/threads/thread_12345

ヘルスチェック:

bash
curl http://localhost:8080/health

JavaScript (fetch) ​

javascript
// 検索
const response = await fetch('http://localhost:8080/tables/threads/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    q: '機械学習 AND Python',
    filters: { status: 1 },
    limit: 10
  })
});

const data = await response.json();
console.log(`${data.count} 件の結果が見つかりました`);
data.results.forEach(doc => {
  console.log(`ドキュメント ${doc.primary_key}`);
});

Python (requests) ​

python
import requests

# 検索
response = requests.post('http://localhost:8080/tables/threads/search', json={
    'q': '機械学習 AND Python',
    'filters': {'status': 1},
    'limit': 10
})

data = response.json()
print(f"{data['count']} 件の結果が見つかりました")
for doc in data['results']:
    print(f"ドキュメント {doc['primary_key']}")

パフォーマンスの考慮事項 ​

  • コネクションプーリング: レイテンシを抑えるためにHTTP keep-aliveを使用
  • ページネーション: 大きな結果セットには limit と offset を使用
  • キャッシング: アプリケーション層で頻繁なクエリのキャッシングを検討
  • ネットワークセキュリティ: network.allow_cidrs を使用して信頼できるIP範囲へのアクセスを制限

エラーハンドリング ​

ハンドラーが生成するエラーレスポンスは次の形式に従います：

json
{
  "error": "エラーメッセージの説明",
  "error_code": 3000
}

error_code は機械処理用の MygramDB エラーコードです。原因に応じてクライアントの動作を分ける場合は、人間向けの error 文字列ではなくこの値を使ってください。リクエスト本文が大きすぎる場合の 413 Payload Too Large は HTTP サーバーがルーティング前に返すため、このレスポンスでは JSON 本文や error_code ではなくステータスコードに基づいて処理してください。

HTTPステータスコード:

コード説明
200成功
400不正なリクエスト（無効な入力）
401未認証（/optimize に必要な Bearer トークンがない、または無効）
403禁止（送信元IPが許可されていない）
404見つかりません（ドキュメントが存在しない）
413Payload Too Large（リクエスト本文が api.http.max_body_bytes を超過）
429リクエスト過多（レート制限を超過）
500内部サーバーエラー
503サービス利用不可、機能無効、レプリケーション利用不可、またはテーブル同期中

監視 ​

HTTP APIは監視と可観測性のための複数のエンドポイントを提供します：

  • ヘルスチェック: GET /health - ロードバランサー用のシンプルなヘルスチェック
  • JSONメトリクス: GET /info - 一般的な監視ツール用のJSON形式の詳細統計
  • Prometheusメトリクス: GET /metrics - 時系列監視とアラーティング用のPrometheus互換メトリクス
  • レプリケーションステータス: GET /replication/status - MySQLレプリケーションステータス

監視スタック統合 ​

Prometheus + Grafana:

  1. Prometheusで/metricsエンドポイントをスクレイプするよう設定
  2. MygramDB用のGrafanaダッシュボードをインポート
  3. メモリヘルス、クエリレイテンシ、レプリケーション遅延に基づくアラートを設定

その他の監視ツール:

  • Datadog/New Relic: /infoのJSONエンドポイントをパース
  • Zabbix: /healthと/infoへのHTTPエージェントチェック
  • Nagios/Icinga: /healthエンドポイントを使用したチェックスクリプト

関連項目 ​