# Fetch Instance Monitor Metrics - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/gpu-instance-get-metrics

# Fetch Instance Monitor Metrics

GET

/

openapi

/

v1

/

metrics

/

gpu

/

instance

Try it

Fetch Instance Monitor Metrics

cURL

```
curl --request GET \
--url https://api.novita.ai/openapi/v1/metrics/gpu/instance \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>'
```

200

```
{
"cpuUtilization": [
{
"timestamp": "<string>",
"value": 123
}
],
"memUtilization": [
{
"timestamp": "<string>",
"value": 123
}
],
"rootDiskUtilization": [
{
"timestamp": "<string>",
"value": 123
}
],
"gpuUtilization": {
"avg": [
{
"timestamp": "<string>",
"value": 123
}
],
"gpuIds": [
{
"gpuId": "<string>",
"items": [
{
"timestamp": "<string>",
"value": 123
}
]
}
]
},
"gpuMemUtilization": {
"avg": [
{
"timestamp": "<string>",
"value": 123
}
],
"gpuIds": [
{
"gpuId": "<string>",
"items": [
{
"timestamp": "<string>",
"value": 123
}
]
}
]
}
}
```

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Enum: `application/json`

[​](#param-authorization)

Authorization

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

##

[​](#query-parameters)

Query Parameters

If the parameters endTime, startTime, or interval do not meet the requirements, default values will be used. There may be a delay of about one minute when retrieving real-time monitoring data.

[​](#param-instance-id)

instanceId

string

required

Instance ID.

[​](#param-end-time)

endTime

integer

End time for querying monitoring data. Value range: (0, current timestamp], default: current timestamp.

[​](#param-start-time)

startTime

integer

Start time for querying monitoring data. Value range: (0, endTime - 60], default: current timestamp - 60.

[​](#param-interval)

interval

integer

Time granularity for monitoring data, in seconds. Value must be greater than 15. Default: 15.

##

[​](#response)

Response

[​](#param-cpu-utilization)

cpuUtilization

array

required

CPU utilization data.

Show properties

[​](#param-timestamp)

timestamp

string

required

Timestamp.

[​](#param-value)

value

number

required

CPU utilization.

[​](#param-mem-utilization)

memUtilization

array

required

Memory utilization data.

Show properties

[​](#param-timestamp-1)

timestamp

string

required

Timestamp.

[​](#param-value-1)

value

number

required

Memory utilization.

[​](#param-root-disk-utilization)

rootDiskUtilization

array

required

Root disk utilization data.

Show properties

[​](#param-timestamp-2)

timestamp

string

required

Timestamp.

[​](#param-value-2)

value

number

required

Root disk utilization.

[​](#param-gpu-utilization)

gpuUtilization

object

required

GPU utilization data.

Show properties

[​](#param-avg)

avg

array

required

Average utilization across all GPUs.

Show properties

[​](#param-timestamp-3)

timestamp

string

required

Timestamp.

[​](#param-value-3)

value

number

required

Utilization.

[​](#param-gpu-ids)

gpuIds

array

required

Utilization for each GPU.

Show properties

[​](#param-gpu-id)

gpuId

string

required

GPU ID in use.

[​](#param-items)

items

array

required

GPU utilization data.

Show properties

[​](#param-timestamp-4)

timestamp

string

required

Timestamp.

[​](#param-value-4)

value

number

required

Utilization.

[​](#param-gpu-mem-utilization)

gpuMemUtilization

object

required

GPU memory utilization data.

Show properties

[​](#param-avg-1)

avg

array

required

Average GPU memory utilization across all GPUs.

Show properties

[​](#param-timestamp-5)

timestamp

string

required

Timestamp.

[​](#param-value-5)

value

number

required

Utilization.

[​](#param-gpu-ids-1)

gpuIds

array

required

GPU memory utilization for each GPU.

Show properties

[​](#param-gpu-id-1)

gpuId

string

required

GPU ID in use.

[​](#param-items-1)

items

array

required

GPU memory utilization data.

Show properties

[​](#param-timestamp-6)

timestamp

string

required

Timestamp.

[​](#param-value-6)

value

number

required

Utilization.

Last modified on July 10, 2025