Anwendungsmetriken abrufen

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

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Erfordert einen API-Schlüssel mit dem Scope apps:read. Dieser Endpoint liefert historische Ressourcennutzung statt einer aktuellen Momentaufnahme: bis zu 288 Datenpunkte der letzten 24 Stunden, alle 5 Minuten abgetastet, für CPU, RAM, Netzwerk, Disk-I/O und Speicherplatz. Anwendungen mit weniger als 512 MB RAM werden alle 10 Minuten abgetastet (bis zu 144 Punkte). In den Plänen Pro und Enterprise liefert range=7d stattdessen die letzten 7 Tage von Anwendungen mit 512 MB oder mehr, ein Punkt pro Stunde mit dem Durchschnitt und der Spitze der Stunde. Die neuesten Punkte kommen zuerst. Verwende ihn, um ein Nutzungsdiagramm darzustellen oder Trends über die Zeit zu erkennen; für die aktuellen Live-Werte der Anwendung verwende stattdessen Anwendungsstatus abrufen oder die status-Events der Echtzeit-Logs. Die Ergebnisse werden pro (Eigentümer, Anwendung) für 2,5 Minuten (10 Minuten für 7d) zwischengespeichert, und der Endpoint ist auf 10 Anfragen alle 5 Sekunden pro Benutzer begrenzt, mit einer kurzen Sperre, sobald dieses Limit erreicht ist.

Parameter

string

erforderlich

Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.

string

Standard:"24h"

Das Zeitfenster des Verlaufs: 24h (ein Punkt alle 5 Minuten, unter 512 MB RAM alle 10 Minuten) oder 7d (ein Punkt pro Stunde, Pläne Pro und Enterprise, Anwendungen mit 512 MB oder mehr). Andernfalls liefert 7d statt eines Fehlers die letzten 24 Stunden.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war: success, wenn ja, error, wenn nicht.

array

Der Inhalt der Antwort.

Anzeigen Eigenschaften

string

Das Datum im ISO-Format.

number

Der prozentuale CPU-Verbrauch zum jeweiligen Zeitpunkt.

number

Die RAM-Auslastung in MB zum jeweiligen Zeitpunkt.

int[]

Ein Array, das die gesamte Netzwerknutzung darstellt. Zuerst der Eingang, dann der Ausgang. Mit range=7d werden die Summen ab dem ältesten Punkt gezählt, sodass die Differenz zwischen zwei aufeinanderfolgenden Punkten der Traffic dieser Stunde ist.

int[]

Ein Array, das die gesamte Disk-I/O in Bytes darstellt. Zuerst die gelesenen, dann die geschriebenen Bytes. Mit dem Standardzeitfenster 24h werden die Summen seit dem Start der Anwendung gezählt, sodass die Differenz zwischen zwei aufeinanderfolgenden Punkten die I/O dieses Intervalls ist. Ist eine Summe niedriger als beim zeitlich vorherigen Punkt, wurde die Anwendung neu gestartet. Mit range=7d werden die Summen ab dem ältesten Punkt gezählt, sodass die Differenz zwischen zwei aufeinanderfolgenden Punkten die I/O dieser Stunde ist. null bei einem 24h-Punkt ohne Messwert, zum Beispiel bei einem Punkt, der aufgezeichnet wurde, bevor es dieses Feld gab.

number

Der Speicherplatz in Bytes, den die Anwendung zum jeweiligen Zeitpunkt belegt (mit range=7d: am Ende dieser Stunde). null, wenn kein Messwert vorliegt. Verwende das Feld, um zu verfolgen, wie der belegte Speicherplatz im Laufe der Zeit wächst.

number

Nur mit range=7d: der höchste prozentuale CPU-Verbrauch innerhalb der Stunde (cpu ist der Durchschnitt der Stunde).

number

Nur mit range=7d: die höchste RAM-Nutzung in MB innerhalb der Stunde (ram ist der Durchschnitt der Stunde).

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

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_PARAMETERS`	400	`range` ist weder `24h` noch `7d`.

Siehe auch

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

Anwendungsmetriken abrufen

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

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Anwendungsmetriken abrufen

Parameter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Antwort

Häufige Fehler

Siehe auch