AWS CloudTrail ログを使用した Amazon Lex API コールのモニタリング

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

設定や有効化の方法など、CloudTrail の詳細については、「AWS CloudTrail ユーザーガイド」を参照してください。

CloudTrail 内の Amazon Lex 情報

CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。Amazon Lexでサポートされているイベントアクティビティが発生すると、そのアクティビティは [Event history] (イベント履歴) の他の AWS のサービスのイベントとともに CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、CloudTrail イベント履歴でのイベントの表示を参照してください。

Amazon Lex のイベントなど、 AWS アカウントのイベントの継続的な記録については、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon Simple Storage Service (Amazon S3) バケットに配信できます。デフォルトでは、コンソールで作成した証跡がすべての AWS リージョンに適用されます。証跡は、 AWS パーティション内のすべてのリージョンからのイベントをログに記録し、指定した S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については、以下を参照してください。

Amazon Lex は、CloudTrail ログファイルのイベントとして以下のオペレーションのログ付けをサポートします。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。この情報は以下のことを確認するのに役立ちます:

詳細については、CloudTrail userIdentity エレメントを参照してください。

CloudTrail ログに記録される Amazon Lex アクションの詳細については、「Amazon Lex Model·Building·Service」を参照してください。例えば PutBot、GetBot、の各 DeleteBot オペレーションへのコールは、CloudTrail ログファイル内にエントリを生成します。「Amazon Lex Runtime Service」、「PostContent」、「PostText」に記載されているアクションはログに記録されません。

例: Amazon Lex ログファイルのエントリ

証跡は、指定した S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail ログファイルには、1 つ以上のログエントリがあります。イベントはあらゆるソースからの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストのパラメータなどの情報が含まれます。CloudTrail ログファイルは、公開 API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。

次の CloudTrail ログエントリの例は、PutBot オペレーションへの呼び出しの結果を示しています。