翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# データソースのトラブルシューティング
<a name="troubleshooting-data-sources"></a>

このセクションでは、 Amazon Kendra データソースコネクタを設定および使用する際の一般的な問題を解決するのに役立ちます。

## マイドキュメントにインデックスが作成されませんでした
<a name="troubleshooting-data-sources-not-indexed"></a>

 Amazon Kendra インデックスをデータソースと同期すると、ドキュメントのインデックス作成を妨げる問題が発生する可能性があります。インデックス作成は 2 ステップのプロセスです。まず、データソースは、インデックスを作成する新しいドキュメントと更新されたドキュメントを確認し、インデックスから削除する文書を検出します。次に、ドキュメントレベルで各ドキュメントにアクセスし、インデックスが付けられます。

次のいずれかのステップでエラーが発生する可能性があります。データソースレベルのエラーは、データソースの詳細ページの **[Sync run history]** (実行履歴を同期) セクションのコンソールに報告されます。同期ジョブのステータスは、**[Succeeded]** (成功)、**[Incomplete]** (不完全)、または **[Failed]** (失敗) になります。ジョブ中にインデックス作成され、削除されたドキュメントの数も確認できます。ステータスが **[Failed]** (失敗) の場合、メッセージが **[Details]** (詳細) 列で表示されます。



ドキュメントレベルのエラーは で報告されます Amazon CloudWatch Logs。 CloudWatch コンソールを使用してエラーを確認できます。

ドキュメント同期ステータスレポートを生成するには、「[ドキュメントの同期ステータスレポートを生成したい](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)」を参照してください。

## 同期ジョブが失敗しました
<a name="troubleshooting-data-sources-failed"></a>

同期ジョブは通常、インデックスまたはデータソースの構成エラーがある場合に失敗します。コンソールで、データソースの詳細ページの **[詳細]** 列の **[実行履歴を同期]** セクションにエラーメッセージが表示されます。ドキュメントレベルのエラーは、 Amazon CloudWatch Logsで報告されます。エラーメッセージには、問題点に関する情報が表示されます。問題は通常、インデックスまたはデータソースに適切な IAM アクセス許可がないことです。エラーメッセージには、欠落しているアクセス許可が示されます。受け取る可能性のあるエラーメッセージをいくつか以下に示します。

`Failed to create log group for job. Please make sure that the IAM role provided has sufficient permissions.`

インデックスロールに を使用するアクセス許可がない場合 CloudWatch、データソースは CloudWatch ログを作成できません。このエラーが発生した場合は、インデックスロールにアクセス CloudWatch 許可を追加する必要があります。

`Failed to access Amazon S3 file prefix ({{bucket name}}) while trying to crawl your metadata files. Please make sure the IAM role ({{ARN}}) provided has sufficient permissions. `

 Amazon S3 データソースを使用する場合、 には、ドキュメントを含むバケットへのアクセス許可 Amazon Kendra が必要です。データソース IAM ロール Amazon Kendra にバケットを読み取るアクセス許可を に追加する必要があります。

`The provided IAM role ({{ARN}}) could not be assumed. Please make sure Amazon Kendra is a trusted entity that is allowed to assume the role.`

Amazon Kendra には、インデックスロールとデータソース IAM ロールを引き受けるアクセス許可が必要です。`sts:AssumeRole` アクションの許可を持つロールに信頼ポリシーを追加する必要があります。

がデータソースのインデックスを作成する Amazon Kendra 必要がある IAM ポリシーについては、[IAM 「 ロール](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html)」を参照してください。

ドキュメント同期ステータスレポートを生成するには、「[ドキュメントの同期ステータスレポートを生成したい](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)」を参照してください。

## 同期ジョブが不完全です
<a name="troubleshooting-data-sources-sync-job-incomplete"></a>

通常、ジョブは、データソースレベルのプロセスを完了したが、ドキュメントレベルのプロセス中に何らかのエラーが発生した場合、不完全になります。ジョブが不完全な場合、ドキュメントの一部で正常にインデックスが作成されていない可能性があります。 Amazon S3 データソースの場合、不完全なジョブは通常、次の原因によって引き起こされます。
+ 1 つまたは複数のドキュメントのメタデータが無効だった。
+ インデックス作成のためにドキュメントが送信されたが、少なくとも 1 つのドキュメントが送信されなかった場合。
+ インデックスから削除するドキュメントが送信されたが、少なくとも 1 つのドキュメントが送信されなかった場合。

不完全な同期ジョブのトラブルシューティングを行うには、まず CloudWatch ログを確認します。

1. 詳細列から、**詳細の表示 CloudWatch**を選択します。

1. エラーメッセージを確認して、ドキュメントが失敗した原因を確認します。

ドキュメント同期ステータスレポートを生成するには、「[ドキュメントの同期ステータスレポートを生成したい](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)」を参照してください。

## 同期ジョブは成功しましたが、インデックス付きドキュメントがありません
<a name="troubleshooting-data-sources-succeeded-no-indexed-docs"></a>

場合によっては、インデックス同期ジョブが **[成功]** とマークされていても、想定したときに新しいドキュメントや更新されたドキュメントでインデックスが作成されていないことがあります。考えられる理由は以下のとおりです。
+ `DocumentsSubmittedForIndexingFailed` メトリクスをチェック CloudWatch して、同期に失敗したドキュメントがあるかどうかを確認します。詳細については、 CloudWatch ログを確認してください。
+  Amazon S3 データソースの場合、バケット名またはプレフィックス Amazon Kendra が間違っている可能性があります。 Amazon Kendra 使用しているバケットが、インデックスを作成するドキュメントを含むバケットであることを確認します。
+ 以前のジョブでインデックス作成に失敗したドキュメントのインデックスを再作成する場合、 Amazon Kendra はドキュメントまたは関連するメタデータファイルを変更しない限り、そのドキュメントのインデックスを作成しません。

ドキュメント同期ステータスレポートを生成するには、「[ドキュメントの同期ステータスレポートを生成したい](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)」を参照してください。

## データソースの同期中にファイル形式の問題が発生しました。
<a name="troubleshooting-data-sources-file-format-issues"></a>

データソースへのファイルの追加、またはデータソースの同期中にファイル形式の問題が発生した場合は、使用しているドキュメントタイプで Amazon Kendra がサポートされていることを確認してください。でサポートされているドキュメントタイプのリストについては、[「ドキュメントタイプまたは形式](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) Amazon Kendra 」を参照してください。

プレーンテキストファイルで `BatchPutDocument` API を使用する場合は、`PLAIN_TEXT` をコンテンツタイプとして指定してください。

## ドキュメントの同期履歴レポートを生成したい
<a name="troubleshooting-data-sources-sync-status-manifest"></a>

**[レポートを表示]** を選択して、データソース同期ジョブのドキュメントレベルの同期実行履歴レポートを CloudWatch に表示できます。同期実行履歴レポートには、同期ジョブの各ドキュメントの進行状況とステータスに関する詳細が含まれます。クロール、同期、インデックスの作成の各段階でドキュメントが成功、失敗、スキップのどれになったかがわかります。失敗したドキュメントまたはスキップされたドキュメントに関連するエラーメッセージも表示されます。レポートに進行中の同期ジョブの結果が表示されない場合、ログはまだ使用できる状態になっていない可能性があります。同期プロセス中にイベントが発生するとデータがレポートに出力されるため、後で改めて確認してください。

同期実行履歴レポートにアクセスするには、次のステップを実行します。

1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。

1. 左側のナビゲーションメニューから、**[データ管理]** で **[データソース]** を選択して、データソースを選択します。

1. データソースの概要ページから、下にスクロールして **[同期履歴]** タブを選択します。

1. **[同期実行履歴]** から **[アクション]** を選択します。

1. **[アクション]** から **[レポートの表示]** を選択します。レポートにアクセスできる CloudWatch コンソールにリダイレクトされます。

**注記**  
同期実行履歴は、アタッチされた ACL やメタデータを含め、Amazon Kendra がサポートするすべてのコネクタで、取り込み中にドキュメントのインデックスが正常に作成されたかどうかを記録します。

**Amazon S3 コネクタを使用している場合**

CloudWatch でドキュメントレベルの同期実行履歴レポートを作成することに加えて、Amazon S3 データソース内の各ドキュメントの同期履歴レポートを生成し、 Amazon S3 バケットにコピーできます。このプロセス中、データは AWS KMS キーを使用して暗号化され、ユーザーのみが表示できます。報告されたドキュメントのステータスは、**[失敗]**、**[完了]**、または **[成功 (エラーあり)]** のいずれかになります。Amazon S3 の同期ステータスレポートを生成する前に、次の操作を行う必要があります。
+  Amazon S3 アクセスポリシーに次の Amazon Kendra サービスプリンシパルを追加する
+ へのアクセス許可を持つ Amazon S3 バケットを作成する Amazon Kendra

