ヘルスチェック
ヘルスチェックでは、サンドボックスで使用されているスキーマとIDをスキャンし、AI アシスタントによる調査やトラブルシューティングに使用できる問題の概要を提供します。 将来的には、より多くのオブジェクトをスキャンして、より包括的なレポートを作成できるようになります。
スキーマとIDの設定が不十分な場合、プロファイルの誤った作成、セグメントの選定の失敗、不正確なアクティベーションなど、下流プロセスにおける大きな問題につながります。 これらの問題は検出が困難で、多くの場合、診断には専門知識が必要です。 ヘルスチェックにより、事後対応のトラブルシューティングから、先見的かつ予防的なメンテナンスへとアプローチが移行します。
ヘルスチェックを利用すると、次のことが可能になります。
- 設定の問題を早期に検出：見つからないベストプラクティス、設定ミス、パターンを特定して、パーソナライゼーションやアクティブ化などにおいて非効率な結果をもたらします。
- ガイド付きの修正を受け取る：各問題とその対処方法について明確なガイダンスを受け取ります。
- 継続的に監視：現在、ヘルスチェックは毎日の自動スキャンを実行して、問題が重大なエラーになる前に検出できるようにしています。 今後のリリースでスケジュールが変更される可能性があります。
前提条件 prerequisites
ヘルスチェックにアクセスするには、View Health Checks アクセス制御権限が必要です。 適切な権限を持っていることを確認するには、システム管理者にお問い合わせください。
ヘルスチェックへのアクセス access-health-checks
Experience Platform UIからヘルスチェックにアクセスするには：
- 左側のナビゲーションから「Run and Operate」を選択します。
- Health Checks を選択します。
ヘルスチェックダッシュボードには、最新のスキャン結果の概要が表示されます。
ダッシュボードについて understanding-dashboard
ヘルスチェックダッシュボードには、実装の状態を評価するのに役立つ3つの情報エリアがあります。
評価されたオブジェクト objects-evaluated
Objects evaluated セクションには、スキャンされたスキーマとID名前空間の合計数と、各カテゴリで見つかった問題の数が表示されます。 これにより、サンドボックス内の設定問題の範囲と重大度をすばやく確認できます。
スキャン結果 scan-results
Scan results セクションには、失敗したチェックの数が表示されます。 失敗したチェックは、1つ以上のヘルスチェックで、注意が必要な設定の問題が検出されたことを示します。 のタイムスタンプで完了した最後の日次ヘルススキャンは、最新のスキャンが実行された時点で表示されます。
特定された問題 identified-issues
Identified issues セクションには、ヘルスチェックごとにカードが表示されます。 各カードは次のように表示されます。
- ヘルスチェック名と問題の簡単な説明。
- 見つかった問題の数、または問題が存在しないという確認。
- チェックが合格したか、注意が必要かどうかを示すステータスインジケーター。
任意のカードを選択して、そのヘルスチェックの詳細を確認します。
利用可能なヘルスチェック available-health-checks
ヘルスチェックでは、現在、スキーマとID設定の5つの基本領域を評価しています。 これらのチェックは、プラットフォーム全体で最も影響力のあるデータモデリングの問題をターゲットにしています。
ID フィールドの検証 identity-field-validation
ID フィールドにデータ整合性の最小長と最大長の制約と正規表現パターンルールがあることを確認するためにスキャンします。
Identity Field Validation カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。
- Description: ID フィールドのデータ整合性を確保するために、最小/最大長と正規表現パターン ルールをスキャンします。 影響を受けるスキーマとフィールドのリスト。
- Impact: スキーマのID フィールドの最小値/最大長とパターン検証が設定されていない場合、データの一貫性が損なわれ、データの整合性と品質が損なわれる可能性があります。
- General areas of impact: Identity ServiceのIDの品質が低く、接続に信頼性がありません。
- Experience League Documentation: データモデリングのベストプラクティスへのリンク。
- Affected Schemas：影響を受けるスキーマのリスト。各スキーマには、詳細を表示するためのエクスパンダーと、スキーマを開くためのリンクが含まれています。
説明、影響、影響を受けるスキーマを示す
詳しくは、スキーマのベストプラクティス ドキュメントの「 データ整合性のヒント 」を参照してください。
ID グラフのリンクルール identity-graph-linking-rules
折りたたまれたプロファイルを防ぐために、ID グラフのリンク ルールがサンドボックス用に設定されていることを確認します。
Identity Graph Linking Rules カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。
- Description：折りたたまれたプロファイルを防ぐために、適切なリンク ルールが設定されていることを確認します。 現在のルールステータスとグラフごとの一意のIDが表示されます。
- Impact: ID グラフのリンク ルールが設定されていない場合、特定のデータは、複数の異なるプロファイルを単一のプロファイルに結合しようとすることがあります。 望ましくない結合を防ぐには、ID グラフのリンクルールを通じて提供される設定を使用する必要があります。
- General areas of impact：折りたたまれたまたは結合されたプロファイル。
- Experience League Documentation：詳細については、ID グラフのリンク ルールの概要へのリンクを参照してください。
- Configure linking rules：チェックが失敗すると、ボタンが表示され、パネルから直接リンクルールを設定できます。
説明、影響、およびリンクルールの設定ボタンを表示する
詳細については、ID グラフ リンク ルールの概要および実装ガイド を参照してください。
人物および人以外のID設定 people-non-people-identity
スキーマクラス全体で、人物および人物以外のID タイプの正しい使用を検証します。
People & Non-People Identity Config カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。
- Description: スキーマクラス全体でID タイプの適切な使用を検証します。 誤って設定されたスキーマを一覧表示し、誤った割り当てを強調表示します。
- Impact：人物でないエンティティが人物IDを与えられた場合、プロファイル数が増加し、このデータがルックアップとして無効になります。 個人エンティティに個人ID以外のIDが与えられた場合、そのデータはストリーミングやエッジセグメント化には使用できません。
- General areas of impact：不完全なID グラフ、膨らんだプロファイル数、参照の誤用。
- Affected Schemas：問題のあるスキーマのリスト。 スキーマ行を展開して、設定ミスごとにパス、ID名、スキーマタイプを確認します。 リンクアイコンを使用してスキーマを開きます。
詳しくは、ID タイプのドキュメント および スキーマのベストプラクティス を参照してください。
カスタム ID名前空間の説明 namespace-missing-description
スキャンして、カスタム ID名前空間のメタデータと説明が完了していることを確認します。
Custom Identity Namespace Description カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。
- Description：名前空間のメタデータと説明が完了していることを確認するためにスキャンします。 空の説明フィールドを持つ名前空間と所有者を表示します。
- Impact: カスタム ID名前空間に説明を設定すると、各名前空間の目的のコンテキストが提供されるので、わかりやすくなります。 これにより、チームメンバーや関係者は、各ネームスペースの機能を混乱することなく、すばやく把握できます。
- General areas of impact: デバッグまたは使用の混乱。検証の意図が明確ではありません。
- Experience League Documentation：詳細については、カスタム名前空間を作成するためのリンクを参照してください。
- Affected namespaces：説明が欠落しているカスタム ID名前空間のリスト。 各名前空間の横にあるリンクアイコンを使用して、表示または編集します。
詳しくは、 カスタム名前空間の作成に関するドキュメントを参照してください。
非推奨のID名前空間 deprecated-namespace
クリーンアップ用にマークする必要がある古いID名前空間または未使用のID名前空間を検出します。
Deprecated Identity Namespace カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。
- Description: クリーンアップ用に古いID名前空間または未使用のID名前空間を検出します。 最後に使用したタイムスタンプまたはスキーマ参照を含む、未使用の名前空間を一覧表示します。
- Impact：どのスキーマでも使用されていないID名前空間は、名前に「DEPRECATED」または「DO NOT USE」タグを追加することで、削除するようにマークする必要があります。 ID名前空間の削除は現在サポートされていません。
- General areas of impact：混乱とラベル変更のリスク。
- Experience League Documentation：詳しいドキュメントについては、廃止されたID名前空間へのリンクを参照してください。
- Affected namespaces：古いID名前空間または未使用のID名前空間のリスト。 各名前空間の横にあるリンクアイコンを使用して、表示または管理します。
詳しくは、古い名前空間に関するExperience Cloud ナレッジベースの記事を参照してください。
次の手順 next-steps
ヘルスチェックの結果を確認したら、次のリソースを参照して理解を深めてください。
- 信頼性の高いデータモデルを設計するための スキーマのベストプラクティス について説明します。
- プロファイルの折りたたみを防ぐため、ID グラフ リンク ルール について理解します。
- 名前空間管理のベストプラクティスについては、ID名前空間ドキュメント を確認してください。
- バッチ操作の可視化のためにを含む他の実行および操作ツール Job Schedulesを探します。