Log delle richieste edge

GET

apps

{app_id}

network

logs

Log delle richieste edge

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

Restituisce i log edge per richiesta (HTTP, paese, stato, byte) del dominio principale dell’applicazione e di qualsiasi dominio personalizzato configurato. La finestra di conservazione massima è di 7 giorni; l’inizio viene limitato alla data di creazione dell’applicazione.

Disponibile solo sui piani Pro ed Enterprise. I cache miss condividono un unico limite di 20 richieste ogni 60 secondi per proprietario dell’applicazione, tra gli endpoint analytics, errors, logs e performance. Le risposte memorizzate nella cache non vengono conteggiate. Nei periodi di carico elevato sull’intera piattaforma, l’endpoint può invece restituire i dati più recenti memorizzati nella cache per la finestra richiesta.

string

obbligatorio

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

Richiede una chiave API con lo scope apps:read. Questo è un campione del traffico edge grezzo per singola richiesta, non l’output runtime dell’applicazione stessa; per stdout/stderr dal container, vedi invece Ottieni Log Applicazione. Ogni voce cattura il client (IP, paese, user agent), la richiesta (metodo, percorso, query, protocollo) e la risposta (stato, content type, cache HIT/MISS) così come vista da Cloudflare. I risultati vengono memorizzati nella cache in bucket da 5 minuti, lo stesso allineamento usato da Analytics del Sito Web, quindi il polling ripetuto di una finestra mobile riutilizza il campione in cache invece di recuperarlo di nuovo dall’edge a ogni chiamata. Combinalo con Errori di rete per correlare un picco di risposte 5xx con le richieste specifiche che lo hanno causato.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

string

obbligatorio

Timestamp di inizio in formato ISO 8601. Non può essere precedente alla data di creazione dell’applicazione né più vecchio di 7 giorni.

string

obbligatorio

Timestamp di fine in formato ISO 8601. Deve essere successivo a start.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

array

Il contenuto della risposta.

Mostra Mostra oggetto

string

Timestamp della richiesta in formato ISO.

object

Informazioni sul client che ha effettuato la richiesta.

Mostra Mostra oggetto client

string | null

L’indirizzo IP del client.

string | null

Il codice paese del client.

string | null

Il nome del paese del client (es. Brazil).

string

L’ASN del client.

string | null

Lo user agent del client.

string | null

La categoria del client (es. bot, human).

object

Informazioni sulla richiesta in ingresso.

Mostra Mostra oggetto request

boolean

Se la richiesta è stata mitigata dalle protezioni edge.

string

Metodo HTTP usato.

string

Valore dell’header Host.

string

Percorso della richiesta.

string | null

Query string.

string

Protocollo usato (es. HTTP/2).

string | null

Valore dell’header Referer.

object

Informazioni sulla risposta servita all’edge.

Mostra Mostra oggetto response

integer

Codice di stato HTTP restituito.

string | null

Content type della risposta.

string | null

Stato della cache (es. 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"
      }
    }
  ]
}

Errori comuni

Codice	HTTP	Significato
`INVALID_TIME_RANGE`	400	`start`/`end` mancanti, malformati o con l’intervallo temporale invertito.
`UPGRADE_REQUIRED`	403	I log delle analytics sono disponibili solo per i piani Pro ed Enterprise.
`RATE_LIMITED`	429	È stato raggiunto il limite condiviso dei cache miss. Attendi e riprova.
`UNABLE_TO_FETCH_ANALYTICS`	500	Recupero dei log dal provider edge non riuscito.
`ANALYTICS_BUSY`	503	Le analytics edge sono temporaneamente sovraccariche. Riprova tra un minuto.

Vedi anche

CLI: squarecloud app network logs
SDK: api.apps.network.logs() (JavaScript), client.apps.network.logs() (Python), c.Apps.Network.Logs() (Go)

Log delle richieste edge

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

Primi passi

Account

Applicazioni

Database

Workspace

IA

Log delle richieste edge

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche