Metrics API
Contents
GET /api/v1/metric/search?Curl examples:
curl -X GET "https://[email protected]/api/v1/metric/search?pattern=foo.bar.*"
Search for metrics that match the pattern
foo.bar.*curl -X GET "https://[email protected]/api/v1/metric/search?pattern=foo.bar.*&only_updated_after=5h"
Search for metrics that match the pattern
foo.bar.* that only received data points in the last 5 hours.Available Parameters:
- pattern [REQUIRED] Format:
foo.bar.*Metric pattern to search for. - only_updated_after Format:
only_updated_after=1h | ony_updated_after=5hTo limit search results for metrics that only received data points in the last n hours. - only_updated_before Format:
only_updated_before=1mon | only_updated_before=5monTo limit search results for metrics that have not received data points in the lastnmonths. - with_times Format:
with_times=trueTo return the first (“created_at”) and last (“last_updated”) seen timestamp for that metric. - page Format:
page=4 | page=2Return the nth page of results, for searches that return more than the maximum page size (default maximum size: 100).
Response format:
HTTP/1.1 200
Content-Type: application/json
{
"results": ["foo.bar.1", "foo.bar.2"],
"metrics_matched": 2,
"total_metrics": 12345,
"next_page": 2,
}
Response format with
‘&with_times=true’:HTTP/1.1 200
Content-Type: application/json
{
"results": ["foo.bar.1", "foo.bar.2"],
"metrics_matched": 2,
"total_metrics": 12345,
"times": {
"foo.bar.1": {
"created_at": 1234567890,
"last_updated": 1234567890
},
"foo.bar.2": {
"created_at": 1234567890,
"last_updated": 1234567890
}
}
}
Response Parameters:
- results List of metrics that match the specified pattern.
- metrics_matched The number of metrics matched by this pattern.
- total_metrics The total number of metrics on the account.
- next_page If the total returned metrics exceed the page size (default 100), it indicates the next page in the sequence.
- times An array of dictionaries with the filtered metrics as keys containing the “created_at” and “last_updated” timestamps of the metric.
Status Codes:
- 200 - Success
- 400 - Invalid format.
Legacy Parameters:
- not_updated_in Format:
not_updated_in=1y | not_updated_in=5yTo limit search results for metrics that only received data points in the last n hours. This has the same functionality as only_updated_after.
POST /api/v1/metric/deleteCurl example:
curl -d "pattern=foo.bar.*" "https://YOUR[email protected]/api/v1/metric/delete/"
Delete all metrics that match the pattern
foo.bar.*.Status Codes:
Last modified 1mo ago