Get Database Stats

This endpoint gets detailed stats of a database.

URL Parameters

id · string · required

The ID of the database

Response Parameters

connection_count · Object

Show properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number of connections momentarily

keyspace · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number keys exists in the database

throughput · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Throughput seen on the database connections

produce_throughput · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Throughput seen on the database connections for write requests

consume_throughput · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Throughput seen on the database connections for read requests

diskusage · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total amount of this usage of the database

latencymax · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Maximum server latency observed in the last hour

latencymin · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Minimum server latency observed in the last hour

read_latency_mean · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The average read latency value measured in the last hour

read_latency_99 · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The 99th percentile server read latency observed in the last hour

write_latency_mean · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The average write latency value measured in the last hour

write_latency_99 · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The 99th percentile server write latency observed in the last hour

hits · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number requests made to the database that are hit

misses · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number requests made to the database that are miss

read · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number read requests made to the database

write · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number write requests made to the database

dailyrequests · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

Total number requests made to the database on the corresponding day

dailybandwidth · int

The total daily bandwidth usage (in bytes).

bandwidths · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The total bandwidth size for that specific timestamp

days · Array<string>

A list of the days of the week for the measurement

dailybilling · Object

Show Properties

x · string

Timestamp indicating when the measurement was taken.

y · int

The billing amount for that specific date.

dailyproduce · int

Total number of daily produced commands

dailyconsume · int

Total number of daily consumed commands

total_monthly_requests · int

The total number of requests made in the current month.

total_monthly_read_requests · int

The total number of read requests made in the current month.

total_monthly_write_requests · int

The total number of write requests made in the current month.

total_monthly_storage · int

The total amount of storage used (in bytes) in the current month.

total_monthly_billing · int

Total cost of the database in the current month

total_monthly_produce · int

Total number of produce commands in the current month

total_monthly_consume · int

Total number of consume commands in the current month

curl

curl -X GET \
  https://api.upstash.com/v2/redis/stats/:id \
  -u 'EMAIL:API_KEY'

200 OK

{
  "connection_count": [
    {
      "x": "2023-05-22 10:59:23.426 +0000 UTC",
      "y": 320
    },
    ...
  ],
  "keyspace": [
    {
      "x": "2023-05-22 10:59:23.426 +0000 UTC",
      "y": 344725564
    },
    ...
  ],
  "throughput": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 181.88333333333333
    },
    ...
  ],
  "produce_throughput": null,
  "consume_throughput": null,
  "diskusage": [
    {
      "x": "2023-05-22 10:59:23.426 +0000 UTC",
      "y": 532362818323
    },
    ...
  ],
  "latencymean": [
    {
      "x": "2023-05-22 10:59:23.426 +0000 UTC",
      "y": 0.176289
    },
    ...
  ],
  "read_latency_mean": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "read_latency_99": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "write_latency_mean": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "write_latency_99": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "hits": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "misses": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 0
    },
    ...
  ],
  "read": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 82.53333333333333
    },
    ...
  ],
  "write": [
    {
      "x": "2023-05-22 11:00:23.426 +0000 UTC",
      "y": 99.35
    },
    ...
  ],
  "dailyrequests": [
    {
      "x": "2023-05-18 11:58:23.534505371 +0000 UTC",
      "y": 68844080
    },
    ...
  ],
  "days": [
    "Thursday",
    "Friday",
    "Saturday",
    "Sunday",
    "Monday"
  ],
  "dailybilling": [
    {
      "x": "2023-05-18 11:58:23.534505371 +0000 UTC",
      "y": 145.72694911244588
    },
    ...
  ],
  "dailybandwidth": 50444740913,
  "bandwidths": [
    {
      "x": "2023-05-18 11:58:23.534505371 +0000 UTC",
      "y": 125391861729
    },
    ...
  ],
  "dailyproduce": null,
  "dailyconsume": null,
  "total_monthly_requests": 1283856937,
  "total_monthly_read_requests": 1034567002,
  "total_monthly_write_requests": 249289935,
  "total_monthly_storage": 445942383672,
  "total_monthly_billing": 222.33902763855485,
  "total_monthly_produce": 0,
  "total_monthly_consume": 0
}