View a markdown version of this page

ログ記録を使用してイベントと API コールをモニタリングする - Amazon CodeCatalyst

Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「CodeCatalyst から移行する方法」を参照してください。

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

ログ記録を使用してイベントと API コールをモニタリングする

Amazon CodeCatalyst では、スペースの管理イベントは によって収集AWS CloudTrailされ、スペースの請求アカウントの証跡に記録されます。CloudTrail のログ記録は CodeCatalyst イベントのログ記録を管理するための主な方法であり、もう 1 つの方法として、CodeCatalyst でのイベントログ記録の表示があります。

アカウントのイベントは、AWS アカウント用に設定された証跡と指定されたバケットで記録されます。

次の図は、スペースのすべての管理イベントが請求アカウントの CloudTrail に記録され、アカウント接続/請求イベントとAWSリソースイベントがそれぞれのアカウントの CloudTrail に記録される方法を示しています。

スペースのイベントログ記録の管理方法を示す図

この図は、以下のステップを示しています。

  1. スペースが作成されると、 AWS アカウントはスペースに接続され、請求アカウントとして指定されます。使用される証跡は、請求アカウントの CloudTrail で作成された証跡で、ここにスペースイベントがログに記録されます。CloudTrail は、CodeCatalyst スペースによって、またはその代理として行われた API コールと関連イベントを取得し、指定した S3 バケットにログファイルを配信します。請求アカウントが別の AWS アカウントに変更されると、スペースイベントはそのアカウントの証跡とバケットに記録されます。CloudTrail によって記録される CodeCatalyst 管理イベントの詳細については、「CloudTrail での CodeCatalyst に関する情報」を参照してください。

  2. 請求アカウントを含む、スペースに接続された他のアカウントは、アカウント接続と請求イベントのイベントのサブセットをログに記録します。そのアカウントにデプロイされたAWSリソースのアカウントイベントを生成する CodeCatalyst ワークフローは、 の証跡とバケットにも記録されますAWS アカウント。CloudTrail は、CodeCatalyst スペースによって、またはその代理として行われた API コールと関連イベントを取得し、指定した S3 バケットにログファイルを配信します。CloudTrail によって記録される CodeCatalyst 管理イベントの詳細については、「イベントログ記録を使用して記録されたイベントにアクセスする」を参照してください。

  3. また、AWS CLI で list-event-logs コマンドを使用して、スペース内の特定の時間内にスペース内の CodeCatalyst アクションをモニタリングすることもできます。詳細については、「Amazon CodeCatalyst API リファレンスガイド」を参照してください。スペース内の CodeCatalyst アクションのイベントのリストを呼び出すには、スペース管理者ロールが必要です。詳細については、「イベントログ記録を使用して記録されたイベントにアクセスする」を参照してください。

    注記

    ListEventLogs を使用すると、特定のスペースの過去 30 日間のイベントを取得できます。AWS CloudTrail コンソールで CodeCatalyst の過去 90 日間の管理イベントのリストを表示および取得するには、[イベント履歴] を表示します。さらに、証跡を作成することで、過去 90 日以上のイベント履歴を作成および管理できます。詳細については、「CloudTrail イベント履歴の操作」および「CloudTrail 証跡の使用」を参照してください。

注記

AWSCodeCatalyst ワークフローの接続アカウントにデプロイされた リソースは、CodeCatalyst スペースの CloudTrail ログ記録の一部として記録されません。例えば、CodeCatalyst リソースにはスペースまたは project.AWSresources には Amazon ECS サービスまたは Lambda 関数が含まれます。リソースAWS アカウントがデプロイされる各 に対して CloudTrail ログ記録を個別に設定する必要があります。

CodeCatalyst でのイベントモニタリングのフローの一例を以下に示します。

Mary Major は CodeCatalyst スペースのスペース管理者であり、CloudTrail に記録されているスペース内のスペースレベルおよびプロジェクトレベルのリソースについて、CodeCatalyst のすべての管理イベントを確認しています。CloudTrail で記録されるイベントの例については、「CloudTrail での CodeCatalyst に関する情報」を参照してください。

開発環境など、CodeCatalyst で作成されたリソースの場合、Mary はスペースの請求アカウントの [イベント履歴] を表示し、CodeCatalyst のプロジェクトメンバーによって開発環境が作成されたイベントを調査します。イベントは、開発環境を作成したユーザーの AWSBuilder ID の ID ストア IAM ID タイプと認証情報を提供します。サーバーレスデプロイの Lambda 関数など、CodeCatalyst のワークフローによってデプロイされたAWSときに で作成されたリソースの場合、AWS アカウント所有者はワークフローデプロイアクションの個別の AWS アカウント(CodeCatalyst に接続されたアカウントでもある) に関連付けられた証跡のイベント履歴を表示できます。

さらに調査するために、Mary は AWS CLI で list-event-logs コマンドを使用して、スペース内のすべての CodeCatalyst API のイベントを表示することもできます。

トピック