Skip to main content
Use this endpoint to retrieve historical performance metrics for a specific database. The response contains a time-ordered array of data points sampled at 5-minute intervals, covering CPU utilization, RAM consumption, and cumulative network traffic. Use these metrics to identify trends, diagnose performance issues, or feed your own monitoring dashboards.

​
Request

GET https://api.virtuscloud.app/v2/databases/{databaseId}/metrics

​
Headers

​
Authorization
string
required
Your Virtus Cloud API key. Pass it directly as the header value — no prefix required.Example: Authorization: vc_live_xxxxxxxxxxxx

​
Path Parameters

​
databaseId
string
required
The unique identifier of the database whose metrics you want to retrieve.

​
Response

​
status
string
Returns "success" when the request completes successfully.
​
response
array
A time-ordered array of metric snapshots, most recent first.

​
Examples

curl -X GET https://api.virtuscloud.app/v2/databases/a14b8d5e1cb7405a851eb4c075506121/metrics \
  -H "Authorization: <api_key>"

​
Response Example

{
  "status": "success",
  "response": [
    {
      "date": "2025-08-13T12:55:01.348Z",
      "cpu": 0.45,
      "ram": 111.27,
      "net": [16834, 126]
    },
    {
      "date": "2025-08-13T12:50:01.349Z",
      "cpu": 0.45,
      "ram": 111.22,
      "net": [16834, 126]
    },
    {
      "date": "2025-08-13T12:45:01.350Z",
      "cpu": 0.58,
      "ram": 111.36,
      "net": [16834, 126]
    },
    {
      "date": "2025-08-13T12:40:01.348Z",
      "cpu": 0.43,
      "ram": 118.44,
      "net": [16834, 126]
    }
  ]
}