Netzwerk-Performance - Square Cloud

GET

apps

{app_id}

network

performance

Netzwerk-Performance

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. Rate-Limit bei Cache-Miss: 10 Anfragen pro 60 Sekunden pro Eigentümer.

string

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

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 bei Erfolg, error andernfalls.

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

ISO-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.
`UNABLE_TO_FETCH_PERFORMANCE`	500	Die Performance-Daten konnten nicht vom Edge-Provider abgerufen werden.

Zurück

Custom Domain festlegenBinde deine Website an eine eigene Domain an. Es gilt ein Rate-Limit von 10 Änderungen alle 5 Minuten und 50 alle 24 Stunden.

Weiter

Netzwerk-Performance

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

​Parameter

​Antwort

​Häufige Fehler

Parameter

Antwort

Häufige Fehler