diff --git a/OpenTelemetryPlan/09-data-collection-reference.md b/OpenTelemetryPlan/09-data-collection-reference.md index dd197f2986..ae76f5f97f 100644 --- a/OpenTelemetryPlan/09-data-collection-reference.md +++ b/OpenTelemetryPlan/09-data-collection-reference.md @@ -530,7 +530,12 @@ endpoint=http://localhost:4318/v1/metrics prefix=xrpld ``` -Fallback (StatsD): +Fallback (StatsD). `StatsDCollector` is still selected by this value, but the +stack in `docker/telemetry/` no longer receives it: using this path also requires +re-adding the `statsd` receiver to `otel-collector-config.yaml` and uncommenting +port 8125 in `docker-compose.yml`, otherwise the metrics go to a port nothing +listens on. Note also that `StatsDCollector` applies `prefix` to the metric name +while `OTelCollector` does not, so switching transports renames every series. ```ini [insight] @@ -993,7 +998,7 @@ count_over_time({service_name="xrpld"} |= "trace_id=" [5m]) | ------------------------------------------------------------------ | ------------------------------------------------ | -------------------------------------------------------------------- | | `warn` and `drop` metrics use non-standard StatsD `\|m` meter type | Metrics silently dropped by OTel StatsD receiver | Phase 6 Task 6.1 — needs `\|m` → `\|c` change in StatsDCollector.cpp | | `job_count` may not emit in standalone mode | Missing from Prometheus in some test configs | Requires active job queue activity | -| `rpc_requests` depends on `[insight]` config | Zero series if StatsD not configured | Requires `[insight] server=statsd` in xrpld.cfg | +| `rpc_requests` depends on `[insight]` config | Zero series if `[insight]` is absent or unset | Requires `[insight] server=otel` in xrpld.cfg | | Peer tracing enabled by default | `peer.*` spans emit unless `trace_peer=0` | High volume — set `trace_peer=0` to opt out on busy mainnet nodes | --- @@ -1023,8 +1028,8 @@ The telemetry system is designed with privacy in mind: enabled=1 [insight] -server=statsd -address=127.0.0.1:8125 +server=otel +endpoint=http://localhost:4318/v1/metrics prefix=xrpld ``` @@ -1039,8 +1044,8 @@ batch_size=1024 max_queue_size=4096 [insight] -server=statsd -address=otel-collector:8125 +server=otel +endpoint=http://otel-collector:4318/v1/metrics prefix=xrpld ```