From b8d9c071e97f31dd45dab52302c1749c037cf2f6 Mon Sep 17 00:00:00 2001
From: Yurii Kravets <30324382+YuriKravetc@users.noreply.github.com>
Date: Thu, 24 Mar 2022 11:53:28 +0200
Subject: [PATCH] Update url-examples (#2358)

* Update url-examples

Add federate example

* Update docs/url-examples.md

Co-authored-by: Aliaksandr Valialkin <valyala@victoriametrics.com>
---
 docs/url-examples.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/url-examples.md b/docs/url-examples.md
index 79faebcbc4..288d515374 100644
--- a/docs/url-examples.md
+++ b/docs/url-examples.md
@@ -397,6 +397,33 @@ Additional information:
 
 * [How to send data from datadog agent](https://docs.victoriametrics.com/#how-to-send-data-from-datadog-agent)
 
+## /federate
+
+**Returns federated metrics**
+
+Single:
+<div class="with-copy" markdown="1">
+
+```bash
+curl -G 'http://localhost:8428/federate?match[]=vm_http_request_errors_total&start=2021-02-22T19:10:30.781Z'
+```
+
+</div>
+
+Cluster:
+<div class="with-copy" markdown="1">
+
+```bash
+curl -G 'http://<vmselect>:8481/select/0/prometheus/federate?match[]=vm_http_request_errors_total&start=2021-02-22T19:10:30.781Z'
+```
+
+</div>
+
+Additional information:
+
+* [Federation](https://docs.victoriametrics.com/#federation)
+* [Prometheus-compatible federation data](https://prometheus.io/docs/prometheus/latest/federation/#configuring-federation)
+
 ## /graphite/metrics/find
 
 **Searches Graphite metrics in VictoriaMetrics**