network só está disponível em aplicações website. Refine o tipo com app.isWebsite() antes de usá-lo:
Domínio customizado
app.network.setCustomDomain(domain) define ou remove o domínio customizado vinculado ao site.
Domínios customizados exigem o plano Senior ou superior. Há um limite
diário por usuário de quantas vezes você pode trocar um domínio customizado.
Registros DNS
Depois de vincular um domínio, configure o DNS no seu registrador.app.network.dns() retorna um array de registros DNS a criar.
{ type, name, value, status }:
typeé"txt"ou"cname". Os registros TXT cobrem a propriedade do domínio e a validação SSL; o registro CNAME carrega o tráfego e sempre apontavalueparacname.squareweb.app.statusreflete o estado atual de validação, ex.:"pending","pending_validation"ou"active".
Analytics
app.network.analytics({ start, end }) retorna analytics agregados da edge. start e end aceitam strings ISO 8601 ou Date. A janela máxima de retenção é de 7 dias.
Filtros de drill-down
Além destart/end, analytics() aceita filtros opcionais. Cada filtro restringe todos os breakdowns da resposta de uma vez, não apenas um deles:
| Filtro | Notas |
|---|---|
country | Código de país com 2 letras, ex.: "BR" |
ip | Correspondência exata de IP |
path | Correspondência por prefixo, ex.: "/api" |
status | Código de status HTTP, ex.: "404" |
os | Sistema operacional |
browser | Nome do navegador |
protocol | Protocolo da requisição |
referer | Use "Direct" para requisições sem referer |
provider | Provedor de rede, ex.: "GOOGLE (15169)" (ASN) ou "SQUARE-CLOUD-PLATFORM" |
contentType | Use "Unknown" para tipos de conteúdo não classificados |
bot | Use "Unverified" para tráfego normal (não-bot) |
Breakdowns
Além das séries temporais e dos breakdowns top-N já existentes, a resposta inclui quatro breakdowns calculados sobre toda a janela (sem série temporal):ips (IPs originados da própria rede da Square Cloud são mascarados), status_codes, bots e content_types. Cada entrada tem o formato { type, visits, requests, bytes }.
Monitoramento de erros
app.network.errors({ start, end, include4xx? }) retorna o breakdown de erros da edge. Por padrão, apenas 5xx são considerados.
Logs de requisição
app.network.logs({ start, end }) retorna os logs por requisição da edge.
Logs por requisição exigem o plano Pro ou superior.
Percentis de latência
app.network.performance({ start, end }) retorna as latências p50 / p95 / p99 para as camadas edge e origin.
Métricas de performance exigem o plano Pro ou superior.
Limpando o cache da edge
app.network.purgeCache() invalida o cache inteiro da edge para os domínios da aplicação.
Domínios e load balancers de toda a conta
domains() e loadBalancers() ficam em api.applications, não em app.network — eles operam sobre todas as aplicações da conta, não apenas um único site.
Listando todos os domínios
api.applications.domains() retorna todos os domínios configurados em todas as aplicações da conta.
Load balancers
api.applications.loadBalancers() agrupa aplicações que compartilham um domínio customizado.
limit é o número máximo de aplicações que podem compartilhar um domínio no plano da conta: 2 (Standard), 5 (Pro), 10 (Enterprise). Limitado a 20 requisições/60s por usuário.
