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

# Edge-Analytics mit der CLI abrufen

> Rufe Traffic, Fehler, Anfragelogs und Latenz einer Square Cloud Website am Edge mit squarecloud app network ab und leere ihren Edge-Cache.

Diese Befehle zeigen, was der Edge von Square Cloud für eine Website sieht: ihre `squareweb.app`-Domain und ihre eigene Domain. `[appID]` ist optional: siehe [Wie die CLI deine Anwendung findet](/de/cli-reference/quickstart#wie-die-cli-deine-anwendung-findet).

## Zeitraum

`analytics`, `errors`, `logs` und `performance` umfassen standardmäßig die letzten 24 Stunden. Ändere den Zeitraum mit diesen Flags, die Zeitangaben nach [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) erwarten, etwa `2026-07-01T00:00:00Z`:

| Flag | Beschreibung |
| - | - |
| `--start <time>` | Beginn des Zeitraums. Standard: vor 24 Stunden. |
| `--end <time>` | Ende des Zeitraums. Standard: jetzt. |

Die Daten reichen höchstens 7 Tage zurück und nie vor die Erstellung der Anwendung.

## `squarecloud app network analytics`

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

Gibt Besuche, Anfragen und Traffic des Zeitraums aus, gefolgt von den 10 häufigsten Ländern.

| Filter-Flag | Schränkt die Daten ein auf |
| - | - |
| `--country`, `--ip`, `--path`, `--status` | Ein Land, eine Client-IP, einen Pfad oder einen HTTP-Status |
| `--os`, `--browser`, `--protocol`, `--referer` | Ein Betriebssystem, einen Browser, ein Protokoll oder einen Referer |
| `--provider`, `--content-type`, `--bot` | Einen Netzwerkanbieter, einen Inhaltstyp oder einen Bot |

Jeder Filter erwartet einen Wert genau so, wie ihn die entsprechende Aufschlüsselung in der `--json`-Ausgabe zeigt, etwa einen zweibuchstabigen Ländercode (`BR`) oder einen dreistelligen Status (`200`). Filter lassen sich kombinieren: Die Daten müssen allen entsprechen.

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Ein Tag brasilianischer Traffic, beantwortet mit 200.
```

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

## `squarecloud app network errors`

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

| Flag | Beschreibung |
| - | - |
| `--include-4xx` | Zählt auch 4xx-Antworten. Standardmäßig werden nur 5xx-Fehler gezählt. |

Gibt die Gesamtzahl der Fehler aus, aufgeteilt in 4xx und 5xx, sowie die 10 Pfade mit den meisten Fehlern.

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

## `squarecloud app network logs`

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

Zeigt die Edge-Anfragelogs des Zeitraums: Zeit, Status, Methode, Pfad, Client-IP und Land. Verfügbar in den Plänen Pro und Enterprise. Für die eigene Ausgabe deiner Anwendung siehe [`squarecloud app logs`](/de/cli-reference/logs#squarecloud-app-logs).

## `squarecloud app network performance`

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

Zeigt die Latenz-Perzentile (p50 und p95) am Edge und am Ursprung sowie die 10 langsamsten Pfade mit ihren Werten für p95 und p99. Verfügbar in den Plänen Pro und Enterprise.

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

## `squarecloud app network purge-cache`

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

| Flag | Beschreibung |
| - | - |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |

Leert nach einer `y/N`-Bestätigung den **gesamten** Edge-Cache der Anwendung.

## Siehe auch

| Befehl | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/de/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/de/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/de/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/de/sdks/js/network) | [Edge-Fehler](/de/vscode-extension/features#anwendungen) |
| `logs` | [`GET .../network/logs`](/de/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/de/sdks/js/network) | [Edge-Logs](/de/vscode-extension/features#anwendungen) |
| `performance` | [`GET .../network/performance`](/de/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/de/sdks/js/network) | [Edge-Performance](/de/vscode-extension/features#anwendungen) |
| `purge-cache` | [`POST .../network/purge_cache`](/de/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/de/sdks/js/network) | [Edge-Cache leeren](/de/vscode-extension/features#anwendungen) |

Eigene Domains und DNS-Einträge findest du unter [Domains](/de/cli-reference/domains).