Ottieni metriche database

GET

databases

{database_id}

metrics

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

import requests

url = "https://api.squarecloud.app/v2/databases/{database_id}/metrics"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.squarecloud.app/v2/databases/{database_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/databases/{database_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/databases/{database_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/databases/{database_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 databases:read. Restituisce lo storico dell’utilizzo di CPU, RAM, rete, I/O su disco e spazio di archiviazione di un database, campionato ogni 5 minuti nelle ultime 24 ore (fino a 288 punti), dal più recente. Sui piani Pro ed Enterprise, range=7d restituisce invece gli ultimi 7 giorni, un punto all’ora con la media e il picco dell’ora. Usalo per tracciare grafici di utilizzo o per decidere se il database necessita di più memoria prima di chiamare Modifica Database. Per una singola lettura attuale invece di una serie temporale, usa Ottieni Stato del Database. Le risposte vengono messe in cache per 2,5 minuti per utente e database (10 minuti per 7d), e l’endpoint ha un limite di frequenza di 10 richieste ogni 5 secondi per utente, con un breve blocco una volta raggiunto tale limite. Un database senza campioni recenti restituisce un array vuoto anziché un errore.

Parametri

string

obbligatorio

L’ID del database.

string

predefinito:"24h"

La finestra della cronologia: 24h (un punto ogni 5 minuti) o 7d (un punto all’ora, piani Pro ed Enterprise). Sugli altri piani, 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 attuale di utilizzo della CPU.

number

L’utilizzo attuale di RAM in MB.

int[]

Un array che rappresenta il totale della rete utilizzata. Primo l’input, secondo 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 del database, 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 il database è stato riavviato. 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 il database 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`.
`DATABASE_NOT_FOUND`	404	Il database non esiste o non appartiene al chiamante.

Vedi anche

CLI: squarecloud db metrics
SDK: api.databases.metrics() (JavaScript), client.databases.metrics() (Python), c.Databases.Metrics() (Go)

Ottieni metriche database

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

import requests

url = "https://api.squarecloud.app/v2/databases/{database_id}/metrics"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.squarecloud.app/v2/databases/{database_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/databases/{database_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/databases/{database_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/databases/{database_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 database

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche