Log di rete - Square Cloud

GET

apps

{app_id}

network

logs

Log di rete

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

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. Limite di frequenza in caso di cache miss: 10 richieste ogni 60 secondi per proprietario.

string

obbligatorio

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

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 di successo, 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

La posizione approssimativa del client.

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

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.
`UNABLE_TO_FETCH_ANALYTICS`	500	Recupero dei log dal provider edge non riuscito.

Errori di reteOttieni un riepilogo aggregato degli errori edge 5xx (e facoltativamente 4xx) dell'applicazione.

Log di rete

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

​Parametri

​Risposta

​Errori comuni

Parametri

Risposta

Errori comuni