Netzwerk-Logs - Square Cloud

GET

apps

{app_id}

network

logs

Netzwerk-Logs

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/logs \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/logs', 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/logs",
  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/logs"

	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/logs")

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": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "São Paulo",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

Gibt Edge-Logs pro Anfrage (HTTP, Land, Status, Bytes) für die primäre Domain der Anwendung und jede konfigurierte Custom Domain zurück. Der maximale Aufbewahrungszeitraum beträgt 7 Tage; der Start wird auf das Erstellungsdatum der Anwendung begrenzt.

Nur in den Plänen 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.

Dies ist eine Stichprobe des rohen Edge-Traffics pro Anfrage, nicht die eigene Laufzeitausgabe der Anwendung; für stdout/stderr aus dem Container siehe stattdessen Anwendungslogs abrufen. Jeder Eintrag erfasst den Client (IP, Land, User-Agent), die Anfrage (Methode, Pfad, Query, Protokoll) und die Antwort (Status, Content-Type, Cache HIT/MISS), so wie Cloudflare sie gesehen hat. Ergebnisse werden in 5-Minuten-Fenstern zwischengespeichert, derselben Ausrichtung, die auch Netzwerk-Analytics verwendet. Wiederholtes Abfragen eines gleitenden Zeitfensters nutzt daher die zwischengespeicherte Stichprobe wieder, statt bei jedem Aufruf erneut vom Edge abzurufen. Kombiniere es mit Netzwerkfehler, um einen Anstieg von 5xx-Antworten mit den konkreten Anfragen zu korrelieren, die ihn ausgelöst haben.

Parameter

string

erforderlich

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

string

erforderlich

ISO-8601-Startzeitstempel. Darf nicht vor dem Erstellungsdatum der Anwendung oder älter als 7 Tage sein.

string

erforderlich

ISO-8601-Endzeitstempel. Muss nach start liegen.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war. success bei Erfolg, error andernfalls.

array

Der Inhalt der Antwort.

Anzeigen Objekt umschalten

string

Zeitstempel der Anfrage im ISO-Format.

object

Informationen über den Client, der die Anfrage gestellt hat.

Anzeigen client-Objekt umschalten

string | null

Die IP-Adresse des Clients.

string | null

Der Ländercode des Clients.

string | null

Der ungefähre Standort des Clients.

string

Die ASN des Clients.

string | null

Der User-Agent des Clients.

string | null

Die Client-Kategorie (z. B. Bot, Mensch).

object

Informationen über die eingehende Anfrage.

Anzeigen request-Objekt umschalten

boolean

Ob die Anfrage durch Edge-Schutzmaßnahmen abgewehrt wurde.

string

Verwendete HTTP-Methode.

string

Wert des Host-Headers.

string

Anfragepfad.

string | null

Query-String.

string

Verwendetes Protokoll (z. B. HTTP/2).

string | null

Wert des Referer-Headers.

object

Informationen über die am Edge ausgelieferte Antwort.

Anzeigen response-Objekt umschalten

integer

Zurückgegebener HTTP-Statuscode.

string | null

Content-Type der Antwort.

string | null

Cache-Status (z. B. HIT, MISS).

{
  "status": "success",
  "response": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "São Paulo",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_TIME_RANGE`	400	`start`/`end` fehlen, sind fehlerhaft formatiert oder kehren den Zeitraum um.
`UPGRADE_REQUIRED`	403	Analytics-Logs sind nur in den Tarifen Pro und Enterprise verfügbar.
`UNABLE_TO_FETCH_ANALYTICS`	500	Die Logs konnten nicht vom Edge-Provider abgerufen werden.

Zurück

NetzwerkfehlerRufe eine aggregierte Aufschlüsselung der 5xx- (und optional 4xx-) Edge-Fehler für die Anwendung ab.

Weiter

Netzwerk-Logs

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/logs \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/logs', 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/logs",
  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/logs"

	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/logs")

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": [
    {
      "timestamp": "2025-12-01T12:00:00.000Z",
      "client": {
        "ip": "203.0.113.45",
        "country": "BR",
        "location": "São Paulo",
        "asn": "12345 - Example ISP",
        "agent": "Mozilla/5.0",
        "category": null
      },
      "request": {
        "mitigated": false,
        "method": "GET",
        "host": "my-app.squareweb.app",
        "path": "/api/users",
        "query": "?limit=10",
        "protocol": "HTTP/2",
        "referer": null
      },
      "response": {
        "status": 200,
        "contentType": "application/json",
        "cache": "MISS"
      }
    }
  ]
}

​Parameter

​Antwort

​Häufige Fehler

Parameter

Antwort

Häufige Fehler