コンソールを使用して Amazon S3 の同期履歴レポートを生成するには、**[データソースの詳細]** ページの **[同期履歴レポート – *オプション*]** セクションで **[レポートを生成]** オプションを有効にします。次に、 Amazon S3 バケットの場所を入力し、使用可能な設定オプションから選択します。レポート生成を有効にすると、次回の同期からレポートが生成されます。

 Amazon S3 バケットを削除すると、ログデータが失われ、新しい同期レポートを保存する新しいバケットを設定する必要があります。

**注記**  
同期履歴レポートでは、Amazon S3 コネクタがデータを正常にクロールして取り込んだかどうかに関する情報のみが提供されます。

## データソースの同期にはどのくらいの時間がかかりますか?
<a name="troubleshooting-data-sources-sync-time"></a>

ドキュメントの更新がない場合、 Amazon Kendra インデックスの同期時間はドキュメント数に比例して増加します。例えば、更新されていない 1,000 件のドキュメントの同期には約 5 分かかり、更新されていない 2,000 件のドキュメントの同期には約 10 分かかります。ドキュメントが更新されると、更新されたドキュメントの数に応じて同期時間が長くなります。

## データソースの同期にかかる料金はいくらですか?
<a name="troubleshooting-data-sources-sync-charge"></a>

インデックスを同期すると、ウォームアップとアクティブ化によって必要な接続が確立され Amazon EC2 るまでに 2 分かかります。この処理中は課金されません。使用量の計測は、同期ジョブが開始してから開始されます。 Amazon Kendra 料金の詳細については、「 [https://aws.amazon.com/kendra/pricing/](https://aws.amazon.com/kendra/pricing/)」を参照してください。

## Amazon EC2 認可エラーが出ます。
<a name="troubleshooting-data-sources-ec2-error"></a>

Virtual Private Cloud (VPC) データソースの同期中に Amazon EC2 不正なオペレーションエラーが発生した場合、VPC IAM ロールに必要なアクセス許可がない可能性があります。データソースに使用する IAM ロールに、アタッチされたアクセス許可があることを確認してください。詳細については、[「仮想プライベートクラウド IAM ロール](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-vpc)」を参照してください。

## 検索インデックスリンクを使用して Amazon S3 オブジェクトを開くことができない
<a name="troubleshooting-data-unable-to-open-s3-links"></a>

 Amazon Kendra インデックスは、 Amazon S3 データソースがアクセス許可を付与するファイルにのみアクセスできます。たとえば、 は、オブジェクトをパブリックにするか暗号化するかを決定する Amazon S3 アクセス許可を変更 Amazon Kendra できません。 には、 Amazon S3 オブジェクトの署名付きリンクを作成または返すデフォルトのアクセス許可 Amazon Kendra もありません。 Amazon Kendra インデックス内の Amazon S3 オブジェクトの署名付きリンクを有効にする場合は、次の 2 つのオプションがあります。
+ 検索ページに結果を返す前に、ソース URI オブジェクトでインデックスクエリの結果に署名できます。このプロセスの詳細な手順については、「[https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)」を参照してください。
+  Amazon S3 オブジェクトメタデータソース URI を上書きし、 Amazon S3 バケットに接続された CloudFront コンテンツ配信ネットワーク (CDN) を介してサービスを使用可能にすることができます。または、署名付き URL を返してリダイレクトする API Gateway プロキシエンドポイントを使用することもできます。

## 「SSL 証明書ファイル使用時にアクセスが拒否されました」というエラーメッセージが表示されます
<a name="troubleshooting-data-sources-ssl-certificate-access-denied"></a>

データソースで SSL 証明書を使用するときにアクセス拒否エラーが発生した場合は、 IAM ロールに指定された場所で SSL 証明書ファイルにアクセスするアクセス許可があることを確認してください。証明書が AWS KMS キーで暗号化されている場合、 IAM ロールには AWS KMS キーを使用して復号するアクセス許可も必要です。詳細については、「[https://docs.aws.amazon.com/kms/latest/developerguide/control-access.html](https://docs.aws.amazon.com/kms/latest/developerguide/control-access.html)」を参照してください。

## SharePoint データソースを使用すると認可エラーが発生します
<a name="troubleshooting-data-sources-sharepoint-authorization-error"></a>

SharePoint データソースとインデックスの同期中に認可エラーが発生する場合は、SharePoint で自分にサイト管理者ロールが割り当てられていることを確認してください。

## インデックスが Confluence データソースからのドキュメントにクロールされません
<a name="troubleshooting-data-sources-confluence-document-crawling"></a>

同期プロセス中に Amazon Kendra インデックスが Confluence データソースからドキュメントをクロールしていない場合は、Confluence の管理者グループの一部であることを確認します。