Metrics エンドポイント

GET/api/v1/metrics

1 つの Rust Agent の最新状態と履歴を読み取ります。履歴はまず R2 から取得し、要求された上限にダウンサンプリングされます。無制限の生履歴は返されません。

クエリパラメータ

パラメータ	必須	既定	目的
`agent_id`	はい	デプロイ既定 Agent（設定時）	通常 VPS ターゲット ID と一致
`hours`	いいえ	`24`	既定最大 72 時間、デプロイ調整 `1–168`
`max_points`	いいえ	ウィンドウ基準	返されるポイント数。非有限・`0`・負は安全な既定にフォールバック、最小 60
`history`	いいえ	`1`	`0` は最新のみ読み取り
`format`	いいえ	row	`columns` はコンパクトな列型系列を返す
`metric` / `fields`	いいえ	すべて	メトリクスグループ・フィールドを絞り込む

bash

curl -fsSL 'https://YOUR-API/api/v1/metrics?agent_id=vps-a&hours=6&max_points=360'

任意メトリクス

グループ：cpu・mem・disk・load・net・conns・diskio・temp・gpu。またはカンマ区切りフィールド：

text

cpu,mem,disk,load1,net_rx,net_tx,tcp_conns,udp_conns,
disk_read,disk_write,cpu_temp,gpu_temp,gpu_util,
motherboard_temp,disk_temp,chipset_temp

bash

curl -fsSL 'https://YOUR-API/api/v1/metrics?agent_id=vps-a&hours=1&fields=cpu,mem,cpu_temp'

レスポンスフィールド

フィールド	目的
`latest`	最新の Agent サマリー。初回報告前は `null`
`history[]`	昇順の行履歴。列型フォーマットでは空
`series`	`format=columns` 用の `t0`・`dt`・フィールド・値配列
`history_raw_count`	ダウンサンプリング前のポイント数
`history_downsampled`	ダウンサンプリングされたか
`source`	`r2`・`r2+d1-fallback`・`d1` など
`traffic`	現在の請求期間のトラフィックサマリー
`warnings[]`	最新状態・履歴に関する非ブロッキング警告

列型フォーマット

json

{
  "series": {
    "t0": 1760000000,
    "dt": [0, 10, 20],
    "fields": ["cpu", "mem"],
    "values": {
      "cpu": [8.4, 9.1, 7.8],
      "mem": [42.0, 42.1, 42.1]
    }
  }
}

各タイムスタンプは t0 + dt[index] です。クライアントはすべての値配列の長さを確認してください。プロキシが完全な列を返すと仮定しないこと。

history=0 は履歴読み取りをスキップし、最新のみのビューに適しています。format=columns では history が空で、データは series にあります。両方を消費しないでください。サーバーは Agent ID・ウィンドウ・ポイント・フォーマット・フィールドをキャッシュキーに正規化します。

単位と null

単位は現在のフロントエンド表示とレスポンスの意味に従います。温度・GPU・マザーボード・ディスクセンサーはほとんどの仮想化環境で利用できません。欠落した系列は 0°C と表示せず非表示にしてください。

latest.vps_info.total_disk_gb はルートファイルシステムの容量です。ネットワークとディスク IO はレートフィールドです。課金対象トラフィックは永続化された期間台帳から算出され、単一の net_rx/net_tx サンプルからは算出されません。

Metrics エンドポイント ​

クエリパラメータ ​

任意メトリクス ​

レスポンスフィールド ​

列型フォーマット ​

単位と null ​