convex-sentinel

自分のデプロイ環境で本番エラーを収集する

@convex-dev/sentinel をインストールすると、本番エラー（サーバー関数の失敗、クライアント側の JS／React クラッシュ、OCC およびスケールに関するシグナル）を、書き込み時に秘匿化したうえで、ユーザー自身のデプロイ環境内のテーブルに収集し、新しいエラーに対応できます。データがユーザーのデプロイ環境の外に出ることはありません。

ワークフロー

1. コンポーネントをインストールします：app.use(sentinel) を convex/convex.config.ts に追加します。
2. クライアント SDK を接続します：React のエラーバウンダリーに加え、window.onerror／unhandledrejection とパンくずリストを設定します。
3. 秘匿化は書き込み時に実行され、デフォルトで有効です（秘密情報を示すキー名と値のパターンは、デフォルトで拒否されます）。
4. Convex CLI（convex data、run-once-query）で最近のエラーを読み取り、モニターの prod_error イベントを介して新しいエラーに対応します。
5. 必要に応じて自己修復 cron を有効にします：triage が各エラーを分類し、再発する一時的でないエラーを ai-runner に渡して修正 PR を作成します。

ルール

• 秘匿化は必須で、デフォルトで有効です。生の秘密情報は決して保存しないでください。エージェントが読み取った内容はモデルプロバイダーに届きます。
• データはユーザーのデプロイ環境内にとどめてください。第三者に送信しないでください。
• サンプル取得と上限設定で、データ量とコストを抑えてください。
• 本番エラーを収集するには、クラウドアプリがデプロイ済みである必要があります。インストールは匿名で行えます。