Metrics

Read metrics

Returns totals and a series for a time range and for the same length of time before it. Needs Storage buckets: View.

GET /v1/projects/{project}/metrics?range=7d&bucket=invoices

rangestring

24h, 7d or 30d. 24h when you leave it out. The last 24 hours are counted by the hour, and 7 or 30 days by the day, in UTC.

bucketstring

A bucket’s name or id, to count only that bucket. Every bucket when you leave it out.

The answer:

{
  "range": "7d",
  "step": "day",
  "bucket": { "id": "…", "name": "invoices", "…": "…" },
  "edge": true,
  "current": {
    "since": "2026-09-21T00:00:00Z",
    "until": "2026-09-28T00:00:00Z",
    "totals": {
      "averageBytes": 20630,
      "files": 12,
      "writes": 6430,
      "reads": 57,
      "served": 9,
      "bytesServed": 412000,
      "failed": 1,
      "cacheHits": 6
    },
    "points": [
      {
        "start": "2026-09-21T00:00:00Z",
        "averageBytes": 17370,
        "files": 10,
        "writes": 910,
        "…": "…"
      }
    ]
  },
  "previous": {
    "since": "…",
    "until": "…",
    "totals": { "…": "…" },
    "points": []
  },
  "topFiles": [
    {
      "bucket": "invoices",
      "key": "2026/0001.pdf",
      "reads": 4,
      "bytesServed": 193000
    }
  ]
}

stepstring

hour or day: how long each point in points covers.

edgeboolean

Whether files opened through files.digitospace.com are counted. When false, served, bytesServed, failed and cacheHits are 0 and topFiles is empty.

currentobject

The time range you asked for, from since up to until.

previousobject

The same length of time just before it, with the same fields, to compare with.

totals.averageBytesinteger

The average size of the stored files over the range, in bytes. In points, the average over that hour or day.

totals.filesinteger

How many files were stored at the end of the range.

totals.writesinteger

Requests that added, changed, deleted or listed: uploads started, finished or cancelled, copies, deletes, folders, bucket changes, and listings.

totals.readsinteger

Requests that read a bucket’s or file’s details, or got a download link.

totals.servedinteger

Files opened through files.digitospace.com, from public addresses and download links.

totals.bytesServedinteger

Bytes sent to the people who opened them.

totals.failedinteger

Files that could not be opened, such as one deleted since the link was made.

totals.cacheHitsinteger

Public files answered from the cache near the reader, without reading storage.

topFilesarray

Up to 10 files opened most often in the range, with their bucket, key, reads and bytes served.

Only requests that succeed count as writes or reads. served, bytesServed, failed, cacheHits and topFiles are estimated from a sample of requests, so small numbers can be slightly off. Writes, reads, storage and files are exact.