Obter latência de borda e de origem

GET

apps

{app_id}

network

performance

Obter latência de borda e de origem

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/performance \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/performance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/performance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/performance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Retorna percentis de tempo de resposta na borda e na origem (p50, p95, p99) para a aplicação em uma janela de tempo, além de detalhamento por país, por colo (data center) e pelos caminhos mais lentos. Útil para diagnosticar regressões de latência e identificar quais rotas ou regiões estão mais lentas.

Disponível apenas nos planos Pro e Enterprise. O cache miss compartilha um limite único de 20 requisições por 60 segundos por proprietário da aplicação, entre os endpoints de análise, erros, logs e performance. Respostas em cache não contam. Em períodos de alta demanda em toda a plataforma, o endpoint pode retornar os dados em cache mais recentes da janela solicitada.

string

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

Requer uma chave de API com o escopo apps:read. A latência de borda (edge) mede o time-to-first-byte na rede do Cloudflare; a latência de origem (origin) mede quanto tempo a própria aplicação levou para responder depois que a borda a alcançou. Uma diferença entre as duas que cresce ao longo de uma janela geralmente aponta para a aplicação ou seu nó de cluster, enquanto ambas subindo juntas apontam para condições de rede entre o cliente e a borda. Isso mede latência de rede, não uso de recursos do container; para CPU, RAM e banda amostrados diretamente do container, veja Obter métricas da aplicação. Combine colos e countries com Análise de rede para ver se uma região lenta também tem baixo tráfego antes de priorizar uma correção.

Parâmetros

string

obrigatório

O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.

string

obrigatório

Timestamp inicial em formato ISO 8601 para a janela de análise.

string

obrigatório

Timestamp final em formato ISO 8601. Deve ser posterior ao start.

Resposta

string

Indica se a chamada foi bem-sucedida: success se foi, error se não.

object

Percentis de latência e detalhamentos para a janela analisada.

Mostrar Alternar objeto response

object

Percentis de latência agregados para toda a janela.

Mostrar Alternar objeto summary

object

Percentis de latência na borda, em milissegundos.

Mostrar Alternar objeto edge

integer

Percentil 50 (mediana) da latência na borda.

integer

Percentil 95 da latência na borda.

integer

Percentil 99 da latência na borda.

object

Percentis de latência na origem, em milissegundos.

Mostrar Alternar objeto origin

integer

Percentil 50 (mediana) da latência na origem.

integer

Percentil 95 da latência na origem.

integer

Percentil 99 da latência na origem.

integer

Total de requisições analisadas na janela.

array

Percentis de latência distribuídos em intervalos temporais ao longo da janela.

Mostrar Alternar item timeseries

string

Timestamp inicial do intervalo, em formato ISO 8601.

integer

Requisições observadas no intervalo.

object

p50/p95/p99 na borda para este intervalo.

object

p50/p95/p99 na origem para este intervalo.

array

Detalhamento da latência por país do cliente.

Mostrar Alternar item countries

string

Código de país de duas letras (ex. BR, US).

integer

Latência mediana para este país, em milissegundos.

integer

Percentil 95 de latência para este país, em milissegundos.

integer

Requisições servidas para este país.

array

Detalhamento da latência por colo (data center) de borda.

Mostrar Alternar item colos

string

Identificador do colo (ex. GRU, IAD).

string

Cidade onde o colo está localizado.

string

País onde o colo está localizado.

integer

Latência mediana neste colo, em milissegundos.

integer

Percentil 95 de latência neste colo, em milissegundos.

integer

Requisições servidas por este colo.

array

Caminhos com maior latência na janela.

Mostrar Alternar item slowest_paths

string

Caminho da requisição.

integer

Percentil 95 de latência para este caminho, em milissegundos.

integer

Percentil 99 de latência para este caminho, em milissegundos.

integer

Requisições observadas para este caminho.

{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Erros comuns

Código	HTTP	Significado
`INVALID_TIME_RANGE`	400	`start`/`end` estão ausentes, malformados ou invertem o intervalo de tempo.
`UPGRADE_REQUIRED`	403	Análises de performance estão disponíveis apenas nos planos Pro e Enterprise.
`RATE_LIMITED`	429	O limite compartilhado de cache misses foi atingido. Aguarde e tente novamente.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Falha ao obter os dados de performance do provedor de edge.
`ANALYTICS_BUSY`	503	As análises de borda estão temporariamente ocupadas. Tente novamente em um minuto.

Relacionados

CLI: squarecloud app network performance
SDKs: api.apps.network.performance() (JavaScript), client.apps.network.performance() (Python), c.Apps.Network.Performance() (Go)

Obter latência de borda e de origem

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/performance \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/performance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/performance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/performance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/performance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}

Primeiros passos

Conta

Aplicações

Bancos de dados

Workspaces

IA

Obter latência de borda e de origem

Parâmetros

Resposta

Erros comuns

Relacionados

​Parâmetros

​Resposta

​Erros comuns

​Relacionados

Parâmetros

Resposta

Erros comuns

Relacionados