Get Auto Scaling Group Metrics

GET

/notebooks/autoscale-groups/{group_id}/group-metrics/

curl --request GET \
  --url 'https://api.e2enetworks.com/myaccount/api/v1/gpu/notebooks/autoscale-groups/{group_id}/group-metrics/?project_id=<PROJECT_ID>&location=<LOCATION>&apikey=<API_KEY>' \
  --header 'Authorization: Bearer <API_TOKEN>'

Returns CPU use, memory use, network traffic and the number of VMs of an Auto Scaling Group over time, averaged across its VMs, with the average, peak and 95th percentile of each over the range and the latest reading. If a chart’s data cannot be read, that chart is empty.

Parameters

Path Parameters

group_id

required

integer

Auto Scaling Group ID

Query Parameters

project_id

required

integer

Project ID

range

string

default: 1h

Allowed values: 1h 6h 24h 7d 30d

How far back to look. Each range has its own spacing between points: 1h, 60 seconds; 6h, 5 minutes; 24h, 15 minutes; 7d, 1 hour; 30d, 4 hours. A value not in this list gives the 1h window, and range in the response still repeats what you sent.

active_iam

integer

Active IAM ID (To access contact person account) Find your Active IAM ID here

location

required

string

Allowed values: Delhi Chennai

Location

Responses

200

The metrics

Media typeapplication/json

object

code

integer

message

string

data

object

range

Repeats the range you sent.

string

generated_at

string

cpu_utilization

Average CPU use of the group’s VMs in percent.

Array<Array<number>>

memory

Average memory use of the group’s VMs, in the unit named by memory_unit.

Array<Array<number>>

memory_unit

string

network

Average network traffic per VM in bytes per second, received plus sent.

Array<Array<number>>

instance_count

Number of VMs over time, as whole numbers.

Array<Array<number>>

window_avg_peak

Average, peak and 95th percentile of each series over the range. A value is null when it could not be worked out.

object

cpu_utilization

object

avg

number

nullable

peak

number

nullable

p95

number

nullable

memory

object

avg

number

nullable

peak

number

nullable

p95

number

nullable

network

object

avg

number

nullable

peak

number

nullable

p95

number

nullable

instance_count

object

peak

number

nullable

current_cpu_percent

The latest CPU reading. null when there is none.

number

nullable

current_memory_percent

The latest memory reading. null when there is none.

number

nullable

current_network_bytes_per_sec

The latest network reading. null when there is none.

integer

nullable

errors

object

Example

{
  "code": 200,
  "message": "Success",
  "data": {
    "range": "1h",
    "generated_at": "2026-10-21T11:17:42+00:00",
    "cpu_utilization": [
      [
        1761044262,
        31.2
      ],
      [
        1761044322,
        33.8
      ]
    ],
    "memory": [
      [
        1761044262,
        31.2
      ],
      [
        1761044322,
        33.8
      ]
    ],
    "memory_unit": "percent",
    "network": [
      [
        1761044262,
        31.2
      ],
      [
        1761044322,
        33.8
      ]
    ],
    "instance_count": [
      [
        1761044262,
        31.2
      ],
      [
        1761044322,
        33.8
      ]
    ],
    "window_avg_peak": {
      "cpu_utilization": {
        "avg": 28.4,
        "peak": 71.9,
        "p95": 66.2
      },
      "memory": {
        "avg": 40.1,
        "peak": 52.3,
        "p95": 49.8
      },
      "network": {
        "avg": 90210.5,
        "peak": 410000.2,
        "p95": 350100.7
      },
      "instance_count": {
        "peak": 4
      }
    },
    "current_cpu_percent": 31.2,
    "current_memory_percent": 44,
    "current_network_bytes_per_sec": 120345
  },
  "errors": {}
}

400

project_id is missing or not a number.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 400,
  "message": "Bad Request",
  "data": {},
  "errors": "Project ID is missing or invalid"
}

404

No Auto Scaling Group with that ID in the project and region.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 404,
  "message": "Bad Request",
  "data": {},
  "errors": "Autoscale Group not found"
}

500

The metrics could not be read. data is “Failed to fetch group metrics from the cluster: ”.

Media typeapplication/json

object

code

integer

message

string

data

string

errors

object

Example

{
  "code": 500,
  "message": "Internal Server Error",
  "data": "Failed to fetch group metrics from the cluster: <error>",
  "errors": {}
}