Query Request Analytics

Retrieves Workers KV request metrics for the given account.

Responses

🟢200Query Request Analytics response

application/json

Body

result

components-schemas-result

required

Any of

schemas-result

allOf {3}

Metrics on Workers KV requests.

data

array [object {1}] | null

required

Example:

[{"metrics":[[2,4],[16,32]]}]

data_lag

number

required

Number of seconds between current time and last processed event, i.e. how many seconds of data could be missing.

>= 0

Example:

max

required

Maximum results for each metric.

Example:

{"readKiB":32,"requests":4}

min

required

Minimum results for each metric.

Example:

{"readKiB":16,"requests":2}

query

object

schemas-query

required

For specifying result metrics.

rows

number

required

Total number of rows in the result.

>= 0

Example:

totals

required

Total results for metrics across all data.

Example:

{"readKiB":48,"requests":6}

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "data": [
            {
                "metrics": [
                    [
                        2,
                        4
                    ],
                    [
                        16,
                        32
                    ]
                ]
            }
        ],
        "data_lag": 0,
        "max": {
            "readKiB": 32,
            "requests": 4
        },
        "min": {
            "readKiB": 16,
            "requests": 2
        },
        "query": {
            "dimensions": [
                "accountId",
                "responseCode"
            ],
            "filters": "requestType==read AND responseCode!=200",
            "limit": 10000,
            "metrics": [
                "requests",
                "readKiB"
            ],
            "since": "2019-01-02T02:20:00Z",
            "sort": [
                "+requests",
                "-responseCode"
            ],
            "until": "2019-01-02T03:20:00Z"
        },
        "rows": 2,
        "totals": {
            "readKiB": 48,
            "requests": 6
        }
    },
    "success": true
}

🟢200Query Request Analytics response failure

Query Request Analytics

Request

Request samples

Responses