Logs réseau - Square Cloud

GET

apps

{app_id}

network

logs

Logs réseau

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

Renvoie les logs edge par requête (HTTP, pays, statut, octets) pour le domaine principal de l’application et tout domaine personnalisé configuré. La fenêtre de rétention maximale est de 7 jours ; le début est borné à la date de création de l’application.

Disponible uniquement sur les plans Pro et Enterprise. Limite de débit en cas de cache miss : 10 requêtes par 60 secondes par propriétaire.

string

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Il s’agit d’un échantillon de trafic edge brut, par requête, et non de la sortie runtime propre à l’application ; pour le stdout/stderr du conteneur, voir plutôt Obtenir les logs de l’application. Chaque entrée capture le client (IP, pays, user agent), la requête (méthode, chemin, query, protocole) et la réponse (statut, type de contenu, cache HIT/MISS) tels que vus par Cloudflare. Les résultats sont mis en cache par tranches de 5 minutes, le même alignement que celui utilisé par Analytics de site web, de sorte qu’interroger de façon répétée une fenêtre glissante réutilise l’échantillon en cache plutôt que de le récupérer à nouveau depuis l’edge à chaque appel. Combinez avec Erreurs réseau pour corréler un pic de réponses 5xx avec les requêtes précises qui l’ont déclenché.

Paramètres

string

requis

L’ID de l’application. Vous pouvez le trouver dans l’URL du tableau de bord de votre application.

string

requis

Horodatage de début ISO 8601. Ne peut pas être antérieur à la date de création de l’application ni plus ancien que 7 jours.

string

requis

Horodatage de fin ISO 8601. Doit être postérieur à start.

Réponse

string

Indique si l’appel a réussi. success en cas de succès, error sinon.

array

Le contenu de la réponse.

Afficher Afficher l'objet

string

Horodatage de la requête au format ISO.

object

Informations sur le client ayant effectué la requête.

Afficher Afficher l'objet client

string | null

L’adresse IP du client.

string | null

Le code pays du client.

string | null

La localisation approximative du client.

string

L’ASN du client.

string | null

Le user agent du client.

string | null

La catégorie du client (par ex. bot, humain).

object

Informations sur la requête entrante.

Afficher Afficher l'objet request

boolean

Indique si la requête a été atténuée par les protections edge.

string

Méthode HTTP utilisée.

string

Valeur de l’en-tête Host.

string

Chemin de la requête.

string | null

Chaîne de requête.

string

Protocole utilisé (par ex. HTTP/2).

string | null

Valeur de l’en-tête Referer.

object

Informations sur la réponse servie au niveau de l’edge.

Afficher Afficher l'objet response

integer

Code de statut HTTP renvoyé.

string | null

Type de contenu de la réponse.

string | null

Statut du cache (par ex. 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"
      }
    }
  ]
}

Erreurs courantes

Code	HTTP	Signification
`INVALID_TIME_RANGE`	400	`start`/`end` sont manquants, mal formés, ou inversent la plage temporelle.
`UPGRADE_REQUIRED`	403	Les logs d’analytics sont disponibles uniquement pour les plans Pro et Enterprise.
`UNABLE_TO_FETCH_ANALYTICS`	500	Échec de la récupération des logs depuis le fournisseur edge.

Erreurs réseauObtenez une répartition agrégée des erreurs edge 5xx (et éventuellement 4xx) pour l'application.

Logs réseau

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

​Paramètres

​Réponse

​Erreurs courantes

Paramètres

Réponse

Erreurs courantes