BFD_SESSION_TABLE (STATE_DB)¶

概要¶

STATE_DB の BFD_SESSION_TABLE は、sonic-swss の bfdorch が SAI BFD セッションを作成した後に書き込む読み取り専用のセッション状態テーブル¹。設定値（tx_interval 等）とランタイム状態（state）の両方を保持し、SAI からの状態変化通知（bfd_session_state_change）を受信するたびに state フィールドのみ更新される。

use_software_bfd = true（BGP_DEVICE_GLOBAL.STATE.use_software_bfd）のソフトウェア BFD モードでは、SAI を経由しないため BFD_SESSION_TABLE は書き込まれず、代わりに BFD_SOFTWARE_SESSION_TABLE に APPL_DB データが転記される。

CONFIG_DB との関係

BFD の設定は CONFIG_DB の BFD_SESSION テーブルで行う。bfdorch が APPL_DB BFD_SESSION_TABLE を経由して SAI セッションを作成した後、その結果と構成情報を本テーブルに書き戻す。

データフロー¶

flowchart LR
  APPL[("APPL_DB<br/>BFD_SESSION_TABLE")]
  OA["bfdorch<br/>(orchagent)"]
  SAI["SAI BFD API"]
  STATE[("STATE_DB<br/>BFD_SESSION_TABLE")]
  NTFY["SAI 通知<br/>bfd_session_state_change"]
  CONS["消費者<br/>(VNet Orch / BGP)"]

  APPL -->|"doTask()"| OA
  OA -->|"create_bfd_session()"| SAI
  OA -->|"初期書き込み (state=Down)"| STATE
  SAI -->|"state 変化通知"| NTFY
  NTFY -->|"hset state"| STATE
  STATE --> CONS

key 構造¶

BFD_SESSION_TABLE|<vrf>|<interface>|<peer_ip>

<vrf>: VRF 名。デフォルト VRF は "default"
<interface>: 出力インタフェース名。hardware lookup 時は "default"
<peer_ip>: BFD ピアの IP アドレス (IPv4 / IPv6)

key は bfdorch.cpp の get_state_db_key() が APPL_DB キーの | 区切りから生成する。

フィールド一覧¶

フィールド	型	書込み主体	デフォルト	説明
`state`	enum string	`bfdorch` (SAI 通知)	`"Down"`	BFD セッション状態。`"Admin_Down"` / `"Down"` / `"Init"` / `"Up"` のいずれか
`type`	enum string	`bfdorch` (セッション作成)	`"async_active"`	BFD セッション種別。APPL_DB 入力値をそのまま転記
`local_discriminator`	uint32 string	`bfdorch` (セッション作成)	連番 (1–)	bfd_gen_id() で生成した内部識別子
`local_addr`	IP アドレス string	`bfdorch` (セッション作成)	必須	SAI セッションの送信元 IP アドレス
`tx_interval`	uint32 string (ms)	`bfdorch` (セッション作成)	`"1000"`	送信間隔 (ミリ秒)。STATE_DB には ms 値、SAI 投入は ×1000 μs
`rx_interval`	uint32 string (ms)	`bfdorch` (セッション作成)	`"1000"`	最小受信間隔 (ミリ秒)
`multiplier`	uint8 string	`bfdorch` (セッション作成)	`"10"`	検知乗数 (detect multiplier)
`multihop`	boolean string	`bfdorch` (セッション作成)	`"false"`	マルチホップ BFD 有効フラグ。常に `"true"` または `"false"` が書かれる

`state` フィールド詳細¶

書き込みトリガーと状態遷移¶

bfdorch は以下の 2 タイミングで state を STATE_DB に書き込む:

セッション作成直後 (create_bfd_session() 完了後) — state = "Down" で固定書き込み (bfdorch.cpp:544,565)
SAI 通知受信時 (doTask(NotificationConsumer)) — SAI からの bfd_session_state_change 通知が届くたびに hset(key, "state", ...) で更新 (bfdorch.cpp:252)

取り得る値¶

値	SAI 対応状態	意味
`"Admin_Down"`	`SAI_BFD_SESSION_STATE_ADMIN_DOWN`	管理的に Down に設定
`"Down"`	`SAI_BFD_SESSION_STATE_DOWN`	セッション Down（初期値・ピア未検出）
`"Init"`	`SAI_BFD_SESSION_STATE_INIT`	セッション確立中
`"Up"`	`SAI_BFD_SESSION_STATE_UP`	セッション確立済み（正常動作）

`local_discriminator` フィールド詳細¶

