Edge- und Origin-Latenz abrufen

GET

apps

{app_id}

network

performance

Edge- und Origin-Latenz abrufen

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

Gibt die Antwortzeit-Perzentile am Edge und am Origin (p50, p95, p99) für die Anwendung über einen Zeitraum zurück, zusätzlich zu Aufschlüsselungen pro Land, pro Colo und nach den langsamsten Pfaden. Nützlich, um Latenzregressionen zu diagnostizieren und zu erkennen, welche Routen oder Regionen am langsamsten sind.

Nur in den Tarifen Pro und Enterprise verfügbar. Cache-Misses teilen sich ein gemeinsames Limit von 20 Anfragen pro 60 Sekunden pro Eigentümer der Anwendung, über die Endpunkte Analytics, Errors, Logs und Performance hinweg. Zwischengespeicherte Antworten zählen nicht. In Zeiten hoher Last auf der gesamten Plattform kann der Endpunkt stattdessen die neuesten zwischengespeicherten Daten für das angeforderte Zeitfenster zurückgeben.

string

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Erfordert einen API-Schlüssel mit dem Scope apps:read. Die Edge-Latenz (edge) misst die Time-to-First-Byte im Netzwerk von Cloudflare; die Origin-Latenz (origin) misst, wie lange die Anwendung selbst zum Antworten brauchte, nachdem der Edge sie erreicht hat. Eine Lücke zwischen beiden, die im Laufe eines Fensters wächst, deutet meist auf die Anwendung oder ihren Cluster-Knoten hin, während ein gemeinsamer Anstieg beider Werte auf die Netzwerkbedingungen zwischen Client und Edge hindeutet. Dies misst Netzwerklatenz, nicht die Ressourcennutzung des Containers; für CPU, RAM und Bandbreite, gemessen direkt im Container, siehe Anwendungsmetriken abrufen. Kombiniere colos und countries mit Netzwerk-Analytics, um zu sehen, ob eine langsame Region auch eine traffic-arme ist, bevor du eine Behebung priorisierst.

Parameter

string

erforderlich

Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.

string

erforderlich

ISO-8601-Startzeitstempel für das Analysefenster.

string

erforderlich

ISO-8601-Endzeitstempel. Muss nach start liegen.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war: success, wenn ja, error, wenn nicht.

object

Latenzperzentile und Aufschlüsselungen für das Fenster.

Anzeigen Response-Objekt umschalten

object

Aggregierte Latenzperzentile über das gesamte Fenster.

Anzeigen Summary-Objekt umschalten

object

Edge-seitige Latenzperzentile in Millisekunden.

Anzeigen Edge-Objekt umschalten

integer

50. Perzentil (Median) der Edge-Latenz.

integer

95. Perzentil der Edge-Latenz.

integer

99. Perzentil der Edge-Latenz.

object

Origin-seitige Latenzperzentile in Millisekunden.

Anzeigen Origin-Objekt umschalten

integer

50. Perzentil (Median) der Origin-Latenz.

integer

95. Perzentil der Origin-Latenz.

integer

99. Perzentil der Origin-Latenz.

integer

Gesamtzahl der im Fenster analysierten Anfragen.

array

Latenzperzentile, über das Analysefenster in Buckets gruppiert.

Anzeigen Timeseries-Element umschalten

string

Startzeitstempel des Buckets im ISO-8601-Format.

integer

Im Bucket beobachtete Anfragen.

object

Edge p50/p95/p99 für diesen Bucket.

object

Origin p50/p95/p99 für diesen Bucket.

array

Latenzaufschlüsselung nach Land des Clients.

Anzeigen Countries-Element umschalten

string

Zweistelliger Ländercode (z. B. BR, US).

integer

Median-Latenz für dieses Land in Millisekunden.

integer

95. Perzentil der Latenz für dieses Land in Millisekunden.

integer

An dieses Land ausgelieferte Anfragen.

array

Latenzaufschlüsselung nach Edge-Colo (Rechenzentrum).

Anzeigen Colos-Element umschalten

string

Colo-Kennung (z. B. GRU, IAD).

string

Stadt, in der sich das Colo befindet.

string

Land, in dem sich das Colo befindet.

integer

Median-Latenz an diesem Colo in Millisekunden.

integer

95. Perzentil der Latenz an diesem Colo in Millisekunden.

integer

Über dieses Colo ausgelieferte Anfragen.

array

Pfade mit der höchsten Latenz im Fenster.

Anzeigen Slowest_paths-Element umschalten

string

Anfragepfad.

integer

95. Perzentil der Latenz für diesen Pfad in Millisekunden.

integer

99. Perzentil der Latenz für diesen Pfad in Millisekunden.

integer

Für diesen Pfad beobachtete Anfragen.

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

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_TIME_RANGE`	400	`start`/`end` fehlen, sind fehlerhaft formatiert oder kehren den Zeitraum um.
`UPGRADE_REQUIRED`	403	Performance-Analytics sind nur in den Tarifen Pro und Enterprise verfügbar.
`RATE_LIMITED`	429	Das gemeinsame Limit für Cache-Misses wurde erreicht. Warte und versuche es erneut.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Die Performance-Daten konnten nicht vom Edge-Provider abgerufen werden.
`ANALYTICS_BUSY`	503	Die Edge-Analytics sind vorübergehend ausgelastet. Versuche es in einer Minute erneut.

Siehe auch

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

Edge- und Origin-Latenz abrufen

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

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Edge- und Origin-Latenz abrufen

Parameter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Antwort

Häufige Fehler

Siehe auch