Error Handling Framework 設定・運用

このページは Error Handling Framework（概要ハブ） の派生で、CLI / ERROR_DB スキーマ / イベント遷移 に絞る。概念は error-handling-framework-in-sonic-concepts.md、内部実装は error-handling-framework-in-sonic-internals.md、制限事項と乖離は error-handling-framework-in-sonic-limitations.md を参照。

現行 master では未実装

本ページに記載した CLI / ERROR_DB は HLD 提案 であり、現行 master では show error-database / sonic-clear error-database ともに未実装。代替手段は error-handling-framework-in-sonic-limitations.md を参照。

1. ERROR_DB スキーマ（HLD 提案）

ERROR_ROUTE_TABLE

ERROR_ROUTE_TABLE|<prefix>
  operation = CREATE | SET | DELETE
  nexthop   = <ip>[, <ip>...]
  intf      = <ifindex csv>
  rc        = <SWSS_RC_*>

ERROR_NEIGH_TABLE

ERROR_NEIGH_TABLE|(INTF_TABLE|VLAN_INTF_TABLE|LAG_INTF_TABLE).name|<prefix>
  operation = CREATE | SET | DELETE
  neigh     = <mac>
  family    = IPv4 | IPv6
  rc        = <SWSS_RC_*>

rc は SWSS_RC_FULL（TABLE_FULL）など SWSS code を文字列で持つ想定。

2. イベント遷移

直前	今回	framework 動作
Create failure	Update failure	エントリ更新 + 通知
Create failure	Delete failure	エントリ削除 + 通知
Create failure	Update success	エントリ削除 + 通知
Create success	Delete failure	エントリ追加 + 通知
Delete failure	Create success	エントリ削除 + 通知

正常完了系はデフォルトで ERROR_DB に書かない。ERR_NOTIFY_POSITIVE_ACK 指定時のみ通知¹。

3. CLI

Command	用途
show error-database [TableName]	現在の失敗エントリ表示
sonic-clear error-database [TableName]	エントリ全削除（OrchAgent は同期削除のみ実施し app 通知はしない）

Router# show error-database route
Route             Nexthop                Operation  Failure
2.2.2.0/24        10.10.10.2             Create     TABLE FULL
192.168.10.12/24  12.12.10.2,11.11.11.2  Update     PARAM

4. Warm boot / scalability

• ERROR_DB は warm boot 越しに永続化されない¹
• scalability への直接影響は無いと記述

関連ページ

• Error Handling Framework（概要ハブ）
• error-handling-framework-in-sonic-concepts.md
• error-handling-framework-in-sonic-internals.md
• error-handling-framework-in-sonic-limitations.md

実装フェーズ境界

Phase 別の実装済 / 未実装 サマリ

本ページは monitor: partially_implemented で、HLD で示された一連の機能 が 段階的に取り込まれている 状態を扱う。フェーズ毎の実装境界を 1 枚の表に集約する (詳細は本ページ上部の diff admonition および discrepancy-index を参照)。

Phase	範囲 (機能 / 段階)	実装済 (master 取り込み済)	未実装 (HLD 提案のみ)
Phase 1 — 基本機能	HLD §概要 / §設計の中核ユースケース	取り込み済 — 本ページの「実装の概観」「実装詳細」節および diff admonition の現状側を参照	— (Phase 1 は実装済)
Phase 2 — 拡張機能	HLD §拡張 / §追加要件 / §周辺統合	一部のみ取り込み済 — 本ページ「実装詳細」の補足参照	未実装 / 未マージ — HLD §未対応箇所、本ページ「制限事項」および diff admonition の差分側に列挙
Phase 3 — 将来拡張	HLD §Future Work / §将来課題	—	未実装 — HLD 提案段階。対応 PR は確認されていない (last_verified 時点)

凡例: 「実装済」=現行 master で動作確認できる範囲 / 「未実装」=HLD には記載があるが対応 PR が未マージまたは設計のみで code が存在しない範囲。

引用元

このページを読んだ後の次アクション

読み手向け

• 本機能を実運用で使う場合: 取り込み済の部分のみ運用可能。欠落部分の利用は不可なので本文「実装との乖離」を確認した上で適用範囲を限定する
• upstream 動向を追う場合: 関連 issue / PR を sonic-net/SONiC で検索（HLD タイトル / CONFIG_DB テーブル名 / Orch クラス名で grep するのが速い）
• 代替手段 / 関連 reference: 本ページの frontmatter related が空のため、Reference 索引 から関連テーブル / CLI / YANG を辿る

本ドキュメントの追跡

• monitor: partially_implemented / last_verified: 2026-05-11
• 次回再裏取りトリガ: quarterly。一覧は discrepancy-index を参照（運用詳細は repo の meta/discrepancy-operations.md）

---

1. sonic-net/SONiC doc/error-handling/error_handling_design_spec.md @ 49bab5b5ff0e924f1ea52b3d9db0dfa4191a7c06 ↩↩