Obter métricas da aplicação

GET

apps

{app_id}

metrics

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/metrics \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/metrics', 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}/metrics",
  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}/metrics"

	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}/metrics")

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": [
        {
            "date": "2025-08-13T12:55:01.348Z",
            "cpu": 0.45,
            "ram": 111.27,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ]
        }
    ]
}

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. Este endpoint retorna o uso histórico de recursos em vez do snapshot atual: até 288 pontos de dados cobrindo as últimas 24 horas, amostradas a cada 5 minutos, para CPU, RAM e rede. Aplicações com menos de 512 MB de RAM são amostradas a cada 10 minutos (até 144 pontos). Nos planos Pro e Enterprise, range=7d retorna os últimos 7 dias de aplicações com 512 MB ou mais, um ponto por hora com a média e o pico da hora. Os pontos vêm do mais recente para o mais antigo. Use-o para renderizar um gráfico de uso ou identificar tendências ao longo do tempo; para os números atuais e ao vivo da aplicação, use Obter status da aplicação ou os eventos status dos Logs em tempo real. Os resultados são cacheados por 2.5 minutos por (proprietário, aplicação) (10 minutos para 7d), e o endpoint possui limite de taxa de 10 requisições a cada 5 segundos por usuário, com um bloqueio curto ao atingir esse limite.

Parâmetros

string

obrigatório

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

string

padrão:"24h"

A janela do histórico: 24h (um ponto a cada 5 minutos, ou a cada 10 minutos abaixo de 512 MB de RAM) ou 7d (um ponto por hora, planos Pro e Enterprise, aplicações com 512 MB ou mais). Nos demais casos, 7d retorna as últimas 24 horas em vez de um erro.

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

A data em formato ISO.

number

A porcentagem de uso da CPU no ponto de tempo informado.

number

O uso de RAM em MB no ponto de tempo informado.

int[]

Um array representando o total de rede usado. Primeiro é entrada (input), segundo é saída (output). Com range=7d, os totais são contados a partir do ponto mais antigo, então a diferença entre dois pontos consecutivos é o tráfego daquela hora.

number

Somente com range=7d: a maior porcentagem de uso da CPU dentro da hora (cpu é a média da hora).

number

Somente com range=7d: o maior uso de RAM em MB dentro da hora (ram é a média da hora).

{
    "status": "success",
    "response": [
        {
            "date": "2025-08-13T12:55:01.348Z",
            "cpu": 0.45,
            "ram": 111.27,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ]
        }
    ]
}

Erros comuns

Código	HTTP	Significado
`INVALID_PARAMETERS`	400	`range` não é `24h` nem `7d`.

Relacionados

CLI: squarecloud app metrics
SDKs: api.apps.metrics() (JavaScript), client.apps.metrics() (Python), c.Apps.Metrics() (Go)

Obter métricas da aplicação

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/metrics \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/metrics', 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}/metrics",
  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}/metrics"

	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}/metrics")

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": [
        {
            "date": "2025-08-13T12:55:01.348Z",
            "cpu": 0.45,
            "ram": 111.27,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ]
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ]
        }
    ]
}

Primeiros passos

Conta

Aplicações

Bancos de dados

Workspaces

IA

Obter métricas da aplicação

Parâmetros

Resposta

Erros comuns

Relacionados

​Parâmetros

​Resposta

​Erros comuns

​Relacionados

Parâmetros

Resposta

Erros comuns

Relacionados