Chart custom metrics
List your custom series and read their datapoints, in the console's chart or over the API.
Last updated 18 November 2026View as Markdown
Replace series-id with the id the series list returns.
Prerequisites
- Permission for
monitoring:ListMetricsto list the series andmonitoring:GetMetricDatato read their datapoints, both onrn:ews::<organization id>:monitoring:*. - In the console, without
monitoring:ListMetricsCustom metrics shows an access-denied notice; withoutmonitoring:GetMetricDatait lists the series but says "Reading datapoints needs monitoring:GetMetricData."
Read a series
- Open Monitoring, then Custom metrics.
- Choose the namespace.
- In the table, choose the series' metric name; the chart shows it.
- Choose a statistic: Average, Sum, Minimum, Maximum or Sample count.
- Choose a range from 1 hour to 14 days.
dcloud monitoring custom-metrics list --namespace Shop
dcloud monitoring custom-metrics get-data --series-id series-id \
--start 2026-11-10T00:00:00Z --period 300 --statistic sumGET /monitoring/api/custom-metrics?namespace=ShopGET /monitoring/api/custom-metrics/data?seriesId=series-id&start=2026-11-10T00:00:00Z&period=300&statistic=sumResult
The list gives each series' id, namespace, name, dimensions, unit and its last datapoint, up to
200 unless you set limit (at most 1000). The data answer has one { ts, value } per period with
data, and the period it actually used.
Retention and resolution
Minute points are kept 15 days and hourly points 15 months. A read that starts more than 15 days ago, or asks for a period of whole hours, is answered from the hourly points, and its period is rounded up to whole hours. A range may hold at most 1440 periods.
A series is removed with its points once it has had no datapoint for 15 months; you cannot delete it earlier.
Related
Did this page help you?