clear (sonic-clear) コマンド¶

概要¶

実行ファイル名は sonic-clear だが click のエントリ名は cli（/usr/local/bin/sonic-clear 経由で呼ばれる）。カウンタ系のリセット、ARP/NDP テーブルのフラッシュ、FDB クリア、NAT 統計クリア、PBH カウンタ保存、route flow counter リセット、ASIC/SDK health-event 消去などをまとめている¹。

ほとんどのコマンドが portstat / intfstat / queuestat / pfcstat / dropstat / tunnelstat / srv6stat / switchstat / watermarkstat / wredstat / fdbclear / flow_counters_stat / natclear / consutil 等の C++/python ユーティリティを -c (clear) フラグで呼び出すラッパ。

clear/main.py の AliasedGroup は alias 自動補完（例: st → status）と aliases.ini 読み込みを実装している。

コマンドツリー¶

sonic-clear (= clear)
├── arp [<ip>] [-n <ns>]              # IP ARP テーブル全消し or 1 件
├── ndp [<ip>] [-n <ns>]              # IPv6 NDP テーブル
├── ip
│   ├── arp / ndp                     # cli 直下と同じものを再 add
│   └── bgp ...                       # routing_stack=frr 時に動的アタッチ
├── ipv6 bgp ...                      # 同上 v6 側
├── counters                          # portstat -c
├── rifcounters [<intf>]              # intfstat -c
├── queuecounters                     # queuestat -c (--voq も)
├── fabriccountersqueue / fabriccountersport  # fabricstat -C [-q]
├── pfccounters                       # pfcstat -c
├── dropcounters                      # dropstat -c clear
├── tunnelcounters                    # tunnelstat -c
├── srv6counters                      # srv6stat -c
├── switchcounters                    # switchstat -c
├── priority-group
│   ├── watermark headroom / shared
│   ├── persistent-watermark headroom / shared
│   └── drop counters
├── queue
│   ├── wredcounters                  # wredstat -c
│   ├── watermark unicast / multicast / all
│   └── persistent-watermark unicast / multicast / all
├── headroom-pool
│   ├── watermark
│   └── persistent-watermark
├── fdb all                           # fdbclear (port/vlan は実装コメントアウト)
├── line <target> [-d|--devicename]   # consutil clear
├── nat statistics / nat translations # natclear -s / -t
├── pbh statistics                    # PBH_RULE 集約 + ファイル書き出し
├── flowcnt-trap                      # flow_counters_stat -c -t trap
├── flowcnt-route [pattern <p>] [route <prefix>]
├── asic-sdk-health-event [-n <ns>]   # STATE_DB ASIC_SDK_HEALTH_EVENT_TABLE* delete
└── spanning-tree                     # clear/stp.py 由来 (BPDU stats / etc)

主要コマンドの詳細¶

`sonic-clear arp [<ipaddress>] [-n <namespace>]`¶

動作:

<ipaddress> 省略時: sudo ip -4 -s -s neigh flush all
<ipaddress> 指定時: ip -4 neigh show <ip> で dev を解析し、ip -4 neigh del <ip> dev <iface> を実行
-n <ns> 指定時は sudo ip netns exec <ns> ip -4 ... の形に書き換え

`sonic-clear ndp [<ipaddress>] [-n <namespace>]`¶

arp と対称。ip -6 系。

`sonic-clear counters`¶

portstat -c を起動。portstat は COUNTERS_DB の各ポートのスナップショットを /tmp/portstat-<uid> 等にコピーする実装で、表示時の差分計算用ベースラインを更新する。

`sonic-clear rifcounters [<interface>]`¶

intfstat -c [-i <interface>]。Routed Interface (L3 SVI / sub-interface) の RX/TX を扱う。

`sonic-clear queuecounters`¶

queuestat -c の後、必ず queuestat -c --voq も実行。Supervisor デバイスでは前者をスキップして VoQ のみリセットする。

`sonic-clear pfccounters` / `dropcounters` / `tunnelcounters` / `srv6counters` / `switchcounters`¶

それぞれ pfcstat -c / dropstat -c clear / tunnelstat -c / srv6stat -c / switchstat -c。

`sonic-clear priority-group watermark <headroom|shared>` / `priority-group persistent-watermark <headroom|shared>`¶

