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

# Analíticas del edge desde la CLI

> Consulta el tráfico, los errores, los logs de solicitudes y la latencia de un sitio de Square Cloud en el edge con squarecloud app network, y purga su caché.

Estos comandos muestran lo que el edge de Square Cloud ve de un sitio web: su dominio `squareweb.app` y su dominio personalizado. `[appID]` es opcional: consulta [cómo encuentra la CLI tu aplicación](/es/cli-reference/quickstart#cómo-encuentra-la-cli-tu-aplicación).

## Ventana de tiempo

`analytics`, `errors`, `logs` y `performance` cubren las últimas 24 horas por defecto. Cambia la ventana con estos flags, que aceptan horas en formato [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339) como `2026-07-01T00:00:00Z`:

| Flag | Descripción |
| - | - |
| `--start <time>` | Inicio de la ventana. Por defecto: hace 24 horas. |
| `--end <time>` | Fin de la ventana. Por defecto: ahora. |

Los datos llegan como máximo a 7 días atrás, y nunca antes de la creación de la aplicación.

## `squarecloud app network analytics`

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

Muestra las visitas, las solicitudes y el tráfico de la ventana, seguidos de los 10 países principales.

| Flag de filtro | Limita los datos a |
| - | - |
| `--country`, `--ip`, `--path`, `--status` | Un país, una IP de cliente, una ruta o un estado HTTP |
| `--os`, `--browser`, `--protocol`, `--referer` | Un sistema operativo, un navegador, un protocolo o un referer |
| `--provider`, `--content-type`, `--bot` | Un proveedor de red, un tipo de contenido o un bot |

Cada filtro recibe un valor exactamente como aparece en su desglose de la salida `--json`, como un código de país de dos letras (`BR`) o un estado de tres dígitos (`200`). Los filtros se combinan: los datos deben cumplir todos.

```bash theme={"system"}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Un día de tráfico desde Brasil respondido con 200.
```

```bash Salida 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 | Descripción |
| - | - |
| `--include-4xx` | También cuenta las respuestas 4xx. Por defecto, solo se cuentan los errores 5xx. |

Muestra el número total de errores, dividido en 4xx y 5xx, y las 10 rutas con más errores.

```bash Salida 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]
```

Muestra los logs de solicitudes del edge de la ventana: hora, estado, método, ruta, IP del cliente y país. Disponible en los planes Pro y Enterprise. Para la salida de tu propia aplicación, consulta [`squarecloud app logs`](/es/cli-reference/logs#squarecloud-app-logs).

## `squarecloud app network performance`

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

Muestra los percentiles de latencia del edge y del origen (p50 y p95) y las 10 rutas más lentas con su p95 y p99. Disponible en los planes Pro y Enterprise.

```bash Salida 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 | Descripción |
| - | - |
| `-y`, `--yes` | Omite la confirmación. |

Purga **toda** la caché del edge de la aplicación, tras una confirmación `y/N`.

## Relacionado

| Comando | API | SDK de JavaScript | VS Code |
| - | - | - | - |
| `analytics` | [`GET .../network/analytics`](/es/api-reference/endpoint/apps/network/analytics) | [`api.apps.network.analytics()`](/es/sdks/js/network) | |
| `errors` | [`GET .../network/errors`](/es/api-reference/endpoint/apps/network/errors) | [`api.apps.network.errors()`](/es/sdks/js/network) | [Errores del edge](/es/vscode-extension/features#aplicaciones) |
| `logs` | [`GET .../network/logs`](/es/api-reference/endpoint/apps/network/logs) | [`api.apps.network.logs()`](/es/sdks/js/network) | [Logs del edge](/es/vscode-extension/features#aplicaciones) |
| `performance` | [`GET .../network/performance`](/es/api-reference/endpoint/apps/network/performance) | [`api.apps.network.performance()`](/es/sdks/js/network) | [Rendimiento del edge](/es/vscode-extension/features#aplicaciones) |
| `purge-cache` | [`POST .../network/purge_cache`](/es/api-reference/endpoint/apps/network/purge_cache) | [`api.apps.network.purgeCache()`](/es/sdks/js/network) | [Purgar caché del edge](/es/vscode-extension/features#aplicaciones) |

Los dominios personalizados y los registros DNS están en [Dominios](/es/cli-reference/domains).