added comments and docs

Signed-off-by: Pratik Mankawde <3397372+pratikmankawde@users.noreply.github.com>

docker/telemetry/docker-compose.yml

@@ -1,3 +1,19 @@
+# Docker Compose stack for rippled OpenTelemetry observability.
+#
+# Provides three services for local development:
+#   - otel-collector: receives OTLP traces from rippled, batches and
+#     forwards them to Jaeger. Listens on ports 4317 (gRPC) and 4318 (HTTP).
+#   - jaeger: all-in-one tracing backend with UI on port 16686.
+#   - grafana: dashboards on port 3000, pre-configured with Jaeger datasource.
+#
+# Usage:
+#   docker compose -f docker/telemetry/docker-compose.yml up -d
+#
+# Configure rippled to export traces by adding to xrpld.cfg:
+#   [telemetry]
+#   enabled=1
+#   endpoint=http://localhost:4318/v1/traces
+
 version: "3.8"
 
 services:

docker/telemetry/grafana/provisioning/datasources/jaeger.yaml

@@ -1,3 +1,8 @@
+# Grafana datasource provisioning for the rippled telemetry stack.
+# Auto-configures Jaeger as a trace data source on Grafana startup.
+# Access Grafana at http://localhost:3000, then use Explore -> Jaeger
+# to browse rippled traces.
+
 apiVersion: 1
 
 datasources:

docker/telemetry/otel-collector-config.yaml

@@ -1,3 +1,9 @@
+# OpenTelemetry Collector configuration for rippled development.
+#
+# Pipeline: OTLP receiver -> batch processor -> debug exporter + Jaeger.
+# rippled sends traces via OTLP/HTTP to port 4318. The collector batches
+# them and forwards to Jaeger via OTLP/gRPC on the Docker network.
+
 receivers:
   otlp:
     protocols: