Load Balancers

Get Metrics for a LoadBalancer

You must specify the type of metric to get: open_connections, connections_per_second, requests_per_second or bandwidth. You can also specify more than one type by comma separation, e.g. requests_per_second,bandwidth.

Depending on the type you will get different time series data:

TypeTimeseriesUnitDescription
open_connectionsopen_connectionsnumberOpen connections
connections_per_secondconnections_per_secondconnections/sConnections per second
requests_per_secondrequests_per_secondrequests/sRequests per second
bandwidthbandwidth.inbytes/sIngress bandwidth
bandwidth.outbytes/sEgress bandwidth

Metrics are available for the last 30 days only.

If you do not provide the step argument we will automatically adjust it so that 200 samples are returned.

We limit the number of samples to a maximum of 500 and will adjust the step parameter accordingly.

get/load_balancers/{id}/metrics

Request

  • Base URL: https://api.hetzner.cloud/v1
  • URL: https://api.hetzner.cloud/v1/load_balancers/{id}/metrics
  • Auth: HTTP bearer

Path parameters

idinteger required

ID of the Load Balancer.

Example:42

ID of the Load Balancer.

Query parameters

typestring[] required

Type of metrics to get.

startstring required

Start of period to get Metrics for (must be in RFC3339 format).

endstring required

End of period to get Metrics for (must be in RFC3339 format).

stepstring

Resolution of results in seconds.

Response

Request succeeded.

Example response

{
  "metrics": {
    "start": "2017-01-01T00:00:00Z",
    "end": "2017-01-01T23:00:00Z",
    "step": 60,
    "time_series": {
      "name_of_timeseries": {
        "values": [
          [
            1435781470.622,
            "42"
          ],
          [
            1435781471.622,
            "43"
          ]
        ]
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.