show queue サブコマンド¶

概要¶

show queue は queue counter、WRED counter、queue watermark を表示する CLI グループ。counter は queuestat / wredstat、watermark は watermarkstat へ委譲する¹。

コマンド一覧¶

コマンド	用途
`show queue counters [INTERFACE_NAME] [options]`	queue counters を表示
`show queue wredcounters [INTERFACE_NAME] [options]`	WRED counters を表示
`show queue watermark unicast [options]`	unicast queue user watermark
`show queue watermark multicast [options]`	multicast queue user watermark
`show queue watermark all [options]`	全 queue user watermark
`show queue persistent-watermark unicast [options]`	unicast queue persistent watermark
`show queue persistent-watermark multicast [options]`	multicast queue persistent watermark
`show queue persistent-watermark all [options]`	全 queue persistent watermark

counters¶

用法:

show queue counters [INTERFACE_NAME]
    [--namespace <ns>] [--all] [--trim] [--voq]
    [--nonzero] [--json] [--verbose]

実行コマンドは queuestat。interface 指定時は -p <port>、namespace は -n、--all は -a、--trim は -T、--voq は -V、--nonzero は -nz、--json は -j に変換される。

wredcounters¶

用法:

show queue wredcounters [INTERFACE_NAME]
    [--namespace <ns>] [--json] [--voq]
    [--nonzero] [--summary] [--verbose]

実行コマンドは wredstat。--summary は -s、その他は counters と同じ変換。

watermark¶

watermark は watermarkstat -t q_shared_uni|q_shared_multi|q_shared_all を実行する。persistent-watermark はさらに -p を追加する。各 command は --namespace と --json を受け付ける。

引用元¶

実行例¶

典型的な使い方¶

# 例 1: ポート毎のキュー統計
show queue counters

よくある引数の組み合わせ¶

show queue counters Ethernet0
show queue watermark unicast
show queue persistent-watermark multicast

期待される出力 (抜粋)¶

       Port    TxQ    Counter/pkts    Counter/bytes    Drop/pkts    Drop/bytes
-----------  -----  --------------  ---------------  -----------  ------------
  Ethernet0   UC0          123,456       12,345,678            0             0
  Ethernet0   UC1            5,432        4,321,234            0             0

データフロー (手動作成)¶

flowchart LR
  CLI["show queue (counters / wred / watermark)"]
  UT["queuestat / wredstat / watermarkstat"]
  CNT[("COUNTERS_DB<br/>QUEUE_STAT / WRED_STAT<br/>USER_WATERMARK_QUEUE")]
  CLI --> UT
  CNT --> UT

凡例

show 系 (CLI → *stat ← COUNTERS_DB) のミニ図。CONFIG_DB を直接介さないコマンドのため手動で記述。

運用ヒント¶

典型的な利用シーン¶

ポート別 queue 占有・dropped packets の確認。
WRED / ECN マークの効果検証。

よくある落とし穴¶

counter は累積。sonic-clear queuecounters でリセットして観測する。
voq / fabric queue は通常の queue counter とは別系統で表示される。