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

# AWS CloudTrail ログを使用した Amazon Kendra API コールのログ記録
<a name="cloudtrail"></a>

Amazon Kendra は AWS CloudTrail、Amazon Kendra のユーザー、ロール、または のサービスによって実行されたアクションを記録する AWS サービスである と統合されています。CloudTrail は、Amazon Kendra コンソールからの呼び出しと Amazon Kendra API へのコード呼び出しからの呼び出しを含む、Amazon Kendra からのすべての API コールをイベントとしてキャプチャします。追跡を作成する場合は、Amazon Kendra のイベントなど、Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にできます。証跡を設定しない場合でも、CloudTrail コンソールの **[イベント履歴]** で最新のイベントを表示できます。CloudTrail で収集された情報を使用して、Amazon Kendra に対するリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時などの詳細を確認できます。

設定や有効化の方法など、CloudTrail の詳細については、「[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)」を参照してください。

## CloudTrail 内の Amazon Kendra 情報
<a name="kendra-info-in-cloudtrail"></a>

CloudTrail は、 AWS アカウントの作成時にアカウントでアクティブ化されます。Amazon Kendra でアクティビティが発生すると、そのアクティビティは CloudTrail **[Event history]** (イベント履歴) の他の AWS サービスイベントと共に CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)を参照してください。

Amazon Kendra のイベントなど、 AWS アカウント内のイベントの継続的な記録については、証跡を作成します。[証跡] は、指定された S3 バケットに CloudTrail がイベントをログファイルとして配信できるようにする設定です。**デフォルトでは、コンソールで証跡を作成すると、すべての AWS リージョンに証跡が適用されます。証跡は、 AWS パーティション内のすべてのリージョンからのイベントをログに記録し、指定した S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については、以下を参照してください。
+ [証跡を作成するための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail がサポートするサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail 用 Amazon SNS 通知の構成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

CloudTrail では、[API リファレンス](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Reference.html)で文書化されているすべての Amazon Kendra アクションがログに記録されます。たとえば `CreateIndex`、`CreateDataSource`、および `Query` の各オペレーションへのコールは、CloudTrail ログファイル内にエントリを生成します。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。詳細については、[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)を参照してください。

## 例: Amazon Kendra ログファイルのエントリ
<a name="cloud-trail-log-entry"></a>

[証跡] は、指定された S3 バケットにイベントをログファイルとして配信できるようにする設定です。**CloudTrail のログファイルは、単一か複数のログエントリを含みます。*イベント*は、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API 呼び出しの順序付けられたスタックトレースではないため、特定の順序では表示されません。

`Query` 演算を呼び出すと、以下のエントリが作成されます。

```
        {
            "eventVersion": "1.05",
            "userIdentity": {
                "type": "{{AssumedRole | FederatedUser | IAMUser | Root | SAMLUser | WebIdentityUser}}",
                "principalId": "{{principal ID}}",
                "arn": "{{ARN}}",
                "accountId": "{{account ID}}",
                "accessKeyId": "{{access key ID}}",
                "sessionContext": {
                    "sessionIssuer": {
                        "type": "Role",
                        "principalId": "{{principal Id}}",
                        "arn": "{{ARN}}",
                        "accountId": "{{account ID}}",
                        "userName": "{{user name}}"
                    },
                    "webIdFederationData": {
                        
                    },
                    "attributes": {
                        "mfaAuthenticated": false,
                        "creationDate": "{{timestamp}}"
                    }
                }
            },
            "eventTime": "{{timestamp}}",
            "eventSource": "kendra.amazonaws.com",
            "eventName": "Query",
            "awsRegion": "{{region}}",
            "sourceIPAddress": "{{source IP address}}",
            "userAgent": "{{user agent}}",
            "requestParameters": {
                "indexId": "{{index ID}}"
            },
            "responseElements": null,
            "requestID": "{{request ID}}",
            "eventID": "{{event ID}}",
            "eventType": "AwsApiCall",
            "recipientAccountId": "{{account ID}}"
        },
```