mirror of
https://github.com/XRPLF/rippled.git
synced 2026-07-29 01:50:43 +00:00
68b1aa2254
Add an Alloy-based collector config as an alternative to the reference OpenTelemetry Collector. It forwards xrpld OTLP traces and native metrics to the Grafana Cloud OTLP gateway and, critically, runs a spanmetrics connector so span-derived RED metrics (span_calls_total, span_duration_milliseconds_*) are produced. Those metrics are not emitted by xrpld; they are derived from spans, so an Alloy node without this connector is missing from every span-based dashboard. All credentials, endpoints, usernames and the per-node host label are read from the environment (no secrets in the file). Adds a matching .env.grafanacloud-alloy.example and gitignore exception, and the otelcol term to the cspell dictionary. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
28 lines
1.2 KiB
Plaintext
28 lines
1.2 KiB
Plaintext
# Grafana Alloy -> Grafana Cloud credentials for docker/telemetry/alloy/config.alloy.
|
|
# Copy to `.env.grafanacloud-alloy`, fill in, and source before starting Alloy.
|
|
# `.env.grafanacloud-alloy` is gitignored; never commit real tokens or stack ids.
|
|
#
|
|
# Prometheus values: Grafana Cloud -> Connections -> "Prometheus".
|
|
# OTLP values: Grafana Cloud -> Connections -> "OpenTelemetry (OTLP)".
|
|
|
|
# --- Host / systemd metrics (prometheus.remote_write) ---
|
|
# remote_write push URL, e.g. https://prometheus-prod-XX-<region>.grafana.net/api/prom/push
|
|
GRAFANACLOUD_PROM_URL=
|
|
# Numeric instance/stack id (Basic-auth username).
|
|
GRAFANACLOUD_PROM_USER=
|
|
# Access-policy token with metrics:write (Basic-auth password).
|
|
GRAFANACLOUD_PROM_KEY=
|
|
|
|
# --- xrpld OTLP (otelcol.exporter.otlphttp) ---
|
|
# OTLP/HTTP gateway URL including the /otlp path,
|
|
# e.g. https://otlp-gateway-prod-<region>.grafana.net/otlp
|
|
GRAFANACLOUD_OTLP_URL=
|
|
# Numeric instance/stack id (Basic-auth username).
|
|
GRAFANACLOUD_OTLP_USER=
|
|
# Access-policy token with metrics:write + traces:write (Basic-auth password).
|
|
GRAFANACLOUD_OTLP_KEY=
|
|
|
|
# --- Per-node label ---
|
|
# host label applied to this node's scraped metrics (e.g. the node's hostname).
|
|
XRPLD_HOST_LABEL=
|