Skip to content

Get Auto Scaling Group VM Monitoring

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

Returns the VMs of an Auto Scaling Group and the charts of one of them: CPU use, CPU load, memory, storage, disk reads and writes, and network traffic. It charts the VM named in node, or the first VM when node is left out. If a chart’s data cannot be read, that chart is empty. metrics_pending is set only when the whole chart read failed.

group_id
required
integer

Auto Scaling Group ID

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.

node
string

Name of the VM to chart, as in nodes[].name. Default: the first VM.

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

The VMs and the charts of one VM

Media typeapplication/json
object
code
integer
message
string
data
object
nodes

The group’s VMs.

Array<object>
object
name
string
public_ip
string
nullable
private_ip
string
nullable
status

Running when the VM is ready, otherwise its state with a capital letter. Unknown when the VM reports no state.

string
selected_node

The VM the charts are for. null when the group has no VM.

string
nullable
range

Repeats the range you sent.

string
step_seconds

Seconds between points. null when there are no charts.

integer
nullable
memory_unit

The unit of memory. Left out when there are no charts.

string
generated_at

Left out when there are no charts.

string
cpu_utilization

CPU use of the VM in percent.

Array<Array<number>>
cpu_load

Load average of the VM over one minute. Empty when the VM does not report it.

Array<Array<number>>
memory

Memory use of the VM, in the unit named by memory_unit.

Array<Array<number>>
storage

Disk use of the VM.

Array<Array<number>>
disk_read_iops

Disk reads per second.

Array<Array<number>>
disk_write_iops

Disk writes per second.

Array<Array<number>>
network_traffic

Network traffic of the VM.

Array<Array<number>>
metrics_pending

Present and true only when the whole chart read failed. Every chart is then empty.

boolean
errors
object

Example

{
"code": 200,
"message": "Success",
"data": {
"nodes": [
{
"name": "ag-example-group-0",
"public_ip": "203.0.113.25",
"private_ip": "10.20.0.14",
"status": "Running"
}
],
"selected_node": "ag-example-group-0",
"range": "1h",
"step_seconds": 60,
"memory_unit": "percent",
"generated_at": "2026-10-21T11:17:42+00:00",
"cpu_utilization": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"cpu_load": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"memory": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"storage": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"disk_read_iops": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"disk_write_iops": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"network_traffic": [
[
1761044262,
31.2
],
[
1761044322,
33.8
]
],
"metrics_pending": true
},
"errors": {}
}

node is not one of the group’s VMs. errors is “Project ID is missing or invalid” when 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": "'ag-example-group-9' is not a node in this autoscale group."
}

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"
}