{
  "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"
    ]
  }
}