Struct TopArgs 

pub struct TopArgs {
    pub metrics_url: Option<String>,
    pub config: Option<PathBuf>,
    pub interval_ms: u64,
    pub json: bool,
    pub timeout_ms: u64,
}

decdn node top — live metrics view (issue #275).

Polls the daemon’s loopback /metrics HTTP endpoint every --interval-ms and redraws a fixed-column table with current gauges, per-second counter deltas, and a derived cache hit-rate. The metrics port is loopback-only by default (observability.metrics_bind = 127.0.0.1); operators who exposed it elsewhere should pass --metrics-url.

Fields

metrics_url: Option<String>

Base URL of the node’s metrics HTTP endpoint, e.g. http://127.0.0.1:9090. Also read from DECDN_METRICS_URL when unset. If still unset, the port is derived from observability.metrics_port in the config file (see --config); the host is always 127.0.0.1 because the metrics endpoint is loopback-only by default.

config: Option<PathBuf>

Path to the TOML config file used to derive the metrics URL when --metrics-url / DECDN_METRICS_URL are unset. Same resolution semantics as decdn node health --config.

interval_ms: u64

Refresh interval in milliseconds. Default 1000 (one Hz, matches the issue title). Values below 100ms are accepted but unlikely to outpace the operator’s terminal redraw budget.

json: bool

Single-shot mode: fetch once, emit the snapshot as pretty JSON, and exit. Useful for scripts or one-off captures. Mutually exclusive with the live redraw loop (which runs forever in plain mode until Ctrl-C).

timeout_ms: u64

HTTP roundtrip timeout in milliseconds for each /metrics scrape. A scrape that times out is logged and the loop continues — the displayed counters keep their last value rather than the table going blank on a single hiccup.

Trait Implementations

impl Args for TopArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Debug for TopArgs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for TopArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.