Obtenir les logs de requêtes edge

GET

apps

{app_id}

network

logs

Obtenir les logs de requêtes 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"
      }
    }
  ]
}

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. Les cache miss partagent une limite unique de 20 requêtes par 60 secondes par propriétaire de l’application, entre les endpoints analytics, erreurs, logs et performance. Les réponses en cache ne sont pas comptabilisées. Lors des périodes de forte charge sur l’ensemble de la plateforme, l’endpoint peut renvoyer à la place les données en cache les plus récentes pour la fenêtre demandée.

string

requis

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

Nécessite une clé API avec le scope apps:read. 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 si c’est le cas, 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

Le nom du pays du client (par ex. Brazil).

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

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.
`RATE_LIMITED`	429	La limite partagée des cache miss a été atteinte. Patientez puis réessayez.
`UNABLE_TO_FETCH_ANALYTICS`	500	Échec de la récupération des logs depuis le fournisseur edge.
`ANALYTICS_BUSY`	503	Les analytics edge sont temporairement surchargés. Réessayez dans une minute.

Voir aussi

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

Obtenir les logs de requêtes 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"
      }
    }
  ]
}

Premiers pas

Compte

Applications

Bases de données

Workspaces

IA

Obtenir les logs de requêtes edge

Paramètres

Réponse

Erreurs courantes

Voir aussi

​Paramètres

​Réponse

​Erreurs courantes

​Voir aussi

Paramètres

Réponse

Erreurs courantes

Voir aussi