bfd_gen_id() が static uint32_t を 1 から順にインクリメントして返す:

// bfdorch.cpp:641-645
static uint32_t session_id = 1;
return (session_id++);

orchagent プロセス内でのセッション作成順序に依存する連番。orchagent 再起動でリセットされる。

STATE_DB に書き込まれないフィールド¶

以下の APPL_DB / CONFIG_DB フィールドは STATE_DB BFD_SESSION_TABLE に書き込まれない:

フィールド	理由
`tos`	SAI 属性 `SAI_BFD_SESSION_ATTR_TOS` にのみ反映。`fvVector` に追加しない (`bfdorch.cpp:466-468`)
`dst_mac`	SAI 属性としてのみ使用
`shutdown_bfd_during_tsa`	`create_bfd_session()` 内で `continue` (無視)。doTask() の呼び出し元で処理済み

ソフトウェア BFD モード (`BFD_SOFTWARE_SESSION_TABLE`)¶

use_software_bfd = true の場合、bfdorch は SAI を呼ばず BFD_SOFTWARE_SESSION_TABLE に APPL_DB データを転記する:

// bfdorch.cpp:706-710
void BfdOrch::createSoftwareBfdSession(const string &key, const vector<swss::FieldValueTuple>& data)
{
    m_stateSoftBfdSessionTable->set(createStateDBKey(key), data);
}

この場合は state フィールドが含まれず、bgpcfgd の BfdMgr が FRR に vtysh 経由で設定を注入し、FRR 側で状態管理する。

購読者 (consumer)¶

プロセス	参照	用途
`vnetorch`	`STATE_DB BFD_SESSION_TABLE` → `state`	VNET の BFD 監視。BFD Up/Down でルート切替
`BfdMonitorOrch`	`STATE_DB BFD_SESSION_TABLE`	BFD 状態のオーケストレーション監視
`show bfd peers` (sonic-utilities)	`STATE_DB BFD_SESSION_TABLE`	セッション状態の表示

値依存挙動マトリクス¶

`state` (enum string)¶

値	SAI 通知	bfd_session_lookup 更新	VNet 連動
`"Down"` (初期)	セッション作成直後に固定書込み	`SAI_BFD_SESSION_STATE_DOWN`	Down 通知
`"Down"` (SAI 通知)	SAI_BFD_SESSION_STATE_DOWN	更新	Down 通知
`"Init"`	SAI_BFD_SESSION_STATE_INIT	更新	—
`"Up"`	SAI_BFD_SESSION_STATE_UP	更新	Up 通知
`"Admin_Down"`	SAI_BFD_SESSION_STATE_ADMIN_DOWN	更新	Down 通知

TSA 有効時の挙動¶

TSA (Traffic Shift Away) が有効かつ shutdown_bfd_during_tsa = "true" のセッションは、handleTsaStateChange(true) で notify_session_state_down() が呼ばれた後 remove_bfd_session() で STATE_DB エントリが削除される。TSA 解除時は再作成される (bfdorch.cpp:683-704)。

フィールド暗黙デフォルト (Phase A — コード由来)¶

YANG schema が存在しないため、すべてのデフォルトはコード (bfdorch.cpp) の変数初期化またはマクロ定義から由来する。

フィールド	コード由来デフォルト	fallback 源
`state`	`"Down"`	`session_state_lookup.at(SAI_BFD_SESSION_STATE_DOWN)` — `bfdorch.cpp:544` にて create 直後に固定書込み
`type`	`"async_active"`	`SAI_BFD_SESSION_TYPE_ASYNC_ACTIVE` — `bfdorch.cpp:340` の C++ 変数初期化
`local_discriminator`	連番 (1 から開始)	`bfd_gen_id()` — `bfdorch.cpp:641-645` の static 変数インクリメント
`local_addr`	必須 (省略不可)	`src_ip_provided == false` → エラーログ + STATE_DB 書込みなし — `bfdorch.cpp:409-413`
`tx_interval`	`"1000"` (ms)	`BFD_SESSION_DEFAULT_TX_INTERVAL 1000` — `bfdorch.cpp:15,343`
`rx_interval`	`"1000"` (ms)	`BFD_SESSION_DEFAULT_RX_INTERVAL 1000` — `bfdorch.cpp:16,344`
`multiplier`	`"10"`	`BFD_SESSION_DEFAULT_DETECT_MULTIPLIER 10` — `bfdorch.cpp:17,345`
`multihop`	`"false"`	`bool multihop = false` — `bfdorch.cpp:347`。STATE_DB には常に文字列 `"true"` / `"false"`

補足¶

