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

# Analytics da edge pela CLI

> Veja o tráfego, os erros, os logs de requisições e a latência de um site da Square Cloud na edge com squarecloud app network, e limpe o cache da edge.

Estes comandos mostram o que a edge da Square Cloud vê de um site: o domínio `squareweb.app` e o domínio personalizado dele. O `[appID]` é opcional: veja [como a CLI encontra sua aplicação](/pt-br/cli-reference/quickstart#como-a-cli-encontra-sua-aplicação).

## Janela de tempo

O `analytics`, o `errors`, o `logs` e o `performance` cobrem as últimas 24 horas por padrão. Mude a janela com estas flags, que recebem horários no formato [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339), como `2026-07-01T00:00:00Z`:

| Flag | Descrição |
| - | - |
| `--start <time>` | Início da janela. Padrão: 24 horas atrás. |
| `--end <time>` | Fim da janela. Padrão: agora. |

Os dados voltam no máximo 7 dias, e nunca antes da criação da aplicação.

## `squarecloud app network analytics`

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

Imprime as visitas, as requisições e o tráfego da janela, seguidos dos 10 países com mais acessos.

| Flag de filtro | Restringe os dados a |
| - | - |
| `--country`, `--ip`, `--path`, `--status` | Um país, IP do cliente, caminho ou status HTTP |
| `--os`, `--browser`, `--protocol`, `--referer` | Um sistema operacional, navegador, protocolo ou referer |
| `--provider`, `--content-type`, `--bot` | Um provedor de rede, tipo de conteúdo ou bot |

Cada filtro recebe um valor exatamente como o detalhamento dele aparece na saída do `--json`, como um código de país de duas letras (`BR`) ou um status de três dígitos (`200`). Os filtros se combinam: os dados precisam atender a todos.

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Um dia de tráfego brasileiro respondido com 200.
```

```bash Saída theme={"system"}
Visits: <visits> | Requests: <requests> | Traffic: <size>
```

## `squarecloud app network errors`

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

| Flag | Descrição |
| - | - |
| `--include-4xx` | Conta também as respostas 4xx. Por padrão, só os erros 5xx são contados. |

Imprime o total de erros, dividido entre 4xx e 5xx, e os 10 caminhos com mais erros.

```bash Saída theme={"system"}
Errors: <total> total (<4xx> 4xx / <5xx> 5xx)
```

## `squarecloud app network logs`

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

Mostra os logs de requisições da edge na janela: horário, status, método, caminho, IP do cliente e país. Disponível nos planos Pro e Enterprise. Para a saída da própria aplicação, veja [`squarecloud app logs`](/pt-br/cli-reference/logs#squarecloud-app-logs).

## `squarecloud app network performance`

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

Mostra os percentis de latência da edge e da origem (p50 e p95) e os 10 caminhos mais lentos, com o p95 e o p99 de cada um. Disponível nos planos Pro e Enterprise.

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

## `squarecloud app network purge-cache`

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

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

Limpa **todo** o cache da edge da aplicação, após uma confirmação `y/N`.

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/pt-br/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/pt-br/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/pt-br/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/pt-br/sdks/js/network) | [Erros da edge](/pt-br/vscode-extension/features#aplicações) |
| `logs` | [`GET .../network/logs`](/pt-br/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/pt-br/sdks/js/network) | [Logs da edge](/pt-br/vscode-extension/features#aplicações) |
| `performance` | [`GET .../network/performance`](/pt-br/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/pt-br/sdks/js/network) | [Desempenho da edge](/pt-br/vscode-extension/features#aplicações) |
| `purge-cache` | [`POST .../network/purge_cache`](/pt-br/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/pt-br/sdks/js/network) | [Limpar cache da edge](/pt-br/vscode-extension/features#aplicações) |

Os domínios personalizados e os registros DNS estão em [Domínios](/pt-br/cli-reference/domains).