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

# squarecloud app network

> Gerencia DNS, domínios personalizados e observabilidade de edge da sua aplicação na Square Cloud.

Cobre registros DNS, domínios personalizados e observabilidade de edge (analytics, erros, logs, latência e cache) de uma aplicação. O ID da aplicação é opcional em todo subcomando: a CLI o resolve a partir do argumento, depois do arquivo de configuração `squarecloud.app` no diretório atual, e por fim de um seletor interativo.

```bash theme={null}
squarecloud app network dns
# Mostra os registros DNS necessários para apontar um domínio personalizado para a aplicação.
```

```bash theme={null}
squarecloud app network domain example.com --app <appID>
# Define o domínio personalizado da aplicação.
```

Analytics, erros, logs e desempenho aceitam `--start`/`--end` (timestamps RFC 3339), com padrão nas últimas 24 horas:

```bash theme={null}
squarecloud app network analytics
# Resume visitas, requisições e tráfego das últimas 24 horas.
```

```bash theme={null}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Filtra os analytics por uma janela personalizada e um ou mais de: --country, --ip, --path, --status, --os,
# --browser, --protocol, --referer, --provider, --content-type, --bot.
```

```bash theme={null}
squarecloud app network errors
# Resume os erros 5xx de edge das últimas 24 horas, com os caminhos que mais falham.
```

```bash theme={null}
squarecloud app network errors --include-4xx
# Também inclui respostas 4xx no detalhamento de erros.
```

```bash theme={null}
squarecloud app network logs
# Mostra os logs recentes de requisições de edge. Requer plano Pro ou Enterprise.
```

```bash theme={null}
squarecloud app network performance
# Mostra os percentis de latência (p50/p95/p99) de edge e origem, e os caminhos mais lentos. Requer plano Pro ou Enterprise.
```

```bash theme={null}
squarecloud app network purge-cache
# Limpa todo o cache de edge da aplicação.
```

O subcomando `purge-cache` é destrutivo: ele pede confirmação `y/N` antes de limpar o cache. Passe `-y`/`--yes` para pular a confirmação.

`dns`, `analytics`, `errors`, `logs` e `performance` aceitam `--json` para saída bruta legível por máquina.

Use `squarecloud app network --help` para mais informações sobre este comando.