load-balancer

Get load balancer frontend combined metrics series

Returns combined frontend metric series by given {service-uuid}.

get/1.3/load-balancer/{service-uuid}/metrics/series/frontends

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/load-balancer/{service-uuid}/metrics/series/frontends
  • Auth: HTTP bearer

Path parameters

service-uuidstring uuid required

The UUID of the service.

Example:01234567-89ab-cdef-0123-456789abcdef

The unique identifier for the service.

Query parameters

sort'start_at' | '-start_at'

Sort metrics by field. Prefix with '-' for descending order.

Example:start_at

Response

Created

start_atstring date-time required

Timestamp marking the beginning of the metrics aggregation period.

end_atstring date-time required

Timestamp marking the end of the metrics aggregation period.

frontendsstring[] required

List of frontend names or identifiers included in the aggregated data.

denied_connectionsinteger

Total number of denied frontend connections within the time range.

denied_sessionsinteger

Total number of denied sessions during the period.

invalid_requestsinteger

Number of malformed or invalid HTTP requests received.

request_bytesinteger

Total size of incoming request payloads, in bytes.

response_bytesinteger

Total size of outgoing response payloads, in bytes.

denied_responsesinteger

Number of HTTP responses that were denied or rejected.

http_responses_1xxinteger

Count of informational (1xx) HTTP responses.

http_responses_2xxinteger

Count of successful (2xx) HTTP responses.

http_responses_3xxinteger

Count of redirection (3xx) HTTP responses.

http_responses_4xxinteger

Count of client error (4xx) HTTP responses.

http_responses_5xxinteger

Count of server error (5xx) HTTP responses.

http_responses_otherinteger

Count of HTTP responses with codes outside the 1xx–5xx range.

sessionsinteger

Total number of frontend sessions handled.

http_requestsinteger

Total number of HTTP requests processed during the aggregation period.

denied_requestsinteger

Total number of HTTP requests denied.

intercepted_requestsinteger

Number of requests intercepted before reaching the backend.

Example response

[
  {
    "start_at": "2025-11-06T09:00:00.000Z",
    "end_at": "2025-11-06T09:05:00.000Z",
    "frontends": [
      "frontend-http",
      "frontend-https"
    ],
    "denied_connections": 15,
    "denied_sessions": 8,
    "invalid_requests": 12,
    "request_bytes": 15432000,
    "response_bytes": 14321000,
    "denied_responses": 6,
    "http_responses_1xx": 2,
    "http_responses_2xx": 940,
    "http_responses_3xx": 47,
    "http_responses_4xx": 33,
    "http_responses_5xx": 12,
    "http_responses_other": 0,
    "sessions": 1040,
    "http_requests": 15000,
    "denied_requests": 28,
    "intercepted_requests": 9
  }
]

Changes

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