mirror of
https://github.com/XRPLF/rippled.git
synced 2026-06-02 16:26:48 +00:00
592e546f82
Phase 10's workload validation configs (expected_metrics.json,
regression-metrics.json, validate_telemetry.py) queried the
MetricsRegistry metrics under the rippled_ prefix, but MetricsRegistry
emits them as xrpld_ (see MetricsRegistry.cpp). On a live run the
workload validator reported every MetricsRegistry metric as missing,
masking genuine regressions.
Rename the following to xrpld_ across the workload validator,
expected-metrics manifest, and regression-metrics template:
- nodestore_state, cache_metrics, txq_metrics, load_factor_metrics,
object_count
- rpc_method_started_total / _finished_total / _errored_total /
_duration_us
- job_queued_total / _started_total / _finished_total /
_queued_duration_us_bucket / _running_duration_us_bucket
- peer_quality, server_info, validator_health, ledger_economy,
db_metrics, complete_ledgers, build_info, state_tracking,
storage_detail
- ledgers_closed_total, validations_sent_total,
validations_checked_total, state_changes_total
- validation_agreement, validation_agreements_total,
validation_missed_total
Mirrors the phase-9 fix in commit 5601615952.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
140 lines
5.1 KiB
JSON
140 lines
5.1 KiB
JSON
{
|
|
"description": "Expected metric inventory for rippled telemetry validation. Sourced from 09-data-collection-reference.md.",
|
|
"spanmetrics": {
|
|
"description": "SpanMetrics-derived RED metrics from the OTel Collector spanmetrics connector.",
|
|
"metrics": [
|
|
"traces_span_metrics_calls_total",
|
|
"traces_span_metrics_duration_milliseconds_bucket",
|
|
"traces_span_metrics_duration_milliseconds_count",
|
|
"traces_span_metrics_duration_milliseconds_sum"
|
|
],
|
|
"required_labels": [
|
|
"span_name",
|
|
"status_code",
|
|
"service_name",
|
|
"span_kind"
|
|
],
|
|
"dimension_labels": [
|
|
"xrpl_rpc_command",
|
|
"xrpl_rpc_status",
|
|
"xrpl_consensus_mode",
|
|
"xrpl_tx_local",
|
|
"xrpl_peer_proposal_trusted",
|
|
"xrpl_peer_validation_trusted"
|
|
]
|
|
},
|
|
"statsd_gauges": {
|
|
"description": "beast::insight gauges emitted via StatsD UDP.",
|
|
"metrics": [
|
|
"rippled_LedgerMaster_Validated_Ledger_Age",
|
|
"rippled_LedgerMaster_Published_Ledger_Age",
|
|
"rippled_State_Accounting_Full_duration",
|
|
"rippled_Peer_Finder_Active_Inbound_Peers",
|
|
"rippled_Peer_Finder_Active_Outbound_Peers",
|
|
"rippled_jobq_job_count"
|
|
]
|
|
},
|
|
"statsd_counters": {
|
|
"description": "beast::insight counters emitted via StatsD UDP. The OTel Prometheus exporter appends _total to monotonic counters.",
|
|
"metrics": ["rippled_rpc_requests_total", "rippled_ledger_fetches_total"]
|
|
},
|
|
"statsd_histograms": {
|
|
"description": "beast::insight timers/histograms emitted via StatsD UDP.",
|
|
"metrics": ["rippled_rpc_time", "rippled_rpc_size"]
|
|
},
|
|
"overlay_traffic": {
|
|
"description": "Overlay traffic metrics (subset — full list has 45+ categories).",
|
|
"metrics": [
|
|
"rippled_total_Bytes_In",
|
|
"rippled_total_Bytes_Out",
|
|
"rippled_total_Messages_In",
|
|
"rippled_total_Messages_Out"
|
|
]
|
|
},
|
|
"phase9_nodestore": {
|
|
"description": "Phase 9 NodeStore I/O observable gauge (MetricsRegistry via OTLP). Single metric with 'metric' label distinguishing sub-metrics.",
|
|
"metrics": ["xrpld_nodestore_state"]
|
|
},
|
|
"phase9_cache": {
|
|
"description": "Phase 9 cache hit rate observable gauge (MetricsRegistry via OTLP). Single metric with 'metric' label.",
|
|
"metrics": ["xrpld_cache_metrics"]
|
|
},
|
|
"phase9_txq": {
|
|
"description": "Phase 9 transaction queue observable gauge (MetricsRegistry via OTLP). Single metric with 'metric' label.",
|
|
"metrics": ["xrpld_txq_metrics"]
|
|
},
|
|
"phase9_rpc_method": {
|
|
"description": "Phase 9 per-RPC-method counters (MetricsRegistry via OTLP).",
|
|
"metrics": ["xrpld_rpc_method_started_total"]
|
|
},
|
|
"phase9_objects": {
|
|
"description": "Phase 9 counted object instances observable gauge (MetricsRegistry via OTLP).",
|
|
"metrics": ["xrpld_object_count"]
|
|
},
|
|
"phase9_load": {
|
|
"description": "Phase 9 fee escalation and load factor observable gauge (MetricsRegistry via OTLP).",
|
|
"metrics": ["xrpld_load_factor_metrics"]
|
|
},
|
|
"parity_validation_agreement": {
|
|
"description": "External dashboard parity: validation agreement percentages (push_metrics.py).",
|
|
"metrics": [
|
|
"xrpld_validation_agreement{metric=\"agreement_pct_1h\"}",
|
|
"xrpld_validation_agreement{metric=\"agreement_pct_24h\"}"
|
|
]
|
|
},
|
|
"parity_validator_health": {
|
|
"description": "External dashboard parity: validator health indicators (push_metrics.py).",
|
|
"metrics": [
|
|
"xrpld_validator_health{metric=\"amendment_blocked\"}",
|
|
"xrpld_validator_health{metric=\"unl_expiry_days\"}"
|
|
]
|
|
},
|
|
"parity_peer_quality": {
|
|
"description": "External dashboard parity: peer quality metrics (push_metrics.py).",
|
|
"metrics": [
|
|
"xrpld_peer_quality{metric=\"peer_latency_p90_ms\"}",
|
|
"xrpld_peer_quality{metric=\"peers_insane_count\"}"
|
|
]
|
|
},
|
|
"parity_ledger_economy": {
|
|
"description": "External dashboard parity: ledger economy metrics (push_metrics.py).",
|
|
"metrics": [
|
|
"xrpld_ledger_economy{metric=\"base_fee_xrp\"}",
|
|
"xrpld_ledger_economy{metric=\"transaction_rate\"}"
|
|
]
|
|
},
|
|
"parity_state_tracking": {
|
|
"description": "External dashboard parity: server state tracking (push_metrics.py).",
|
|
"metrics": ["xrpld_state_tracking{metric=\"state_value\"}"]
|
|
},
|
|
"parity_counters": {
|
|
"description": "External dashboard parity: monotonic counters (push_metrics.py).",
|
|
"metrics": [
|
|
"xrpld_ledgers_closed_total",
|
|
"xrpld_validations_sent_total",
|
|
"xrpld_state_changes_total"
|
|
]
|
|
},
|
|
"parity_storage": {
|
|
"description": "External dashboard parity: storage detail metrics (push_metrics.py).",
|
|
"metrics": ["xrpld_storage_detail{metric=\"nudb_bytes\"}"]
|
|
},
|
|
"grafana_dashboards": {
|
|
"description": "All 13 Grafana dashboards that must render data.",
|
|
"uids": [
|
|
"rippled-rpc-perf",
|
|
"rippled-transactions",
|
|
"rippled-consensus",
|
|
"rippled-ledger-ops",
|
|
"rippled-peer-net",
|
|
"rippled-system-node-health",
|
|
"rippled-system-network",
|
|
"rippled-system-rpc",
|
|
"rippled-system-overlay-detail",
|
|
"rippled-system-ledger-sync",
|
|
"rippled-validator-health",
|
|
"rippled-peer-quality"
|
|
]
|
|
}
|
|
}
|