コンテンツにスキップ

show buffer_pool / headroom-pool サブコマンド

概要

show buffer_pool および show headroom-pool は QoS バッファプール / ヘッドルームプールの watermark 統計 を表示するためのコマンドグループ。両グループは構造が完全に対称で、それぞれ watermarkstat -t buffer_pool / watermarkstat -t headroom_pool を呼び出す薄いラッパとして実装されている1。CONFIG_DB は読まず、COUNTERS_DB の watermark カウンタを watermarkstat 経由で取得する。

show buffer (= show-buffer.md で扱う buffer_pool 設定の表示) とは別の系統である点に注意。

コマンド一覧

コマンド 用途
show buffer_pool watermark バッファプールのユーザ WM（最後にクリアして以降の最大占有量）
show buffer_pool persistent-watermark バッファプールの persistent WM（電源 OFF まで残る WM）
show headroom-pool watermark ヘッドルームプールのユーザ WM
show headroom-pool persistent-watermark ヘッドルームプールの persistent WM

各コマンドの詳細

show buffer_pool watermark

用法:

show buffer_pool watermark [-n|--namespace <ns>]

動作: watermarkstat -t buffer_pool を実行。namespace 指定があれば -n <ns> を追加。

📋 検証エビデンス: sonic-net/sonic-utilities/show/main.py#L1119-L1132 (sha: 39732bceb8bdefe706518ab40623bbbba6ff33b9)

出典:

sonic-net/sonic-utilities/show/main.py#L1119-L1132 (sha: 39732bceb8bdefe706518ab40623bbbba6ff33b9)

抜粋:

@buffer_pool.command('watermark')
def wm_buffer_pool(namespace):
    command = ['watermarkstat', '-t', 'buffer_pool']
    if namespace is not None:
        command += ['-n', str(namespace)]
    run_command(command)

show buffer_pool persistent-watermark

動作: watermarkstat -p -t buffer_pool を実行。-p で persistent モード（ユーザがクリアできず、再起動まで残る）。

show headroom-pool watermark / persistent-watermark

動作: watermarkstat -t headroom_pool / watermarkstat -p -t headroom_pool を実行。ヘッドルームプール（PFC 用ロスレストラフィックの予約バッファ）専用の WM 集計。

補足

  • watermarkstat は COUNTERS_DB の USER_WATERMARKS / PERSISTENT_WATERMARKS テーブルを読みに行く。WM の更新周期は WATERMARK_TABLE|TELEMETRY_INTERVAL で設定可能（config watermark telemetry interval）
  • WM のクリアは sonic-clear 系のコマンド (sonic-clear queuewatermark、sonic-clear pgheadroom など) で個別に行う
  • persistent WM はクリア不可。電源 OFF まで保持される、いわば「歴代最大値」を保存する仕組み

データフロー (自動生成)

flowchart LR
  CLI["show buffer_pool"]
  CDB0[("CONFIG_DB<br/>BUFFER_POOL")]
  CDB0 --> CLI

凡例

show 系 (CONFIG_DB → CLI) のミニ図。テーブル → daemon 対応は docs/reference/config-db-orch-map.md から機械生成。

関連リファレンス

引用元

関連 CLI コマンド

関連ページ

  1. show/main.py L1116-L1196。group: @cli.group(name='buffer_pool', ...) / @cli.group(name='headroom-pool', ...)。https://github.com/sonic-net/sonic-utilities/blob/39732bceb8bdefe706518ab40623bbbba6ff33b9/show/main.py#L1116 ↩