Latency エンドポイント

GET/api/v1/latency

複数の外部 Latency Agent から 1 つの公開 TCP ターゲットへの履歴を読み取ります。Cloudflare 自身の遅延はこのレスポンスに含まれません。Status または Checks を使用してください。

クエリパラメータ

パラメータ	必須	既定	範囲	目的
target_id	はい	—	公開 TCP ターゲット ID	プローブ対象
hours	いいえ	24	1–168	履歴ウィンドウ

curl -fsSL 'https://YOUR-API/api/v1/latency?target_id=vps-a&hours=24'

レスポンス構造

{
  "ok": true,
  "target_id": "vps-a",
  "sources": [
    {
      "id": "home-shanghai",
      "name": "Shanghai Telecom",
      "kind": "external",
      "points": [
        {
          "checked_at": 1760000000,
          "latency_ms": 28.4,
          "ok": true
        }
      ]
    }
  ]
}

sources[]

各ソースは管理画面で作成され、実際に結果を提出した遅延ノードです。レコードの作成だけではデータは生まれません。ノードはインストールコマンドが最初の提出を完了してから履歴に入ります。

target_id が欠落・ターゲットが存在しない・無効の場合、互換実装は ok: false と error を伴う HTTP 200 を返すことがあります。クライアントは JSON の ok を確認してください。

Status の latency_sources は鮮度ウィンドウ内の最新ソースのみを保持し、このエンドポイントは hours 内の履歴を返します。「履歴に古いポイントがあるのに凡例にノードがない」のは通常、ノードが報告を停止したことを意味します。

トラブルシューティングの順序

フロントエンドに Cloudflare しか表示されない場合：

1. 管理画面でノードが有効で、直近の「最終報告」があるか確認する。
2. ノードの systemd とジャーナルを確認する。
3. --once を手動実行し、accepted > 0 を確認する。
4. ターゲットがアドレス非公開でない有効な公開 TCP ターゲットであることを確認する。
5. 短いステータスキャッシュの更新を待ってから、このエンドポイントで sources を確認する。

新しいインストールコマンドはインストーラに古いプロセスを終了させます。古いノードを再起動するだけでは、古いスクリプト・ノード ID・トークンを使い続けることがあります。

既定キャッシュは 30 秒で、target_id と hours がキーに含まれます。返されるのは外部ソースのみです。Cloudflare の現在遅延は Status、履歴は Checks から取得します。