トラブルシューティング troubleshooting
エクスペリエンスのロールアウトには、Features Workbenchと呼ばれる組み込みの診断ツールが含まれており、特定のユーザーが受け取る機能フラグとその理由を正確に把握するのに役立ちます。 コードで問題を再現することなく、予期しない機能の動作に関するレポートを調査するために使用します。
Features Workbenchへのアクセス access-workbench
機能ワークベンチを開くには、次の手順に従います。
- Experience Rollouts コンソールにログインします。
- 上部メニューから Workbench > End-Users に移動します。
- 「機能」タブを選択します。
ユーザーIDの入力 input-identity
特定のユーザーの機能フラグ評価を検索するには、ワークベンチフォームに次の情報を入力します。
- ID タイプ – 使用している識別子のタイプを選択します。 サポートされているタイプには、電子メール、GUID、訪問者IDなどがあります。 リリースフラグを直接入力して、フラグ値に基づいてユーザーに対して有効になっているリリースを検索することもできます。
- ID値 — ユーザーのIDを入力します。 ID タイプとしてメールを選択する場合は、複数のGUIDを同じメールアドレスに関連付けることができます。 関連するGUIDを切り替えることができるように、GUID ドロップダウンが提供されます。
- 認証ソースの種類 – 統合に適用できる場合は、選択します。
- コンテキスト変数 — オーディエンスルールの評価（国、デバイスタイプなど）に影響を与えるコンテキストキーと値のペアをオプションで提供します。
- チームとアプリケーション – 機能フラグを取得するチームとアプリケーションを選択します。 現在のチームとそのアプリケーションの1つは、デフォルトで事前に選択されています。
フォームに入力したら、機能を取得を選択します。
結果の解釈 interpret-results
結果は、入力したID タイプによって異なります。
電子メールまたはGUID検索 email-guid-lookup
電子メールまたはGUIDでユーザーを検索すると、次の2つのセクションが結果に表示されます。
リリースフラグ
このセクションには、選択したチームとアプリケーションの3つのリストが表示されます。
- 有効 – このユーザーに対して現在アクティブなリリース。
- 無効 – 存在するが、このユーザーに対して有効になっていないリリース。
- 未使用 — リリースがアタッチされていないリリースビット。
現在選択されているチームとアプリケーションに関連付けられているリリースは、各リストの上部に表示されます。
機能フラグとグループ
このセクションには、選択したチームとアプリケーションのすべての機能フラグが、現在ユーザーに対して有効になっていることが一覧表示されます。 各エントリは次を示します。
- 機能フラグのキーと名前
- 機能グループ （フラグが1つに属する場合）
- バリアント（A/B テストが設定されている場合）
- フラグがオーディエンスリンクかどうか
要求/応答を表示を選択して、結果を生成した正確なAPI リクエストと応答を調べることもできます。
自己以外の電子メールまたは非GUID ID non-self-lookup
入力された電子メールが自分のものでない場合、またはGUID以外のID タイプを使用する場合は、機能フラグとグループ セクションのみが表示されます。
リリースフラグ検索 release-flag-lookup
ID タイプとして リリースフラグ を入力すると、リリースフラグ セクションのみが表示され、そのフラグに関連付けられたユーザーに対して有効および無効になったリリースが一覧表示されます。
一般的な問題 common-issues
次の表に、一般的な問題と、ワークベンチを使用して調査する方法を示します。