Ottieni metriche applicazione

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
            ],
            "disk": [
                7544832,
                1310720
            ],
            "storage": 11083776
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ],
            "disk": [
                7544832,
                1179648
            ],
            "storage": 11079680
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        }
    ]
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope apps:read. Questo endpoint restituisce l’utilizzo storico delle risorse anziché lo snapshot attuale: fino a 288 punti dati che coprono le ultime 24 ore, campionati ogni 5 minuti, per CPU, RAM, rete, I/O su disco e utilizzo dello spazio di archiviazione. Le applicazioni con meno di 512 MB di RAM sono campionate ogni 10 minuti (fino a 144 punti). Sui piani Pro ed Enterprise, range=7d restituisce invece gli ultimi 7 giorni delle applicazioni con 512 MB o più, un punto all’ora con la media e il picco dell’ora. I punti arrivano dal più recente. Usalo per generare un grafico di utilizzo o per individuare tendenze nel tempo; per i numeri attuali in tempo reale dell’applicazione, usa invece Ottieni lo Stato dell’Applicazione oppure gli eventi status su Log in tempo reale. I risultati sono memorizzati nella cache per 2,5 minuti per (owner, applicazione) (10 minuti per 7d) e l’endpoint ha un limite di frequenza di 10 richieste ogni 5 secondi per utente, con un breve blocco al raggiungimento di tale limite.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

string

predefinito:"24h"

La finestra della cronologia: 24h (un punto ogni 5 minuti, o ogni 10 minuti sotto i 512 MB di RAM) o 7d (un punto all’ora, piani Pro ed Enterprise, applicazioni con 512 MB o più). Negli altri casi, 7d restituisce le ultime 24 ore anziché un errore.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

array

Il contenuto della risposta.

Mostra proprietà

string

La data in formato ISO.

number

La percentuale di utilizzo della CPU nel punto temporale indicato.

number

L’utilizzo di RAM in MB nel punto temporale indicato.

int[]

Un array che rappresenta il totale della rete utilizzata. Prima l’input, poi l’output. Con range=7d, i totali sono conteggiati a partire dal punto più vecchio, quindi la differenza tra due punti consecutivi è il traffico di quell’ora.

int[]

Un array che rappresenta il totale dell’I/O su disco in byte. Prima i byte letti, poi i byte scritti. Con la finestra predefinita 24h, i totali sono conteggiati dall’avvio dell’applicazione, quindi la differenza tra due punti consecutivi è l’I/O di quell’intervallo, e un totale inferiore a quello del punto precedente nel tempo indica che l’applicazione è stata riavviata. Con range=7d, i totali sono conteggiati a partire dal punto più vecchio, quindi la differenza tra due punti consecutivi è l’I/O di quell’ora. null in un punto 24h senza lettura, per esempio un punto registrato prima che questo campo esistesse.

number

Lo spazio su disco, in byte, che l’applicazione sta utilizzando nel punto temporale indicato (con range=7d, alla fine di quell’ora). null quando non c’è una lettura. Usalo per seguire come cresce l’utilizzo del disco nel tempo.

number

Solo con range=7d: la percentuale di utilizzo della CPU più alta nell’ora (cpu è la media dell’ora).

number

Solo con range=7d: l’utilizzo di RAM più alto in MB nell’ora (ram è la media dell’ora).

{
    "status": "success",
    "response": [
        {
            "date": "2025-08-13T12:55:01.348Z",
            "cpu": 0.45,
            "ram": 111.27,
            "net": [
                16834,
                126
            ],
            "disk": [
                7544832,
                1310720
            ],
            "storage": 11083776
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ],
            "disk": [
                7544832,
                1179648
            ],
            "storage": 11079680
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        }
    ]
}

Errori comuni

Codice	HTTP	Significato
`INVALID_PARAMETERS`	400	`range` non è né `24h` né `7d`.

Vedi anche

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

Ottieni metriche applicazione

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
            ],
            "disk": [
                7544832,
                1310720
            ],
            "storage": 11083776
        },
        {
            "date": "2025-08-13T12:50:01.349Z",
            "cpu": 0.45,
            "ram": 111.22,
            "net": [
                16834,
                126
            ],
            "disk": [
                7544832,
                1179648
            ],
            "storage": 11079680
        },
        {
            "date": "2025-08-13T12:45:01.350Z",
            "cpu": 0.58,
            "ram": 111.36,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        },
        {
            "date": "2025-08-13T12:40:01.348Z",
            "cpu": 0.43,
            "ram": 118.44,
            "net": [
                16834,
                126
            ],
            "disk": [
                7540736,
                1048576
            ],
            "storage": 11075584
        }
    ]
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Ottieni metriche applicazione

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche