> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Anwendungsmetriken abrufen

> Die Metriken deiner gehosteten Anwendung abrufen.

Liefert bis zu 288 Datenpunkte (24 Stunden, alle 5 Minuten abgetastet) zur CPU-, RAM- und Netzwerkauslastung. Nur für Anwendungen mit mindestens 512 MB RAM verfügbar. Die Ergebnisse werden pro (Eigentümer, Anwendung) für 2,5 Minuten zwischengespeichert.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

### Parameter

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
</ParamField>

### Antwort

<ResponseField name="status" type="string">
  Gibt an, ob der Aufruf erfolgreich war. `success` bei Erfolg, `error` andernfalls.
</ResponseField>

<ResponseField name="response" type="array">
  Der Inhalt der Antwort.

  <Expandable title="Objekt umschalten">
    <ResponseField name="date" type="string">
      Das Datum im ISO-Format.
    </ResponseField>

    <ResponseField name="cpu" type="number">
      Der prozentuale CPU-Verbrauch zum jeweiligen Zeitpunkt.
    </ResponseField>

    <ResponseField name="ram" type="number">
      Die RAM-Auslastung in MB zum jeweiligen Zeitpunkt.
    </ResponseField>

    <ResponseField name="net" type="int[]">
      Ein Array, das die gesamte Netzwerknutzung darstellt. Zuerst der Eingang, dann der Ausgang.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "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
              ]
          }
      ]
  }
  ```
</ResponseExample>