Obter logs de requisições na borda

GET

apps

{app_id}

network

logs

Obter logs de requisições na borda

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

Retorna logs de borda por requisição (HTTP, país, status, bytes) para o domínio principal da aplicação e qualquer domínio personalizado configurado. A janela máxima de retenção é de 7 dias; o start é limitado à data de criação da aplicação.

Disponível apenas nos planos Pro e Enterprise. O cache miss compartilha um limite único de 20 requisições por 60 segundos por proprietário da aplicação, entre os endpoints de análise, erros, logs e performance. Respostas em cache não contam. Em períodos de alta demanda em toda a plataforma, o endpoint pode retornar os dados em cache mais recentes da janela solicitada.

string

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

Requer uma chave de API com o escopo apps:read. Esta é uma amostra de tráfego de borda bruto por requisição, não a saída de runtime da própria aplicação; para stdout/stderr do container, veja Obter logs. Cada entrada captura o cliente (IP, país, user agent), a requisição (método, caminho, query, protocolo) e a resposta (status, content type, cache HIT/MISS) conforme visto pelo Cloudflare. Os resultados ficam em cache em blocos de 5 minutos, o mesmo alinhamento usado por Análise de rede, então polling repetido de uma janela móvel reutiliza a amostra em cache em vez de buscar novamente na borda a cada chamada. Combine com Erros de rede para correlacionar um pico de respostas 5xx com as requisições específicas que o causaram.

Parâmetros

string

obrigatório

O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.

string

obrigatório

Timestamp inicial em formato ISO 8601. Não pode ser anterior à data de criação da aplicação ou mais antigo que 7 dias.

string

obrigatório

Timestamp final em formato ISO 8601. Deve ser posterior ao start.

Resposta

string

Indica se a chamada foi bem-sucedida: success se foi, error se não.

array

O conteúdo da resposta.

Mostrar Alternar objeto

string

Timestamp da requisição em formato ISO.

object

Informações sobre o cliente que fez a requisição.

Mostrar Alternar objeto client

string | null

O endereço IP do cliente.

string | null

O código do país do cliente.

string | null

O nome do país do cliente (ex.: Brazil).

string

O ASN do cliente.

string | null

O user agent do cliente.

string | null

A categoria do cliente (ex. bot, humano).

object

Informações sobre a requisição recebida.

Mostrar Alternar objeto request

boolean

Indica se a requisição foi mitigada pelas proteções de borda.

string

Método HTTP utilizado.

string

Valor do header Host.

string

Caminho da requisição.

string | null

String de query.

string

Protocolo utilizado (ex. HTTP/2).

string | null

Valor do header Referer.

object

Informações sobre a resposta servida na borda.

Mostrar Alternar objeto response

integer

Código de status HTTP retornado.

string | null

Content-Type da resposta.

string | null

Status do cache (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"
      }
    }
  ]
}

Erros comuns

Código	HTTP	Significado
`INVALID_TIME_RANGE`	400	`start`/`end` estão ausentes, malformados ou invertem o intervalo de tempo.
`UPGRADE_REQUIRED`	403	Logs de análise estão disponíveis apenas nos planos Pro e Enterprise.
`RATE_LIMITED`	429	O limite compartilhado de cache misses foi atingido. Aguarde e tente novamente.
`UNABLE_TO_FETCH_ANALYTICS`	500	Falha ao obter os logs do provedor de edge.
`ANALYTICS_BUSY`	503	As análises de borda estão temporariamente ocupadas. Tente novamente em um minuto.

Relacionados

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

Obter logs de requisições na borda

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

Primeiros passos

Conta

Aplicações

Bancos de dados

Workspaces

IA

Obter logs de requisições na borda

Parâmetros

Resposta

Erros comuns

Relacionados

​Parâmetros

​Resposta

​Erros comuns

​Relacionados

Parâmetros

Resposta

Erros comuns

Relacionados