From fbd95c198d5b2e7e3d80df749cd5c625cd90d6fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Juraci=20Paix=C3=A3o=20Kr=C3=B6hling?= <juraci@kroehling.de>
Date: Thu, 26 Jan 2023 15:36:45 -0300
Subject: [PATCH] Document ability to use config providers inside config
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes #6748

Signed-off-by: Juraci Paixão Kröhling <juraci@kroehling.de>
---
 service/README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/service/README.md b/service/README.md
index 7693201c229..1637db8b122 100644
--- a/service/README.md
+++ b/service/README.md
@@ -11,6 +11,25 @@ Currently, the OpenTelemetry Collector supports the following providers `scheme`
 
 For more technical details about how configuration is resolved you can read the [configuration resolving design](../confmap/README.md#configuration-resolving).
 
+One configuration file can also make references to other config providers, like the following:
+
+```yaml
+receivers:
+  otlp:
+    protocols:
+      grpc:
+
+exporters: ${file:otlp-exporter.yaml}
+
+service:
+  extensions: [ ]
+  pipelines:
+    traces:
+      receivers:  [ otlp ]
+      processors: [  ]
+      exporters:  [ otlp ]
+```
+
 ### Single Config Source
 
 1. Simple local file: