Prestazioni di Rete - Square Cloud

GET

apps

{app_id}

network

performance

Prestazioni di Rete

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. Limite di frequenza per cache miss: 10 richieste ogni 60 secondi per proprietario.

string

obbligatorio

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

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 di successo, 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 ISO (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.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Recupero dei dati sulle prestazioni dal provider edge non riuscito.

Imposta dominio personalizzatoIntegra il tuo sito web con un dominio personalizzato. Ha un limite di frequenza di 10 modifiche ogni 5 minuti e 50 ogni 24 ore.

Prestazioni di Rete

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

​Parametri

​Risposta

​Errori comuni

Parametri

Risposta

Errori comuni