Accepts Prometheus and VictoriaMetrics remote_write version 1 requests, which are snappy-compressed protobuf. The call requires streams.write and answers 204 on success.
A request is written to the metrics stream named by the stream-name header, default when the header is absent. A metrics stream holds the metrics of one source. The __name__ label becomes the metric_name field, the remaining labels become fields, and the sample becomes the value field. A label named like a metric field, such as metric_name or metric_kind, is kept as exported_<name>. Native histograms and metric metadata are skipped, and exemplars are stored beside the samples.
Query the metrics with PromQL by their names, whichever stream holds them. A series of http_requests_total with the labels service and status becomes:
Limits apply per series and per organization: at most 64 labels per series, label names up to 128 bytes, label values up to 2048 bytes, and cardinality limits for active and new series. The process limits are [intake.prometheus] in Configuration. The active series of an organization and of one of its metrics are limited by the platform setting Settings → Metric cardinality, read with GET /api/v1/settings/series_limits and set with PUT and the same body, { "max_active_series_per_org": 200000, "max_active_series_per_metric": 100000 }, both with sys.settings.manage in the system scope. The metric limit is at most the organization limit, and both are at most 100,000,000. Last modified on October 26, 2026
