Zum Hauptinhalt springen

Get usage metrics for a server

GET/v2/servers/{serverId}/usage-metrics
API-Version
v2
Request-Methode
GET
Operation-ID
project-get-server-usage-metrics

Request​

  • serverIdstring (uuid)required

    ID of the server whose usage metrics are retrieved.

Responses​

Format
application/json
Beschreibung

Usage metrics for the server

  • seriesArray von objectrequired

    Usage relative to the applicable limit (1 = 100 %).

    • Array[
      • *object
        • labelsobjectrequired

          Prometheus labels identifying the series, e.g. project, stack, container, database_type or database_version; empty for an aggregated series.

          • *string
        • samplesArray von objectrequired
          • Array[
            • *object
              • timestring (date-time)required
              • valuenumberrequired
            ]
      ]
Content-Type: application/json

{
"series": [
{
"labels": {
"project": "p-XXXXXX"
},
"samples": [
{
"time": "2026-11-10T12:00:00.000Z",
"value": 0.42
}
]
}
]
}
{
"properties": {
"series": {
"description": "Usage relative to the applicable limit (1 = 100 %).",
"items": {
"properties": {
"labels": {
"additionalProperties": {
"type": "string"
},
"description": "Prometheus labels identifying the series, e.g. `project`, `stack`, `container`, `database_type` or `database_version`; empty for an aggregated series.",
"example": {
"project": "p-XXXXXX"
},
"type": "object"
},
"samples": {
"items": {
"properties": {
"time": {
"example": "2026-11-10T12:00:00.000Z",
"format": "date-time",
"type": "string"
},
"value": {
"example": 0.42,
"type": "number"
}
},
"required": [
"time",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"labels",
"samples"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"series"
],
"type": "object"
}

Nutzungsbeispiele​

$ curl \
--fail \
--location \
-H "Authorization: Bearer $MITTWALD_API_TOKEN" \
https://api.mittwald.de/v2/servers/f0f86186-0a5a-45b2-aa33-502777496347/usage-metrics?metric=cpu&from=1985-10-26T01%3A21%3A00.000Z&to=1985-10-26T01%3A21%3A00.000Z
import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";

const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.project.getServerUsageMetrics({
"serverId": "f0f86186-0a5a-45b2-aa33-502777496347",
"queryParameters": {
"metric": "cpu",
"from": "1985-10-26T01:21:00.000Z",
"to": "1985-10-26T01:21:00.000Z"
}
});

assertStatus(response, 200);

use \Mittwald\ApiClient\Generated\V2\Clients\Project\GetServerUsageMetrics\GetServerUsageMetricsRequest;

$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new GetServerUsageMetricsRequest(
serverId: "f0f86186-0a5a-45b2-aa33-502777496347"
))
->withMetric("cpu")
->withFrom("1985-10-26T01:21:00.000Z")
->withTo("1985-10-26T01:21:00.000Z");
$response = $client->project()->getServerUsageMetrics($request);

var_dump($response->getBody();

Auf dieser Seite