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

# Consulter les analytics edge depuis la CLI

> Consultez le trafic, les erreurs, les logs de requêtes et la latence edge d'un site Square Cloud avec squarecloud app network, et purgez son cache edge.

Ces commandes rapportent ce que l'edge de Square Cloud voit d'un site web : son domaine `squareweb.app` et son domaine personnalisé. `[appID]` est facultatif : consultez [comment la CLI trouve votre application](/fr/cli-reference/quickstart#comment-la-cli-trouve-votre-application).

## Période

`analytics`, `errors`, `logs` et `performance` couvrent par défaut les dernières 24 heures. Modifiez la période avec ces options, qui acceptent des horodatages [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) comme `2026-07-01T00:00:00Z` :

| Option | Description |
| - | - |
| `--start <time>` | Début de la période. Par défaut : il y a 24 heures. |
| `--end <time>` | Fin de la période. Par défaut : maintenant. |

Les données remontent au maximum à 7 jours, et jamais avant la création de l'application.

## `squarecloud app network analytics`

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

Affiche les visites, les requêtes et le trafic de la période, suivis des 10 principaux pays.

| Option de filtre | Restreint les données à |
| - | - |
| `--country`, `--ip`, `--path`, `--status` | Un pays, une IP client, un chemin ou un statut HTTP |
| `--os`, `--browser`, `--protocol`, `--referer` | Un système d'exploitation, un navigateur, un protocole ou un referer |
| `--provider`, `--content-type`, `--bot` | Un fournisseur réseau, un type de contenu ou un bot |

Chaque filtre prend une valeur exactement telle qu'elle apparaît dans la répartition correspondante de la sortie `--json`, comme un code pays à deux lettres (`BR`) ou un statut à trois chiffres (`200`). Les filtres se combinent : les données doivent tous les respecter.

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Une journée de trafic brésilien servi avec un statut 200.
```

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

## `squarecloud app network errors`

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

| Option | Description |
| - | - |
| `--include-4xx` | Compte aussi les réponses 4xx. Par défaut, seules les erreurs 5xx sont comptées. |

Affiche le nombre total d'erreurs, réparti entre 4xx et 5xx, et les 10 chemins qui génèrent le plus d'erreurs.

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

## `squarecloud app network logs`

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

Affiche les logs des requêtes edge de la période : heure, statut, méthode, chemin, IP client et pays. Disponible sur les plans Pro et Enterprise. Pour la sortie de votre propre application, consultez [`squarecloud app logs`](/fr/cli-reference/logs#squarecloud-app-logs).

## `squarecloud app network performance`

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

Affiche les percentiles de latence edge et origine (p50 et p95) et les 10 chemins les plus lents avec leurs p95 et p99. Disponible sur les plans Pro et Enterprise.

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

## `squarecloud app network purge-cache`

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

| Option | Description |
| - | - |
| `-y`, `--yes` | Ignore l'invite de confirmation. |

Purge l'**intégralité** du cache edge de l'application, après une confirmation `y/N`.

## Voir aussi

| Commande | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/fr/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/fr/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/fr/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/fr/sdks/js/network) | [Erreurs edge](/fr/vscode-extension/features#applications) |
| `logs` | [`GET .../network/logs`](/fr/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/fr/sdks/js/network) | [Logs edge](/fr/vscode-extension/features#applications) |
| `performance` | [`GET .../network/performance`](/fr/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/fr/sdks/js/network) | [Performances edge](/fr/vscode-extension/features#applications) |
| `purge-cache` | [`POST .../network/purge_cache`](/fr/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/fr/sdks/js/network) | [Vider le cache edge](/fr/vscode-extension/features#applications) |

Les domaines personnalisés et les enregistrements DNS se trouvent dans [Domaines](/fr/cli-reference/domains).