> ## 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 网站在边缘的流量、错误、请求日志和延迟，并清除它的边缘缓存。

这些命令报告 Square Cloud 边缘对某个网站的观测数据：包括它的 `squareweb.app` 域名和自定义域名。`[appID]` 是可选的：参见 [CLI 如何找到你的应用](/zh/cli-reference/quickstart#cli-如何找到你的应用)。

## 时间窗口

`analytics`、`errors`、`logs` 和 `performance` 默认覆盖最近 24 小时。可以用以下标志更改时间窗口，它们接受 [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) 格式的时间，例如 `2026-07-01T00:00:00Z`：

| 标志 | 说明 |
| - | - |
| `--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` | 某个操作系统、浏览器、协议或来源页 |
| `--provider`, `--content-type`, `--bot` | 某个网络服务商、内容类型或机器人 |

每个筛选条件的取值必须与 `--json` 输出中对应明细显示的值完全一致，例如两个字母的国家代码（`BR`）或三位数的状态码（`200`）。筛选条件可以组合：数据必须同时满足所有条件。

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# 一天内来自巴西、响应状态为 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`](/zh/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`](/zh/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/zh/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/zh/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/zh/sdks/js/network) | [边缘错误](/zh/vscode-extension/features#应用) |
| `logs` | [`GET .../network/logs`](/zh/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/zh/sdks/js/network) | [边缘日志](/zh/vscode-extension/features#应用) |
| `performance` | [`GET .../network/performance`](/zh/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/zh/sdks/js/network) | [边缘性能](/zh/vscode-extension/features#应用) |
| `purge-cache` | [`POST .../network/purge_cache`](/zh/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/zh/sdks/js/network) | [清除边缘缓存](/zh/vscode-extension/features#应用) |

自定义域名和 DNS 记录请参阅[域名](/zh/cli-reference/domains)。