Registros de red - Square Cloud

GET

apps

{app_id}

network

logs

Registros de red

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

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. Límite de solicitudes con fallo de caché: 10 solicitudes cada 60 segundos por propietario.

string

requerido

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

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 fue exitosa, 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

La ubicación aproximada del cliente.

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

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.
`UNABLE_TO_FETCH_ANALYTICS`	500	No se pudieron obtener los registros del proveedor de borde.

Errores de redObtén un desglose agregado de los errores edge 5xx (y opcionalmente 4xx) de la aplicación.

Registros de red

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

​Parámetros

​Respuesta

​Errores comunes

Parámetros

Respuesta

Errores comunes