同期レポートとオブザーバビリティ

Amazon Quick を使用すると、すべてのナレッジベースの同期スケジュール、同期アクティビティログ、および詳細な同期レポートを表示できます。ナレッジベースでドキュメントレベルのアクセスコントロール (ACL) が有効になっている場合は、個々のドキュメントのアクセス許可を確認することもできます。

スケジュールとアクティビティを同期する

同期スケジュールとアクティビティを表示するには、ナレッジベースを開き、同期スケジュールタブを選択します。

同期スケジュール

設定された同期頻度とタイミングを表示します。テーブルには、発生 (毎日など）、次にスケジュールされた同期の開始時刻、E メール通知ステータスが表示されます。同期スケジュールを追加または変更できます。同期失敗に関する E メール通知を受信するには、同期失敗時の E メールを有効にします。

同期アクティビティ

過去のすべての同期の履歴ログを表示します。時間枠 (過去 90 日間など) と同期ステータス (すべて、完了、失敗など) でフィルタリングできます。

次の表は、同期アクティビティ列を示しています。

アクティビティ列の同期

列	[Description] (説明)
開始時間	同期が開始された日時。
同期ステータス	同期の結果: Queued (実行待ち）、Completed (すべての項目が処理済み）、Completed with issues (一部の項目がスキップまたは失敗）、または Failed。
時間	同期が完了するまでにかかった時間。
スキャンされた項目の合計	同期中に処理された項目の数。
タイプ	同期がスケジュールされた (自動) か手動 (今すぐ同期ボタンを選択して開始) か。
同期レポート	その実行の詳細同期レポートを開くビューレポートリンク。

ヒント

オンデマンドで同期を開始するには、ナレッジベースの詳細ページで今すぐ同期を選択します。

同期レポートを確認する

特定の同期の詳細な結果を表示するには、ナレッジベースを開き、同期レポートタブを選択します。

同期の選択ドロップダウンを使用して、検査する同期実行を選択します。

概要

概要セクションには、選択した同期の概要が表示されます。次の表に、概要フィールドを示します。

同期レポートの概要フィールド

フィールド	説明
同期ステータス	全体的な結果 (完了、問題ありの完了など）。
同期タイプ	同期がスケジュールされたか手動か。
同期期間	同期の合計経過時間。
同期開始時刻	同期が開始された時刻。
同期終了時刻	同期が終了したとき。

項目の同期

同期項目セクションには、同期中に処理されたすべての項目が次のカテゴリに分類されて表示されます。

使用可能な項目

同期後にナレッジベースに存在し、インデックスが作成された項目:

• 未変更 – インデックス作成済みで、前回の同期以降に変更されていない項目。

• 変更 – 以前にインデックス作成され、更新および再インデックス作成された項目。

• 追加 — 初めてインデックスが作成された新しい項目。

使用できない項目

同期後にナレッジベースで使用できない項目:

• スキップ – 除外された項目 (空のファイル、サポートされていない形式、日付フィルター範囲外の項目など）。

• 失敗 – エラーのために処理できなかった項目。

• 削除済み – ソースから削除された、以前にインデックスが作成された項目。

個々の項目をフィルタリングして検査する

すべての項目タブには、同期中に処理された項目の完全なリストが表示されます。次のフィルターを使用して結果を絞り込むことができます。

項目フィルターを同期する

フィルター	説明
ステータスでフィルタリングする	同期ステータス (追加、変更、未変更、スキップ、失敗、削除など) で項目をフィルタリングします。
エラータイプでフィルタリングする	失敗した項目またはスキップされた項目を特定のエラータイプでフィルタリングします。
項目タイトルでフィルタリングする	特定の項目を名前で検索します。

フィルターを設定したら、フィルターを適用を選択して結果を更新します。

次の表に、同期項目列を示します。

項目列の同期

列	[Description] (説明)
項目のタイトル	ファイル、ページ、または項目の名前。
項目のステータス	この項目の同期ステータス。
エラータイプ	該当する場合、エラーのカテゴリ。
エラーメッセージ	項目が失敗した、またはスキップされた理由の詳細な説明。

レポートのダウンロード

オフライン分析のために完全同期結果をエクスポートするには、同期項目セクションで詳細レポートのダウンロード (.csv) を選択します。CSV ファイルには、ステータス、エラータイプ、エラーメッセージを含むすべての項目が含まれます。

ドキュメントアクセスの確認 (ACL 検証)

ナレッジベースでドキュメントレベルのアクセスコントロール (ACL) が有効になっている場合は、特定のユーザーが特定のドキュメントにアクセスできるかどうかを確認できます。この機能を使用して、ユーザーがアクセスが予想されるドキュメントを表示できない場合のトラブルシューティングや、機密ドキュメントが適切に制限されていることを確認することができます。

注記

ACL 検証は、ACL 管理が有効になっている管理者管理の SharePoint および Google Drive ナレッジベースで使用できます。ドキュメントレベルの ACLs を持つ Amazon S3 ナレッジベースは、この機能に含まれません。ACL 設定ファイルはカスタマー管理であるため、Amazon S3 で直接検証できます。

1. ナレッジベースを開き、同期レポートタブを選択します。

2. 同期項目リストで、項目のアクションメニュー (⋮) を選択します。

3. アクセス詳細の表示を選択します。

アクセスの詳細パネルには、以下が表示されます。

• ドキュメント名、ステータス、および最後に同期されたタイムスタンプ。

• アクセス許可チェッカー – ユーザーの E メールアドレスを入力し、アクセスの確認を選択して、そのユーザーがドキュメントにアクセスできるかどうかを確認します。

• ユーザーとグループのメンバーシップ – ドキュメントにアクセスできるすべてのユーザーとグループを一覧表示します。

次の表に、アクセス許可チェッカーの結果を示します。

アクセス許可チェッカーの結果

結果	意味
ユーザーは にアクセスできます	ユーザーの ID がドキュメントの ACL と一致します。このドキュメントはクイックレスポンスに表示されます。
[user] はこのドキュメントにアクセスできません	ユーザーはドキュメントの ACL にありません。Quick では、このドキュメントは表示されません。
アクセスコントロールリストが見つかりません	このドキュメントの ACL はクロールされませんでした。ACL 管理が有効になっていないか、必要なアクセス許可が正しく設定されていません。

「アクセスコントロールリストが見つかりません」と表示される場合は、次の手順を実行します。

• ナレッジベース設定で ACL 管理が有効になっていることを確認します。

• アプリ登録にデータソースに必要な ACL アクセス許可があることを確認します。

• アクセス許可を修正した後、完全同期を実行します。