UpCloud

Object Storage Metrics

Monitor usage and performance metrics for your Managed Object Storage services. Metrics include storage usage, request counts, and bandwidth consumption.

GET/1.3/object-storage-2/{service_uuid}/metrics

Get service metrics

Returns overall metrics for the object storage service.

Request

GET
/1.3/object-storage-2/{service_uuid}/metrics
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/metrics \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/buckets/metrics

List bucket metrics

Returns metrics for all buckets in the object storage service.

Query Parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of results. Default: 100.

  • Name
    offset
    Type
    integer
    Description

    Offset for pagination. Default: 0.

Request

GET
/1.3/object-storage-2/{service_uuid}/buckets/metrics
curl -X GET "https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/buckets/metrics?limit=10" \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/metrics/series

List metrics series

Returns time-series metrics for the object storage service.

Query Parameters

  • Name
    metric
    Type
    string
    Description

    Metric to retrieve: request_count, bandwidth_in, bandwidth_out, storage_bytes.

  • Name
    from
    Type
    string
    Description

    Start time in ISO 8601 format.

  • Name
    to
    Type
    string
    Description

    End time in ISO 8601 format.

  • Name
    resolution
    Type
    string
    Description

    Data resolution: hour, day, week. Default: hour.

Request

GET
/1.3/object-storage-2/{service_uuid}/metrics/series
curl -X GET "https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/metrics/series?metric=request_count&resolution=hour" \
  -u your_username:your_password