Obtener latencia del edge y del origen

GET

apps

{app_id}

network

performance

Obtener latencia del edge y del origen

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
      }
    ]
  }
}

Devuelve los percentiles de tiempo de respuesta del edge y del origen (p50, p95, p99) de la aplicación durante una ventana de tiempo, además de desgloses por país, por colo y por las rutas más lentas. Útil para diagnosticar regresiones de latencia e identificar qué rutas o regiones son las más lentas.

Disponible únicamente en los planes Pro y Enterprise. Los fallos de caché comparten un único límite de 20 solicitudes cada 60 segundos por propietario de la aplicación, entre los endpoints de analítica, errores, registros y rendimiento. Las respuestas en caché no cuentan. En periodos de alta demanda en toda la plataforma, el endpoint puede devolver en su lugar los datos en caché más recientes para la ventana solicitada.

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Requiere una clave de API con el scope apps:read. La latencia de borde (edge) mide el tiempo hasta el primer byte en la red de Cloudflare; la latencia de origen (origin) mide cuánto tardó la propia aplicación en responder una vez que el borde la alcanzó. Una brecha entre ambas que crece durante una ventana suele apuntar a la aplicación o a su nodo de clúster, mientras que si ambas aumentan juntas apunta a las condiciones de red entre el cliente y el borde. Esto mide la latencia de red, no el uso de recursos del contenedor; para CPU, RAM y ancho de banda muestreados desde el propio contenedor, consulta Obtener métricas de la aplicación. Combina colos y countries con Analítica de red para ver si una región lenta también tiene poco tráfico antes de priorizar una corrección.

Parámetros

string

requerido

El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.

string

requerido

Timestamp de inicio en formato ISO 8601 para la ventana de análisis.

string

requerido

Timestamp de fin en formato ISO 8601. Debe ser posterior a start.

Respuesta

string

Indica si la llamada fue exitosa: success si lo fue, error si no.

object

Percentiles de latencia y desgloses de la ventana.

Mostrar Alternar objeto de respuesta

object

Percentiles de latencia agregados de toda la ventana.

Mostrar Alternar objeto summary

object

Percentiles de latencia del lado del edge en milisegundos.

Mostrar Alternar objeto edge

integer

Latencia del edge en el percentil 50 (mediana).

integer

Latencia del edge en el percentil 95.

integer

Latencia del edge en el percentil 99.

object

Percentiles de latencia del lado del origen en milisegundos.

Mostrar Alternar objeto origin

integer

Latencia del origen en el percentil 50 (mediana).

integer

Latencia del origen en el percentil 95.

integer

Latencia del origen en el percentil 99.

integer

Número total de solicitudes analizadas en la ventana.

array

Percentiles de latencia agrupados en buckets a lo largo de la ventana de análisis.

Mostrar Alternar elemento de timeseries

string

Timestamp de inicio del bucket en formato ISO 8601.

integer

Solicitudes observadas en el bucket.

object

p50/p95/p99 del edge para este bucket.

object

p50/p95/p99 del origen para este bucket.

array

Desglose de latencia por país del cliente.

Mostrar Alternar elemento de countries

string

Código de país de dos letras (p. ej. BR, US).

integer

Latencia mediana para este país en milisegundos.

integer

Latencia en el percentil 95 para este país en milisegundos.

integer

Solicitudes atendidas a este país.

array

Desglose de latencia por colo del edge (centro de datos).

Mostrar Alternar elemento de colos

string

Identificador del colo (p. ej. GRU, IAD).

string

Ciudad donde se ubica el colo.

string

País donde se ubica el colo.

integer

Latencia mediana en este colo en milisegundos.

integer

Latencia en el percentil 95 en este colo en milisegundos.

integer

Solicitudes atendidas a través de este colo.

array

Rutas con mayor latencia en la ventana.

Mostrar Alternar elemento de slowest_paths

string

Ruta de la solicitud.

integer

Latencia en el percentil 95 para esta ruta en milisegundos.

integer

Latencia en el percentil 99 para esta ruta en milisegundos.

integer

Solicitudes observadas para esta ruta.

{
  "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
      }
    ]
  }
}

Errores comunes

Código	HTTP	Significado
`INVALID_TIME_RANGE`	400	Falta `start`/`end`, están mal formados, o invierten el rango de tiempo.
`UPGRADE_REQUIRED`	403	La analítica de rendimiento está disponible solo para los planes Pro y Enterprise.
`RATE_LIMITED`	429	Se alcanzó el límite compartido de fallos de caché. Espera y vuelve a intentarlo.
`UNABLE_TO_FETCH_PERFORMANCE`	500	No se pudieron obtener los datos de rendimiento del proveedor de borde.
`ANALYTICS_BUSY`	503	La analítica de borde está ocupada temporalmente. Vuelve a intentarlo en un minuto.

Relacionado

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

Obtener latencia del edge y del origen

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
      }
    ]
  }
}

Primeros pasos

Cuenta

Aplicaciones

Bases de datos

Workspaces

IA

Obtener latencia del edge y del origen

Parámetros

Respuesta

Errores comunes

Relacionado

​Parámetros

​Respuesta

​Errores comunes

​Relacionado

Parámetros

Respuesta

Errores comunes

Relacionado