本文へ移動
Telemetry
ドキュメントを見る
ガイド更新日: 2026年7月28日Telemetry 編集チームと製品チームによるレビュー1 最小読み取り時間

コーディング エージェントでこのドキュメントを使用してください

Claude Code、Codex、Cursor、または別のコーディング エージェント用の集中プロンプト パックを開き、それをここで説明するワークフローに適応させます。

このページの内容
  1. 割り当ての境界を計測する
  2. まず信頼性を比較してください
  3. 展開に関する決定を再現可能にする

SQL による機能ロールアウト分析

プログレッシブ ロールアウトでは、割り当て、リリース、製品の成果、量、観察時間を保存する比較が必要です。これらのフィールドがないと、トラフィック ミックスの変更は機能の低下または改善のように見える可能性があります。

割り当ての境界を計測する

重複排除に必要な場合は、制御された機能フラグ名、ロールアウトまたは制御コホート、アプリケーション リリース、ターミナル ステータス、期間、環境、承認されたアカウントまたはリクエスト ID を記録します。比較ウィンドウに対して割り当てを安定させます。アカウントがコホートを切り替える場合は、すべての履歴イベントに最新の値のラベルを付けるのではなく、移行時間を保存します。

フラグ ペイロード、ターゲティング ルール、顧客属性、リクエスト本文、または生のエラー メッセージを収集しないでください。制御されたエラー カテゴリと制限されたコホート ラベルを使用します。

まず信頼性を比較してください

機能ロールアウト SQL レシピ リクエストをフラグ、コホート、リリースごとにグループ化します。リクエスト数、失敗数、エラー率、平均レイテンシをまとめて保持します。決定論的フィクスチャは、ロールアウト コホートに 1 つの障害があり、平均レイテンシが遅いことを示していますが、そのコントロール コホートには障害がありません。

結果を次の順序で確認します。

  1. 両方のコホートが同じ放出と完了時間枠を観察したことを確認します。
  2. 制御とロールアウトには十分なリクエストが必要です。
  3. エラー率と遅延を比較し、制御されたエラー カテゴリを検査します。
  4. 割り当てとボリュームがサポートしている場合にのみ、プラン、ルート、または地域ごとにセグメント化します。
  5. 書かれたガードレールを使用して、一時停止、続行、または展開を行います。

ビジネスの成果を得るには、信頼性が許容できる場合にのみ、同じ安定した割り当てをアクティベーションまたは収益マイルストーンに追加してください。の 製品ジャーニーガイド は、カウント単位を明示的に保つ方法を示しています。

展開に関する決定を再現可能にする

SQL、ルックバック ウィンドウ、最小サンプル ルール、リリース、およびロールアウトの割合を決定とともに保存します。ダッシュボードでは、対応者が機能の影響と同時のコード変更を区別できるように、割り当ての変更とデプロイメントをマークする必要があります。

使用する API 信頼性レシピ エラー バジェット、リリースの比較、顧客への影響、依存関係のレイテンシーについて。ガードレールには持続的な証拠が必要です。 1 つの少量の障害があれば、自動的に取り消し不能な結論が下されるのではなく、レビューが開始される必要があります。

関連製品の機能

構造化イベント テーブルに対して読み取り専用 DataFusion SQL を実行し、結果を再利用します。

所有権と技術リファレンス

Telemetry 編集チームがこの説明を所有しています。製品チームは動作、例、境界をレビューします。

編集基準を見直す