Edge-Request-Logs abrufen

GET

apps

{app_id}

network

logs

Edge-Request-Logs abrufen

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": "Brazil",
        "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. 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. 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, wenn ja, error, wenn nicht.

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 Ländername des Clients (z. B. Brazil).

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": "Brazil",
        "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.
`RATE_LIMITED`	429	Das gemeinsame Limit für Cache-Misses wurde erreicht. Warte und versuche es erneut.
`UNABLE_TO_FETCH_ANALYTICS`	500	Die Logs 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 logs
SDKs: api.apps.network.logs() (JavaScript), client.apps.network.logs() (Python), c.Apps.Network.Logs() (Go)

Edge-Request-Logs abrufen

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": "Brazil",
        "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"
      }
    }
  ]
}

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Edge-Request-Logs abrufen

Parameter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Antwort

Häufige Fehler

Siehe auch