> ## 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.

# CLI でエッジアナリティクスを確認する

> squarecloud app network で Square Cloud の Web サイトのトラフィック、エラー、リクエストログ、レイテンシをエッジで確認し、エッジキャッシュをパージします。

これらのコマンドは、Square Cloud のエッジが Web サイト（`squareweb.app` ドメインとカスタムドメイン）について観測した内容を報告します。`[appID]` は省略できます。[CLI がアプリを特定する仕組み](/ja/cli-reference/quickstart#cli-がアプリを特定する仕組み)を参照してください。

## 期間

`analytics`、`errors`、`logs`、`performance` は、デフォルトで過去 24 時間を対象にします。期間は次のフラグで変更できます。`2026-07-01T00:00:00Z` のような [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) 形式の日時を指定します。

| フラグ | 説明 |
| - | - |
| `--start <time>` | 期間の開始。デフォルトは 24 時間前です。 |
| `--end <time>` | 期間の終了。デフォルトは現在です。 |

さかのぼれるのは最大 7 日間までで、アプリケーションの作成日より前にはさかのぼれません。

## `squarecloud app network analytics`

```bash 使い方 theme={"system"}
squarecloud app network analytics [appID] [--start <time>] [--end <time>] [filters] [--json]
```

期間内の訪問数、リクエスト数、トラフィックを表示し、続けて上位 10 か国を表示します。

| フィルターのフラグ | 絞り込む対象 |
| - | - |
| `--country`、`--ip`、`--path`、`--status` | 国、クライアント IP、パス、HTTP ステータス |
| `--os`、`--browser`、`--protocol`、`--referer` | OS、ブラウザ、プロトコル、リファラー |
| `--provider`、`--content-type`、`--bot` | ネットワークプロバイダー、コンテンツタイプ、ボット |

各フィルターには、`--json` 出力の内訳に表示されるとおりの値を指定します。たとえば 2 文字の国コード（`BR`）や 3 桁のステータス（`200`）です。フィルターは組み合わせられ、データはそのすべてに一致する必要があります。

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# One day of Brazilian traffic answered with 200.
```

```bash 出力 theme={"system"}
Visits: <visits> | Requests: <requests> | Traffic: <size>
```

## `squarecloud app network errors`

```bash 使い方 theme={"system"}
squarecloud app network errors [appID] [--start <time>] [--end <time>] [--include-4xx] [--json]
```

| フラグ | 説明 |
| - | - |
| `--include-4xx` | 4xx のレスポンスも集計します。デフォルトでは 5xx エラーのみを集計します。 |

エラーの総数を 4xx と 5xx に分けて表示し、エラーが最も多い 10 個のパスを表示します。

```bash 出力 theme={"system"}
Errors: <total> total (<4xx> 4xx / <5xx> 5xx)
```

## `squarecloud app network logs`

```bash 使い方 theme={"system"}
squarecloud app network logs [appID] [--start <time>] [--end <time>] [--json]
```

期間内のエッジのリクエストログを、時刻、ステータス、メソッド、パス、クライアント IP、国とともに表示します。Pro および Enterprise プランで利用できます。アプリケーション自体の出力については、[`squarecloud app logs`](/ja/cli-reference/logs#squarecloud-app-logs) を参照してください。

## `squarecloud app network performance`

```bash 使い方 theme={"system"}
squarecloud app network performance [appID] [--start <time>] [--end <time>] [--json]
```

エッジとオリジンのレイテンシのパーセンタイル（p50 と p95）と、最も遅い 10 個のパスをその p95 と p99 とともに表示します。Pro および Enterprise プランで利用できます。

```bash 出力 theme={"system"}
Requests: <requests> | Edge p50/p95: <ms>/<ms> ms | Origin p50/p95: <ms>/<ms> ms
```

## `squarecloud app network purge-cache`

```bash 使い方 theme={"system"}
squarecloud app network purge-cache [appID] [-y]
```

| フラグ | 説明 |
| - | - |
| `-y`、`--yes` | 確認プロンプトをスキップします。 |

`y/N` の確認のあと、アプリケーションのエッジキャッシュを**すべて**パージします。

## 関連項目

| コマンド | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/ja/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/ja/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/ja/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/ja/sdks/js/network) | [エッジのエラー](/ja/vscode-extension/features#アプリケーション) |
| `logs` | [`GET .../network/logs`](/ja/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/ja/sdks/js/network) | [エッジのログ](/ja/vscode-extension/features#アプリケーション) |
| `performance` | [`GET .../network/performance`](/ja/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/ja/sdks/js/network) | [エッジのパフォーマンス](/ja/vscode-extension/features#アプリケーション) |
| `purge-cache` | [`POST .../network/purge_cache`](/ja/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/ja/sdks/js/network) | [エッジキャッシュをパージ](/ja/vscode-extension/features#アプリケーション) |

カスタムドメインと DNS レコードについては[ドメイン](/ja/cli-reference/domains)を参照してください。