> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# ネットワークパフォーマンス

> アプリケーションのエッジおよびオリジンのレイテンシパーセンタイルを、国・コロ・パスごとの内訳とともに取得します。

指定した時間ウィンドウにおける、アプリケーションのエッジおよびオリジンの応答時間パーセンタイル（`p50`、`p95`、`p99`）に加えて、国別・コロ別・最も遅いパス別の内訳を返します。レイテンシの悪化を診断し、どのルートやリージョンが最も遅いかを特定するのに役立ちます。

<Info>
  **Pro** および **Enterprise** プランでのみ利用可能です。キャッシュミス時のレート制限: オーナーごとに 60 秒あたり 10 リクエスト。
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  アカウントの API キーです。これは[アカウント設定](https://squarecloud.app/ja/account/security)で確認できます。
</ParamField>

### パラメータ

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  アプリケーションの ID。アプリケーションのダッシュボードの URL で確認できます。
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  分析ウィンドウの開始を示す ISO 8601 形式のタイムスタンプ。
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  ISO 8601 形式の終了タイムスタンプ。`start` より後である必要があります。
</ParamField>

### レスポンス

<ResponseField name="status" type="string">
  呼び出しが成功したかどうかを示します。成功した場合は `success`、失敗した場合は `error` です。
</ResponseField>

<ResponseField name="response" type="object">
  ウィンドウ内のレイテンシパーセンタイルと内訳。

  <Expandable title="レスポンスオブジェクトを開閉">
    <ResponseField name="summary" type="object">
      ウィンドウ全体にわたる集計レイテンシパーセンタイル。

      <Expandable title="summary オブジェクトを開閉">
        <ResponseField name="edge" type="object">
          エッジ側のレイテンシパーセンタイル（ミリ秒）。

          <Expandable title="edge オブジェクトを開閉">
            <ResponseField name="p50" type="integer">エッジレイテンシの 50 パーセンタイル（中央値）。</ResponseField>
            <ResponseField name="p95" type="integer">エッジレイテンシの 95 パーセンタイル。</ResponseField>
            <ResponseField name="p99" type="integer">エッジレイテンシの 99 パーセンタイル。</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="origin" type="object">
          オリジン側のレイテンシパーセンタイル（ミリ秒）。

          <Expandable title="origin オブジェクトを開閉">
            <ResponseField name="p50" type="integer">オリジンレイテンシの 50 パーセンタイル（中央値）。</ResponseField>
            <ResponseField name="p95" type="integer">オリジンレイテンシの 95 パーセンタイル。</ResponseField>
            <ResponseField name="p99" type="integer">オリジンレイテンシの 99 パーセンタイル。</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="requests" type="integer">ウィンドウ内で分析されたリクエストの総数。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="timeseries" type="array">
      分析ウィンドウ全体にわたってバケット化されたレイテンシパーセンタイル。

      <Expandable title="timeseries 項目を開閉">
        <ResponseField name="date" type="string">バケットの開始タイムスタンプ（ISO 8601 形式）。</ResponseField>
        <ResponseField name="requests" type="integer">バケット内で観測されたリクエスト数。</ResponseField>
        <ResponseField name="edge" type="object">このバケットのエッジ `p50`/`p95`/`p99`。</ResponseField>
        <ResponseField name="origin" type="object">このバケットのオリジン `p50`/`p95`/`p99`。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="countries" type="array">
      クライアントの国別のレイテンシ内訳。

      <Expandable title="countries 項目を開閉">
        <ResponseField name="type" type="string">ISO 国コード（例: `BR`、`US`）。</ResponseField>
        <ResponseField name="p50" type="integer">この国の中央値レイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="p95" type="integer">この国の 95 パーセンタイルレイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="requests" type="integer">この国に配信されたリクエスト数。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="colos" type="array">
      エッジコロ（データセンター）別のレイテンシ内訳。

      <Expandable title="colos 項目を開閉">
        <ResponseField name="type" type="string">コロ識別子（例: `GRU`、`IAD`）。</ResponseField>
        <ResponseField name="city" type="string">コロが所在する都市。</ResponseField>
        <ResponseField name="country" type="string">コロが所在する国。</ResponseField>
        <ResponseField name="p50" type="integer">このコロの中央値レイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="p95" type="integer">このコロの 95 パーセンタイルレイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="requests" type="integer">このコロを経由して配信されたリクエスト数。</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="slowest_paths" type="array">
      ウィンドウ内で最もレイテンシが高いパス。

      <Expandable title="slowest_paths 項目を開閉">
        <ResponseField name="path" type="string">リクエストパス。</ResponseField>
        <ResponseField name="p95" type="integer">このパスの 95 パーセンタイルレイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="p99" type="integer">このパスの 99 パーセンタイルレイテンシ（ミリ秒）。</ResponseField>
        <ResponseField name="requests" type="integer">このパスで観測されたリクエスト数。</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "summary": {
        "edge": { "p50": 42, "p95": 180, "p99": 320 },
        "origin": { "p50": 28, "p95": 150, "p99": 280 },
        "requests": 12450
      },
      "timeseries": [
        {
          "date": "2025-12-01T12:00:00.000Z",
          "requests": 540,
          "edge": { "p50": 41, "p95": 175, "p99": 310 },
          "origin": { "p50": 27, "p95": 148, "p99": 270 }
        }
      ],
      "countries": [
        { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
        { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
      ],
      "colos": [
        {
          "type": "GRU",
          "city": "São Paulo",
          "country": "BR",
          "p50": 34,
          "p95": 158,
          "requests": 8100
        }
      ],
      "slowest_paths": [
        {
          "path": "/api/reports/generate",
          "p95": 820,
          "p99": 1500,
          "requests": 230
        }
      ]
    }
  }
  ```
</ResponseExample>