Get Database Stats - Upstash Documentation

get/redis/stats/{id}

Request example

curl --request GET \
  --url 'https://api.upstash.com/v2/redis/stats/{id}?period=1h' \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://api.upstash.com/v2/redis/stats/{id}?period=1h"
headers = {
    "Authorization": "Basic <encoded-value>",
}

response = requests.request("GET", url, headers=headers)

print(response.text)

const response = await fetch('https://api.upstash.com/v2/redis/stats/{id}?period=1h', {
  method: 'GET',
  headers: {
    'Authorization': 'Basic <encoded-value>'
  }
});

const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.upstash.com/v2/redis/stats/{id}?period=1h',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Basic <encoded-value>',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://api.upstash.com/v2/redis/stats/{id}?period=1h"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.upstash.com/v2/redis/stats/{id}?period=1h"))
    .header("Authorization", "Basic <encoded-value>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

require 'uri'
require 'net/http'

url = URI('https://api.upstash.com/v2/redis/stats/{id}?period=1h')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = url.scheme == 'https'

request = Net::HTTP::Get.new(url)
request['Authorization'] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

Response

{
  "monitor_count": {
    "x": "2023-05-22 10:59:23.426 +0000 UTC",
    "y": 320
  },
  "daily_net_commands": 7,
  "daily_read_requests": 7,
  "daily_write_requests": 0,
  "connection_count": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "keyspace": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "throughput": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "diskusage": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "latency_p50": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "latencymean": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "read_latency_p50": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "read_latency_mean": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "read_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "write_latency_p50": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "write_latency_mean": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "write_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "hits": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "misses": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "read": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "write": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "dailyrequests": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    },
    {
      "x": "2025-09-04 15:12:52.76649148 +0000 UTC",
      "y": 7
    }
  ],
  "days": [
    "Sunday",
    "Monday",
    "Tuesday",
    "Wednesday",
    "Thursday"
  ],
  "dailybilling": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    },
    {
      "x": "2025-09-04 15:12:52.76649148 +0000 UTC",
      "y": 1.333
    }
  ],
  "dailybandwidth": 50444740913,
  "bandwidths": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    },
    {
      "x": "2025-09-04 15:12:52.76649148 +0000 UTC",
      "y": 7
    }
  ],
  "total_monthly_bandwidth": 7,
  "total_monthly_requests": 7,
  "total_monthly_read_requests": 7,
  "total_monthly_write_requests": 0,
  "total_monthly_script_requests": 0,
  "queue_optimized": false,
  "total_monthly_storage": 0,
  "current_storage": 0,
  "total_monthly_billing": 222.33902763855485,
  "rest_conn_count": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "latency_p90": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "command_latency_p50": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "command_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "wait_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "disk_load_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "disk_loads": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "lua_latency_p50": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "lua_latency_99": [
    {
      "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
      "y": 0
    }
  ],
  "lua_scripts": [
    {
      "sha": "<string>",
      "script_name": "<string>",
      "count": 1,
      "failures": 1,
      "timeouts": 1,
      "memory_limits": 1,
      "command_count": 1,
      "avg_duration_ns": 1,
      "max_duration_ns": 1,
      "avg_lua_duration_ns": 1,
      "avg_command_duration_ns": 1,
      "avg_allocated_bytes": 1,
      "max_allocated_bytes": 1
    }
  ],
  "lua_script_count": 1,
  "slow_commands": [
    {
      "command": "EVALSHA",
      "count": 1,
      "max_ms": 1
    }
  ],
  "acl_user_logins": [
    {
      "username": "<string>",
      "logins": 1
    }
  ],
  "command_counts": [
    {
      "metric_identifier": "EXISTS",
      "data_points": [
        {
          "x": "2025-08-31 15:12:52.799480932 +0000 UTC",
          "y": 0
        }
      ]
    }
  ]
}

get/redis/stats/{id}

Authorization

Authorizationstringheaderrequired#

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded username:password.

Path parameters

idstringrequired#

The ID of the database

Query parameters

periodstring#

Period the time series cover: 1h, 3h, 12h, 1d, 3d, 7d or 30d. Defaults to 1h. 30d is only available for databases on a Pro plan or with the Production Pack.

Default: "1h"

Responses

application/json

200

Database stats retrieved successfully

monitor_countobject#

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

daily_net_commandsinteger#

Total number of commands executed today

Example:7

daily_read_requestsinteger#

Total number of read requests executed today

Example:7

daily_write_requestsinteger#

Total number of write requests executed today

Example:0

connection_countobject[]#

Connection count over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

keyspaceobject[]#

Total number of keys in the database over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

throughputobject[]#

Throughput on database connections over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

diskusageobject[]#

Disk usage over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

