> ## 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 edge dalla CLI

> Leggi traffico, errori, log delle richieste e latenza edge di un sito Square Cloud con squarecloud app network, e svuota la sua cache edge dal terminale.

Questi comandi riportano ciò che l'edge di Square Cloud vede per un sito: il suo dominio `squareweb.app` e il suo dominio personalizzato. `[appID]` è facoltativo: vedi [come la CLI trova la tua app](/it/cli-reference/quickstart#come-la-cli-trova-la-tua-app).

## Intervallo di tempo

`analytics`, `errors`, `logs` e `performance` coprono per impostazione predefinita le ultime 24 ore. Cambia l'intervallo con questi flag, che accettano orari [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) come `2026-07-01T00:00:00Z`:

| Flag | Descrizione |
| - | - |
| `--start <time>` | Inizio dell'intervallo. Predefinito: 24 ore fa. |
| `--end <time>` | Fine dell'intervallo. Predefinito: adesso. |

I dati risalgono al massimo a 7 giorni prima, e mai a prima della creazione dell'applicazione.

## `squarecloud app network analytics`

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

Stampa visite, richieste e traffico dell'intervallo, seguiti dai 10 paesi principali.

| Flag di filtro | Limita i dati a |
| - | - |
| `--country`, `--ip`, `--path`, `--status` | Un paese, un IP client, un percorso o uno stato HTTP |
| `--os`, `--browser`, `--protocol`, `--referer` | Un sistema operativo, un browser, un protocollo o un referer |
| `--provider`, `--content-type`, `--bot` | Un provider di rete, un tipo di contenuto o un bot |

Ogni filtro accetta un valore esattamente come compare nella relativa suddivisione dell'output `--json`, per esempio un codice paese di due lettere (`BR`) o uno stato di tre cifre (`200`). I filtri si combinano: i dati devono soddisfarli tutti.

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Un giorno di traffico brasiliano con risposta 200.
```

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

## `squarecloud app network errors`

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

| Flag | Descrizione |
| - | - |
| `--include-4xx` | Conta anche le risposte 4xx. Per impostazione predefinita vengono contati solo gli errori 5xx. |

Stampa il numero totale di errori, suddiviso tra 4xx e 5xx, e i 10 percorsi con più errori.

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

## `squarecloud app network logs`

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

Mostra i log edge delle richieste nell'intervallo: ora, stato, metodo, percorso, IP client e paese. Disponibile nei piani Pro ed Enterprise. Per l'output della tua applicazione, vedi [`squarecloud app logs`](/it/cli-reference/logs#squarecloud-app-logs).

## `squarecloud app network performance`

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

Mostra i percentili di latenza edge e origine (p50 e p95) e i 10 percorsi più lenti con i relativi p95 e p99. Disponibile nei piani Pro ed Enterprise.

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

## `squarecloud app network purge-cache`

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

| Flag | Descrizione |
| - | - |
| `-y`, `--yes` | Salta la richiesta di conferma. |

Svuota l'**intera** cache edge dell'applicazione, dopo una conferma `y/N`.

## Correlati

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/it/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/it/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/it/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/it/sdks/js/network) | [Errori edge](/it/vscode-extension/features#applicazioni) |
| `logs` | [`GET .../network/logs`](/it/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/it/sdks/js/network) | [Log edge](/it/vscode-extension/features#applicazioni) |
| `performance` | [`GET .../network/performance`](/it/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/it/sdks/js/network) | [Prestazioni edge](/it/vscode-extension/features#applicazioni) |
| `purge-cache` | [`POST .../network/purge_cache`](/it/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/it/sdks/js/network) | [Svuota cache edge](/it/vscode-extension/features#applicazioni) |

Domini personalizzati e record DNS sono in [Domini](/it/cli-reference/domains).