Latenza edge e origin

GET

apps

{app_id}

network

performance

Latenza edge e origin

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

Restituisce i percentili del tempo di risposta edge e origin (p50, p95, p99) dell’applicazione su un intervallo di tempo, oltre alle suddivisioni per paese, per colo e per i path più lenti. Utile per diagnosticare regressioni di latenza e identificare quali route o regioni sono le più lente.

Disponibile solo sui piani Pro ed Enterprise. I cache miss condividono un unico limite di 20 richieste ogni 60 secondi per proprietario dell’applicazione, tra gli endpoint analytics, errors, logs e performance. Le risposte memorizzate nella cache non vengono conteggiate. Nei periodi di carico elevato sull’intera piattaforma, l’endpoint può invece restituire i dati più recenti memorizzati nella cache per la finestra richiesta.

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope apps:read. La latenza edge (edge) misura il time-to-first-byte sulla rete di Cloudflare; la latenza origin (origin) misura quanto tempo ha impiegato l’applicazione stessa a rispondere una volta raggiunta dall’edge. Uno scarto tra le due che cresce durante una finestra indica solitamente un problema nell’applicazione o nel suo nodo cluster, mentre un aumento di entrambe indica condizioni di rete tra il client e l’edge. Questo misura la latenza di rete, non l’utilizzo delle risorse del container; per CPU, RAM e banda campionate direttamente dal container, vedi Ottieni Metriche Applicazione. Combina colos e countries con Analytics del Sito Web per capire se una regione lenta è anche una regione a basso traffico, prima di dare priorità a una correzione.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

string

obbligatorio

Timestamp di inizio ISO 8601 per l’intervallo di analisi.

string

obbligatorio

Timestamp di fine ISO 8601. Deve essere successivo a start.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

object

Percentili di latenza e suddivisioni per l’intervallo.

Mostra Mostra oggetto response

object

Percentili di latenza aggregati sull’intero intervallo.

Mostra Mostra oggetto summary

object

Percentili di latenza lato edge in millisecondi.

Mostra Mostra oggetto edge

integer

Latenza edge al 50° percentile (mediana).

integer

Latenza edge al 95° percentile.

integer

Latenza edge al 99° percentile.

object

Percentili di latenza lato origin in millisecondi.

Mostra Mostra oggetto origin

integer

Latenza origin al 50° percentile (mediana).

integer

Latenza origin al 95° percentile.

integer

Latenza origin al 99° percentile.

integer

Numero totale di richieste analizzate nell’intervallo.

array

Percentili di latenza suddivisi in intervalli lungo la finestra di analisi.

Mostra Mostra elemento timeseries

string

Timestamp di inizio del bucket in formato ISO 8601.

integer

Richieste osservate nel bucket.

object

p50/p95/p99 edge per questo bucket.

object

p50/p95/p99 origin per questo bucket.

array

Suddivisione della latenza per paese del client.

Mostra Mostra elemento countries

string

Codice paese di due lettere (es. BR, US).

integer

Latenza mediana per questo paese in millisecondi.

integer

Latenza al 95° percentile per questo paese in millisecondi.

integer

Richieste servite a questo paese.

array

Suddivisione della latenza per colo edge (data center).

Mostra Mostra elemento colos

string

Identificatore del colo (es. GRU, IAD).

string

Città in cui si trova il colo.

string

Paese in cui si trova il colo.

integer

Latenza mediana su questo colo in millisecondi.

integer

Latenza al 95° percentile su questo colo in millisecondi.

integer

Richieste servite attraverso questo colo.

array

I path con la latenza più alta nell’intervallo.

Mostra Mostra elemento slowest_paths

string

Path della richiesta.

integer

Latenza al 95° percentile per questo path in millisecondi.

integer

Latenza al 99° percentile per questo path in millisecondi.

integer

Richieste osservate per questo path.

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

Errori comuni

Codice	HTTP	Significato
`INVALID_TIME_RANGE`	400	`start`/`end` mancanti, malformati o con l’intervallo temporale invertito.
`UPGRADE_REQUIRED`	403	Le analytics sulle prestazioni sono disponibili solo per i piani Pro ed Enterprise.
`RATE_LIMITED`	429	È stato raggiunto il limite condiviso dei cache miss. Attendi e riprova.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Recupero dei dati sulle prestazioni dal provider edge non riuscito.
`ANALYTICS_BUSY`	503	Le analytics edge sono temporaneamente sovraccariche. Riprova tra un minuto.

Vedi anche

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

Latenza edge e origin

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

Primi passi

Account

Applicazioni

Database

Workspace

IA

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche