Hetzner hcloud icon

Hetzner hcloud

Interact with the cloud api of the german infrastructure provider Hetzner.

Actions47

Server → Get Metrics

AI-generated

Summary

Retrieve time series metrics for a specific server over a defined time range, optionally specifying the resolution of the returned data.

Inputs

  • Server Id (required) — The ID of the server in the project from which to retrieve metrics.
  • Metric-type (required) — The type of metric to retrieve (e.g., 'cpu').
  • Start Time-Date (required) — The start timestamp of the period to get metrics for, in ISO-8601 format.
  • End Time-Date (required) — The end timestamp of the period to get metrics for, in ISO-8601 format.
  • Time Step — Optional resolution of the metric results in seconds.

Output shape

a JSON object containing the requested server metrics data over the specified time period

The output includes the metric values according to the metric type and time range specified. Time Step is optional and controls the data resolution if provided.

Examples

Example 1: Retrieve CPU usage metrics for server ID 1234567 from January 1, 2023 to January 2, 2023 with 60 seconds resolution.

Set 'Server Id' to 1234567, 'Metric-type' to 'cpu', 'Start Time-Date' to '2023-01-01T00:00:00+00:00', 'End Time-Date' to '2023-01-02T00:00:00+00:00', and 'Time Step' to '60'.

Links

Discussion