watermarkstat -c [-p] -t pg_headroom|pg_shared [-n <ns>] を起動。-p 付きが persistent。root 権限が必要で、非 root だとサブグループ起動時点で sys.exit("Root privileges are required for this operation") する。

`sonic-clear priority-group drop counters`¶

pg-drop -c clear を起動。同じく root 必須。

`sonic-clear queue wredcounters` / `queue watermark <uni|multi|all>` / `queue persistent-watermark <uni|multi|all>`¶

wredstat -c / watermarkstat -c [-p] -t q_shared_uni|q_shared_multi|q_shared_all。

`sonic-clear headroom-pool watermark` / `headroom-pool persistent-watermark`¶

watermarkstat -c [-p] -t headroom_pool [-n <ns>]。

`sonic-clear fdb all`¶

fdbclear を起動。fdb port / fdb vlan はソースコード上ではコメントアウトされており、現行 master では起動できない仕様（必要なら APPL_DB の FDB_TABLE を直接操作する形になる）²。

`sonic-clear line <target> [-d|--devicename]`¶

consutil clear <target> または consutil clear --devicename <target>。コンソールサーバ機能で他プロセスが掴んでいる line を強制解放する。

`sonic-clear nat statistics` / `nat translations`¶

natclear -s / natclear -t。

`sonic-clear pbh statistics`¶

実装が他と異なり、PBH_RULE を CONFIG_DB から取得 → read_pbh_counters で現在値を読み出し → serialize_pbh_counters で /tmp 系のファイルへ書き出す。「クリア」ではなくスナップショット保存で、表示時の差分計算用ベースラインに使う。

`sonic-clear flowcnt-trap`¶

flow_counters_stat -c -t trap。CoPP trap 名ごとのカウンタをリセット。

`sonic-clear flowcnt-route [pattern <prefix-pattern>] [route <prefix>]`¶

サブコマンド省略時は全 route flow counter をクリア。pattern <pattern> でワイルドカード絞り、route <prefix> で 1 prefix 指定。--vrf で VRF/VNET 指定可能。

`sonic-clear asic-sdk-health-event [-n <namespace>]`¶

CONFIG_DB ではなく STATE_DB の ASIC_SDK_HEALTH_EVENT_TABLE* キーを namespace ごとに delete する。multi-ASIC 時に -n 指定で対象 namespace のみ。

`sonic-clear spanning-tree`¶

clear/stp.py 由来の BPDU 統計クリア / 学習エントリリセット用サブグループ。

ip / ipv6 サブグループ¶

cli.add_command(arp) と ip.add_command(arp) の両方が呼ばれており、sonic-clear arp と sonic-clear ip arp がエイリアス的に同じ機能を提供する（NDP も同様）。BGP セッションリセット系は routing_stack の値に応じて clear/bgp_quagga_v4.py または clear/bgp_frr_v6.py 等が動的に ip.add_command(bgp) / ipv6.add_command(bgp) を実行する。

STATE_DB / CONFIG_DB との接点¶

テーブル	操作	操作するコマンド
STATE_DB `ASIC_SDK_HEALTH_EVENT_TABLE*`	delete	`asic-sdk-health-event`
各 COUNTERS_DB スナップショット	外部ツール経由	`counters` 系全般

それ以外のコマンドは kernel neighbor table や SAI 経由の SDK 状態 を操作するもので CONFIG_DB は触らない。

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

flowchart LR
  CLI["sonic-clear"]
  UT["portstat / fdbclear / natclear<br/>flow_counters_stat / consutil 等 (-c)"]
  APP[("APPL_DB<br/>FDB / NEIGH_FLUSH 等")]
  CNT[("COUNTERS_DB<br/>カウンタ値")]
  CLI --> UT
  UT --> APP
  UT --> CNT

凡例

clear 系 (CLI → ユーティリティ → APPL_DB / COUNTERS_DB) のミニ図。CONFIG_DB を直接介さないコマンドのため手動で記述。

引用元¶

運用ヒント¶

典型的な利用シーン¶

counters / ARP / FDB / BGP セッションの状態をリセットする。
障害解析前のベースラインクリア。

よくある落とし穴¶

sonic-clear counters は累積カウンタを 0 にするのみで、persistent-watermark は別コマンド。
sonic-clear fdb all を本番で打つと一時的に L2 通信が flood に切替わる。

clear (sonic-clear) コマンド¶

概要¶

コマンドツリー¶

