fastmon Docs
Analytics

Distribution of one metric

Report an issue

Get histogram distribution for a metric.

Metrics: lcp, fcp, cls, inp, ttfb, tbt, dns_lookup, tcp_connection, etc.

Buckets: Define boundaries as array, e.g., [0, 500, 1000, 2500, 4000] creates buckets: <0, 0-500, 500-1000, 1000-2500, 2500-4000, 4000+

Example for LCP histogram:

{    "time_range": {"from": "2024-01-01", "to": "2024-01-08"},    "metric": "lcp",    "buckets": [0, 500, 1000, 2500, 4000]}

Authorization

bearerAuth
headerAuthorizationBearer <token>

API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.

Path Parameters

org_id*Org Id
Formatuuid

Request Body

application/json
  1. body

Request schema for histogram queries.

time_range*

Time range for the query (required)

metric*Metric

Metric to create histogram for (e.g., lcp, ttfb)

buckets*array<number>

Bucket boundaries (e.g., [0, 500, 1000, 2500, 4000] creates 5 buckets)

Items2 <= items <= 20
filters?

Optional filters

Response Body

Successful Response

application/json
  1. response

Response for histogram queries.

buckets*array<>

Histogram buckets with counts

meta*

Query metadata

request*

The request as the server resolved it

POST
/organizations/{org_id}/analytics/histogram
curl -X POST 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/analytics/histogram' \  -H 'Content-Type: application/json' \  -d '{  "time_range": {    "from": "2019-08-24T14:15:22Z",    "to": "2019-08-24T14:15:22Z"  },  "metric": "string",  "buckets": [    0,    0  ]}'
{  "buckets": [    {      "label": "string",      "min_value": 0,      "max_value": 0,      "count": 0,      "share": 0    }  ],  "meta": {    "execution_time_ms": 0,    "total": 0,    "limit": 0,    "offset": 0,    "has_more": true,    "next_cursor": "string",    "sampling": {      "sampling_rate": 0,      "is_sampled": true,      "estimated_metrics": [        "string"      ]    },    "is_identity_mixed": true,    "sample_count": 0,    "metric": "string"  },  "request": {    "time_range": {      "from": "2019-08-24T14:15:22Z",      "to": "2019-08-24T14:15:22Z"    },    "comparison_time_range": {      "from": "2019-08-24T14:15:22Z",      "to": "2019-08-24T14:15:22Z"    },    "granularity": "minute",    "identity": "stitch",    "window_seconds": 0,    "filters": {}  }}