latency_p50object[]#

Median (p50) latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

latencymeanobject[]#

Deprecated alias of latency_p50, kept for older clients. Carries the median, not the mean.

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

latency_99object[]#

99th percentile latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

read_latency_p50object[]#

Median (p50) read latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

read_latency_meanobject[]#

Deprecated alias of read_latency_p50, kept for older clients. Carries the median, not the mean.

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

read_latency_99object[]#

99th percentile read latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

write_latency_p50object[]#

Median (p50) write latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

write_latency_meanobject[]#

Deprecated alias of write_latency_p50, kept for older clients. Carries the median, not the mean.

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

write_latency_99object[]#

99th percentile write latency over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

hitsobject[]#

Cache hits over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

missesobject[]#

Cache misses over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

readobject[]#

Read requests over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

writeobject[]#

Write requests over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

dailyrequestsobject[]#

Daily requests over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  },  {    "x": "2025-09-04 15:12:52.76649148 +0000 UTC",    "y": 7  }]

daysstring[]#

Days of the week for measurement

Example:

[  "Sunday",  "Monday",  "Tuesday",  "Wednesday",  "Thursday"]

dailybillingobject[]#

Daily billing amounts over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  },  {    "x": "2025-09-04 15:12:52.76649148 +0000 UTC",    "y": 1.333  }]

dailybandwidthinteger#

Total daily bandwidth usage in bytes

Example:50444740913

bandwidthsobject[]#

Bandwidth usage over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  },  {    "x": "2025-09-04 15:12:52.76649148 +0000 UTC",    "y": 7  }]

total_monthly_bandwidthinteger#

Total bandwidth used in current month (bytes)

Example:7

total_monthly_requestsinteger#

Total requests in current month

Example:7

total_monthly_read_requestsinteger#

Total read requests in current month

Example:7

total_monthly_write_requestsinteger#

Total write requests in current month

Example:0

total_monthly_script_requestsintegerdeprecated#

Deprecated, always 0. Use daily_script_commands from the Prometheus integration

Example:0

queue_optimizedboolean#

Whether queue optimization is enabled for the database

Example:false

total_monthly_storageinteger#

Total storage used in current month (bytes)

Example:0

current_storageinteger#

Current storage used (bytes)

Example:0

total_monthly_billingnumber#

Total cost in current month

Example:222.33902763855485

rest_conn_countobject[]#

Open REST connections over time

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

latency_p90object[]#

Overall 90th percentile latency over time, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

command_latency_p50object[]#

Median time the engine spent executing commands, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

command_latency_99object[]#

99th percentile time the engine spent executing commands, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

wait_latency_99object[]#

99th percentile time commands waited for the execution lock, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

disk_load_latency_99object[]#

99th percentile time to load a key from disk, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

disk_loadsobject[]#

Keys loaded from disk per ten-minute window, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

lua_latency_p50object[]#

Median Lua script latency over time, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

lua_latency_99object[]#

99th percentile Lua script latency over time, Pro and Production Pack only

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "x": "2025-08-31 15:12:52.799480932 +0000 UTC",    "y": 0  }]

lua_scriptsobject[]#

Most executed Lua scripts since midnight UTC, Pro and Production Pack only

Show child attributes

shastring#

script_namestring#

countnumber#

Executions today

failuresnumber#

timeoutsnumber#

memory_limitsnumber#

command_countnumber#

Redis commands the script ran

avg_duration_nsnumber#

max_duration_nsnumber#

avg_lua_duration_nsnumber#

avg_command_duration_nsnumber#

avg_allocated_bytesnumber#

max_allocated_bytesnumber#

lua_script_countnumber#

Number of distinct Lua scripts run since midnight UTC, Pro and Production Pack only

slow_commandsobject[]#

Commands that exceeded the slow threshold today, Pro and Production Pack only

Show child attributes

commandstring#

Example:"EVALSHA"

countnumber#

Executions today over the slow threshold

max_msnumber#

Slowest execution today in milliseconds

acl_user_loginsobject[]#

Logins per ACL user today, Pro and Production Pack only

Show child attributes

usernamestring#

loginsnumber#

command_countsobject[]#

Command-specific counts over time

Show child attributes

metric_identifierstring#

Command name or metric identifier

Example:"EXISTS"

data_pointsobject[]#

Data points for the given command

Show child attributes

xstringrequired#

Timestamp when measurement was taken

Example:"2023-05-22 10:59:23.426 +0000 UTC"

ynumberrequired#

The measured value

Example:320

Example:

[  {    "metric_identifier": "EXISTS",    "data_points": [      {        "x": "2025-08-31 15:12:52.799480932 +0000 UTC",        "y": 0      }    ]  }]

Get Database Get Database Traffic