主要コマンドの詳細¶

`sonic-clear arp [<ipaddress>] [-n <namespace>]`¶

`sonic-clear ndp [<ipaddress>] [-n <namespace>]`¶

`sonic-clear counters`¶

`sonic-clear rifcounters [<interface>]`¶

`sonic-clear queuecounters`¶

`sonic-clear pfccounters` / `dropcounters` / `tunnelcounters` / `srv6counters` / `switchcounters`¶

`sonic-clear priority-group watermark <headroom|shared>` / `priority-group persistent-watermark <headroom|shared>`¶

`sonic-clear priority-group drop counters`¶

`sonic-clear queue wredcounters` / `queue watermark <uni|multi|all>` / `queue persistent-watermark <uni|multi|all>`¶

`sonic-clear headroom-pool watermark` / `headroom-pool persistent-watermark`¶

`sonic-clear fdb all`¶

`sonic-clear line <target> [-d|--devicename]`¶

`sonic-clear nat statistics` / `nat translations`¶

`sonic-clear pbh statistics`¶

`sonic-clear flowcnt-trap`¶

`sonic-clear flowcnt-route [pattern <prefix-pattern>] [route <prefix>]`¶

`sonic-clear asic-sdk-health-event [-n <namespace>]`¶

`sonic-clear spanning-tree`¶

ip / ipv6 サブグループ¶

STATE_DB / CONFIG_DB との接点¶

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

関連リファレンス¶

引用元¶

運用ヒント¶

典型的な利用シーン¶

よくある落とし穴¶

関連する show / debug¶

clear (sonic-clear) コマンド¶

概要¶

コマンドツリー¶

主要コマンドの詳細¶

sonic-clear arp [<ipaddress>] [-n <namespace>]¶

sonic-clear ndp [<ipaddress>] [-n <namespace>]¶

sonic-clear counters¶

sonic-clear rifcounters [<interface>]¶

sonic-clear queuecounters¶

sonic-clear pfccounters / dropcounters / tunnelcounters / srv6counters / switchcounters¶

sonic-clear priority-group watermark <headroom|shared> / priority-group persistent-watermark <headroom|shared>¶

sonic-clear priority-group drop counters¶

sonic-clear queue wredcounters / queue watermark <uni|multi|all> / queue persistent-watermark <uni|multi|all>¶

sonic-clear headroom-pool watermark / headroom-pool persistent-watermark¶

sonic-clear fdb all¶

sonic-clear line <target> [-d|--devicename]¶

sonic-clear nat statistics / nat translations¶

sonic-clear pbh statistics¶

sonic-clear flowcnt-trap¶

sonic-clear flowcnt-route [pattern <prefix-pattern>] [route <prefix>]¶

sonic-clear asic-sdk-health-event [-n <namespace>]¶

sonic-clear spanning-tree¶

ip / ipv6 サブグループ¶

STATE_DB / CONFIG_DB との接点¶

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

関連リファレンス¶

引用元¶

運用ヒント¶

典型的な利用シーン¶

よくある落とし穴¶

関連する show / debug¶

`sonic-clear arp [<ipaddress>] [-n <namespace>]`¶

`sonic-clear ndp [<ipaddress>] [-n <namespace>]`¶

`sonic-clear counters`¶

`sonic-clear rifcounters [<interface>]`¶

`sonic-clear queuecounters`¶

`sonic-clear pfccounters` / `dropcounters` / `tunnelcounters` / `srv6counters` / `switchcounters`¶

`sonic-clear priority-group watermark <headroom|shared>` / `priority-group persistent-watermark <headroom|shared>`¶

`sonic-clear priority-group drop counters`¶

`sonic-clear queue wredcounters` / `queue watermark <uni|multi|all>` / `queue persistent-watermark <uni|multi|all>`¶

`sonic-clear headroom-pool watermark` / `headroom-pool persistent-watermark`¶

`sonic-clear fdb all`¶

`sonic-clear line <target> [-d|--devicename]`¶

`sonic-clear nat statistics` / `nat translations`¶

`sonic-clear pbh statistics`¶

`sonic-clear flowcnt-trap`¶

`sonic-clear flowcnt-route [pattern <prefix-pattern>] [route <prefix>]`¶

`sonic-clear asic-sdk-health-event [-n <namespace>]`¶

`sonic-clear spanning-tree`¶