# メトリクス

Source: https://aiand-docs-staging.pages.dev/ja/analytics/metrics/

```http
GET /analytics/metrics?range=<range>
```

呼び出し元組織の時間バケット集計メトリクスを返します。チャート、ダッシュボード、容量計画に便利です。

## クエリパラメータ

| パラメータ | 型 | 必須 | 説明 |
|-----------|------|------|------|
| `range` | string | 必須 | `1h`、`24h`、`7days`、`30days`、`3months` のいずれか。サーバ側で適切なバケット幅を選択。 |

## レスポンス

```json
{
  "range": "24h",
  "buckets": [
    {
      "ts": "2026-05-18T00:00:00Z",
      "requests": 1234,
      "input_tokens": 567890,
      "output_tokens": 12345,
      "cost_usd": 1.23,
      "errors": 5,
      "p50_latency_ms": 420,
      "p95_latency_ms": 1850
    }
  ]
}
```

## キャッシュ

レスポンスは singleflight 重複排除付きで **120 秒** キャッシュされます — その間の繰り返し呼び出しはキャッシュからレスポンスされ、分析バックエンドへの再クエリは発生しません。

## 認証

API キー、または JWT + `X-Org-ID`。[認証](/ja/authentication/) を参照。

<Aside type="note">
  メトリクスは近似集計ストアから算出しています。リクエスト数が非常に多い場合、課金基準の数値とわずかにずれることがあります — 正確な集計が必要な場合は [サマリー](/ja/analytics/summary/) を参照してください。
</Aside>