Obtener logs de solicitudes del edge

GET

apps

{app_id}

network

logs

Obtener logs de solicitudes del 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"
      }
    }
  ]
}

Devuelve los registros edge por solicitud (HTTP, país, estado, bytes) del dominio principal de la aplicación y de cualquier dominio personalizado configurado. La ventana máxima de retención es de 7 días; el inicio se ajusta a la fecha de creación de la aplicación.

Disponible solo en los planes Pro y Enterprise. Los fallos de caché comparten un único límite de 20 solicitudes cada 60 segundos por propietario de la aplicación, entre los endpoints de analítica, errores, registros y rendimiento. Las respuestas en caché no cuentan. En periodos de alta demanda en toda la plataforma, el endpoint puede devolver en su lugar los datos en caché más recientes para la ventana solicitada.

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Requiere una clave de API con el scope apps:read. Esto es una muestra de tráfico de borde en bruto, por solicitud, no la salida de tiempo de ejecución de la propia aplicación; para el stdout/stderr del contenedor, consulta en su lugar Obtener registros de la aplicación. Cada entrada captura al cliente (IP, país, user agent), la solicitud (método, ruta, query, protocolo) y la respuesta (estado, tipo de contenido, caché HIT/MISS) tal como Cloudflare la vio. Los resultados se almacenan en caché en bloques de 5 minutos, la misma alineación usada por Analítica de red, así que consultar repetidamente una ventana móvil reutiliza la muestra en caché en lugar de volver a obtenerla del borde en cada llamada. Combínalo con Errores de red para correlacionar un pico de respuestas 5xx con las solicitudes específicas que lo provocaron.

Parámetros

string

requerido

El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.

string

requerido

Marca de tiempo de inicio en ISO 8601. No puede ser anterior a la fecha de creación de la aplicación ni tener más de 7 días.

string

requerido

Marca de tiempo de fin en ISO 8601. Debe ser posterior a start.

Respuesta

string

Indica si la llamada fue exitosa: success si lo fue, error si no.

array

El contenido de la respuesta.

Mostrar Alternar objeto

string

Marca de tiempo de la solicitud en formato ISO.

object

Información sobre el cliente que realizó la solicitud.

Mostrar Alternar objeto client

string | null

La dirección IP del cliente.

string | null

El código de país del cliente.

string | null

El nombre del país del cliente (p. ej. Brazil).

string

El ASN del cliente.

string | null

El user agent del cliente.

string | null

La categoría del cliente (p. ej. bot, human).

object

Información sobre la solicitud entrante.

Mostrar Alternar objeto request

boolean

Indica si la solicitud fue mitigada por las protecciones edge.

string

Método HTTP utilizado.

string

Valor del encabezado Host.

string

Ruta de la solicitud.

string | null

Cadena de consulta.

string

Protocolo utilizado (p. ej. HTTP/2).

string | null

Valor del encabezado Referer.

object

Información sobre la respuesta servida en el edge.

Mostrar Alternar objeto response

integer

Código de estado HTTP devuelto.

string | null

Tipo de contenido de la respuesta.

string | null

Estado de la caché (p. ej. 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"
      }
    }
  ]
}

Errores comunes

Código	HTTP	Significado
`INVALID_TIME_RANGE`	400	Falta `start`/`end`, están mal formados, o invierten el rango de tiempo.
`UPGRADE_REQUIRED`	403	Los registros de analítica están disponibles solo para los planes Pro y Enterprise.
`RATE_LIMITED`	429	Se alcanzó el límite compartido de fallos de caché. Espera y vuelve a intentarlo.
`UNABLE_TO_FETCH_ANALYTICS`	500	No se pudieron obtener los registros del proveedor de borde.
`ANALYTICS_BUSY`	503	La analítica de borde está ocupada temporalmente. Vuelve a intentarlo en un minuto.

Relacionado

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

Obtener logs de solicitudes del 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"
      }
    }
  ]
}

Primeros pasos

Cuenta

Aplicaciones

Bases de datos

Workspaces

IA

Obtener logs de solicitudes del edge

Parámetros

Respuesta

Errores comunes

Relacionado

​Parámetros

​Respuesta

​Errores comunes

​Relacionado

Parámetros

Respuesta

Errores comunes

Relacionado