rippled/docker/telemetry/workload/expected_spans.json

{
  "description": "Expected span inventory for rippled telemetry validation. Sourced from 09-data-collection-reference.md.",
  "spans": [
    {
      "name": "rpc.request",
      "category": "rpc",
      "parent": null,
      "required_attributes": [],
      "config_flag": "trace_rpc"
    },
    {
      "name": "rpc.process",
      "category": "rpc",
      "parent": "rpc.request",
      "required_attributes": [],
      "config_flag": "trace_rpc"
    },
    {
      "name": "rpc.ws_message",
      "category": "rpc",
      "parent": null,
      "required_attributes": [],
      "config_flag": "trace_rpc"
    },
    {
      "name": "rpc.command.*",
      "category": "rpc",
      "parent": "rpc.process",
      "required_attributes": [
        "command",
        "version",
        "rpc_role",
        "rpc_status",
        "duration_ms"
      ],
      "config_flag": "trace_rpc",
      "note": "Wildcard — matches rpc.command.server_info, rpc.command.ledger, etc."
    },
    {
      "name": "tx.process",
      "category": "transaction",
      "parent": null,
      "required_attributes": ["xrpl.tx.hash", "local", "path"],
      "config_flag": "trace_transactions"
    },
    {
      "name": "tx.receive",
      "category": "transaction",
      "parent": null,
      "required_attributes": [
        "xrpl.peer.id",
        "xrpl.tx.hash",
        "suppressed",
        "tx_status"
      ],
      "config_flag": "trace_transactions"
    },
    {
      "name": "tx.apply",
      "category": "transaction",
      "parent": "ledger.build",
      "required_attributes": ["xrpl.ledger.seq", "tx_count", "tx_failed"],
      "config_flag": "trace_transactions"
    },
    {
      "name": "consensus.proposal.send",
      "category": "consensus",
      "parent": null,
      "required_attributes": ["xrpl.consensus.round"],
      "config_flag": "trace_consensus"
    },
    {
      "name": "consensus.ledger_close",
      "category": "consensus",
      "parent": null,
      "required_attributes": ["xrpl.ledger.seq", "xrpl.consensus.mode"],
      "config_flag": "trace_consensus"
    },
    {
      "name": "consensus.accept",
      "category": "consensus",
      "parent": null,
      "required_attributes": [
        "proposers",
        "validation_quorum",
        "proposers_validated"
      ],
      "config_flag": "trace_consensus"
    },
    {
      "name": "consensus.validation.send",
      "category": "consensus",
      "parent": null,
      "required_attributes": [
        "xrpl.ledger.seq",
        "proposing",
        "xrpl.ledger.hash",
        "validation_full"
      ],
      "config_flag": "trace_consensus"
    },
    {
      "name": "consensus.accept.apply",
      "category": "consensus",
      "parent": null,
      "required_attributes": [
        "close_time",
        "xrpl.ledger.seq",
        "parent_close_time",
        "close_time_self",
        "close_time_vote_bins",
        "resolution_direction"
      ],
      "config_flag": "trace_consensus"
    },
    {
      "name": "ledger.build",
      "category": "ledger",
      "parent": null,
      "required_attributes": [
        "xrpl.ledger.seq",
        "tx_count",
        "tx_failed",
        "close_time",
        "close_time_correct",
        "close_resolution_ms"
      ],
      "config_flag": "trace_ledger"
    },
    {
      "name": "ledger.validate",
      "category": "ledger",
      "parent": null,
      "required_attributes": ["xrpl.ledger.seq", "validations"],
      "config_flag": "trace_ledger"
    },
    {
      "name": "ledger.store",
      "category": "ledger",
      "parent": null,
      "required_attributes": ["xrpl.ledger.seq"],
      "config_flag": "trace_ledger"
    },
    {
      "name": "peer.proposal.receive",
      "category": "peer",
      "parent": null,
      "required_attributes": ["xrpl.peer.id", "proposal_trusted"],
      "config_flag": "trace_peer"
    },
    {
      "name": "peer.validation.receive",
      "category": "peer",
      "parent": null,
      "required_attributes": [
        "xrpl.peer.id",
        "validation_trusted",
        "xrpl.ledger.hash",
        "validation_full"
      ],
      "config_flag": "trace_peer"
    }
  ],
  "parent_child_relationships": [
    {
      "parent": "rpc.request",
      "child": "rpc.process",
      "description": "RPC request contains processing span",
      "skip": true,
      "skip_reason": "rpc.request and rpc.process run on different threads (onRequest posts a coroutine to JobQueue for processRequest). Span context is not propagated across the thread boundary. Requires C++ fix to capture and forward the span context through the coroutine lambda."
    },
    {
      "parent": "rpc.process",
      "child": "rpc.command.*",
      "description": "Processing span contains per-command span"
    },
    {
      "parent": "ledger.build",
      "child": "tx.apply",
      "description": "Ledger build contains transaction application"
    }
  ],
  "total_span_types": 17,
  "total_unique_attributes": 37
}