state は セッション作成直後は常に "Down"。SAI からの Up 通知を受け取って初めて "Up" になる。
local_discriminator は orchagent 再起動でリセットされる。分散環境では同一セッションキーに対して再起動のたびに異なる値が入る。
tos は APPL_DB → SAI への変換専用で STATE_DB には書かれない。STATE_DB から TOS 値を読み出すことはできない。
BFD_SESSION_TABLE に対応する YANG schema は現時点 (2026-05) で存在しない。すべての制約はコードレベルで実施される。

例外条件・特殊挙動¶

条件	挙動
`local_addr` 未指定	STATE_DB に書き込まれない。`"Failed to create BFD session ... because source IP is not provided"` を SWSS_LOG_ERROR 出力
`interface != "default"` かつ `dst_mac` 未指定	セッション作成失敗。STATE_DB に書き込まれない
`use_software_bfd == true`	`BFD_SESSION_TABLE` ではなく `BFD_SOFTWARE_SESSION_TABLE` に書き込む。`state` フィールドなし
orchagent 起動時	既存の `BFD_SESSION_TABLE` エントリをすべて削除（クリーンアップ）してから再作成 (`bfdorch.cpp:74-79`)
TSA 有効 + `shutdown_bfd_during_tsa == "true"`	`notify_session_state_down()` 後に STATE_DB エントリ削除
SAI セッション作成失敗	`sai_bfd_api->create_bfd_session()` 失敗時は STATE_DB に書き込まれない

引用元¶

運用ヒント¶

STATE_DB 確認コマンド¶

# BFD セッション一覧
sonic-db-cli STATE_DB keys 'BFD_SESSION_TABLE|*'

# 特定セッションの全フィールド確認
sonic-db-cli STATE_DB hgetall 'BFD_SESSION_TABLE|default|default|10.0.0.1'

# state フィールドのみ確認
sonic-db-cli STATE_DB hget 'BFD_SESSION_TABLE|default|default|10.0.0.1' state

# CLI からの確認
show bfd peers
show bfd peers 10.0.0.1
show bfd peers details

よくある確認ポイント¶

state が "Down" のまま変化しない場合は SAI / ASIC の BFD offload 対応を確認
local_discriminator がセッションごとに異なる値になることは正常動作
orchagent 再起動後は全セッションが "Down" から再開する（クリーンアップ後再作成）

sonic-swss/orchagent/bfdorch.cpp (L49-55 session_state_lookup, L57-88 constructor/cleanup, L220-268 SAI 通知受信/hset, L305-575 create_bfd_session/fvVector 書込み, L564-567 STATE_DB set). https://github.com/sonic-net/sonic-swss/blob/master/orchagent/bfdorch.cpp ↩

BFD_SESSION_TABLE (STATE_DB)¶

概要¶

データフロー¶

key 構造¶

フィールド一覧¶

`state` フィールド詳細¶

書き込みトリガーと状態遷移¶

取り得る値¶

`local_discriminator` フィールド詳細¶

STATE_DB に書き込まれないフィールド¶

ソフトウェア BFD モード (`BFD_SOFTWARE_SESSION_TABLE`)¶

購読者 (consumer)¶

値依存挙動マトリクス¶

`state` (enum string)¶

TSA 有効時の挙動¶

フィールド暗黙デフォルト (Phase A — コード由来)¶

補足¶

例外条件・特殊挙動¶

関連リファレンス¶

関連リファレンス¶

引用元¶

運用ヒント¶

STATE_DB 確認コマンド¶

よくある確認ポイント¶

BFD_SESSION_TABLE (STATE_DB)¶

概要¶

データフロー¶

key 構造¶

フィールド一覧¶

state フィールド詳細¶

書き込みトリガーと状態遷移¶

取り得る値¶

local_discriminator フィールド詳細¶

STATE_DB に書き込まれないフィールド¶

ソフトウェア BFD モード (BFD_SOFTWARE_SESSION_TABLE)¶

購読者 (consumer)¶

値依存挙動マトリクス¶

state (enum string)¶

TSA 有効時の挙動¶

フィールド暗黙デフォルト (Phase A — コード由来)¶

補足¶

例外条件・特殊挙動¶

関連リファレンス¶

関連リファレンス¶

引用元¶

運用ヒント¶

STATE_DB 確認コマンド¶

よくある確認ポイント¶

`state` フィールド詳細¶

`local_discriminator` フィールド詳細¶

ソフトウェア BFD モード (`BFD_SOFTWARE_SESSION_TABLE`)¶

`state` (enum string)¶