イベントログを使用したログイベントへのアクセス - Amazon CodeCatalyst

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

イベントログを使用したログイベントへのアクセス

ユーザーが Amazon でアクションを実行すると CodeCatalyst、これらのアクションはイベントとして記録されます。を使用して AWS CLI 、指定した時間枠内のスペース内のイベントのログを表示できます。これらのイベントを表示して、アクションの日時、アクションを実行したユーザーの名前、ユーザーがリクエストを行った IP アドレスなど、スペースで実行されたアクションを確認できます。

注記

接続された請求アカウント CloudTrail に対して、 CodeCatalyst スペースの管理イベントがログインされます。によってログに記録される CodeCatalyst 管理イベントの詳細については、 CloudTrail「」を参照してくださいCodeCatalyst の情報 CloudTrail。

スペースのイベントのログを表示するには、 をインストールして のプロファイル AWS CLI で設定し CodeCatalyst、スペースのスペース管理者ロールを持っている必要があります。詳細については、「AWS CLIとを使用するためのセットアップ CodeCatalyst」および「スペース管理者ロール」を参照してください。

注記

接続された CodeCatalyst で に代わって発生したイベントのログ記録を表示したり AWS アカウント、接続された請求アカウントのスペースまたはプロジェクトリソースのイベントのログ記録を表示したりするには、 を使用できます AWS CloudTrail。詳細については、「AWS CloudTrail ログ AWS アカウント 記録を使用した API コールのモニタリング」を参照してください。

  1. ターミナルまたはコマンドラインを開き、aws codecatalyst list-event-logsコマンドを実行して、以下を指定します。

    • --space-name オプションを含むスペースの名前。

    • RFC 3339 で指定された協定世界時 (UTC) タイムスタンプ形式でイベントの確認を開始する日時。 --start-timeオプション。

    • RFC 3339 で指定されている協定世界時 (UTC) タイムスタンプ形式で、 --end-timeオプションを指定してイベントの確認を停止する日時。

    • （オプション) --max-resultsオプションを指定して、1 回のレスポンスで返す結果の最大数。結果の数が指定した数より大きい場合、レスポンスには、次の結果を返すために使用できる nextToken 要素が含まれます。

    • （オプション) --event-nameオプションを指定して、返される特定のイベントタイプに結果を制限します。

    この例では、期間 2022-11-30 ExampleCorpから 2022-12-01 までの という名前のスペースにログに記録されたイベントが返され、レスポンスには最大 2 つのイベントが返されます。

    aws codecatalyst list-event-logs --space-name ExampleCorp --start-time 2022-11-30 --end-time 2022-12-01 --event-name list-event-logs --max-results 2

  2. この時間枠にイベントが発生した場合、コマンドは次のような結果を返します。

    {
    "nextToken": "EXAMPLE",
    "items": [
        {
            "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "eventName": "listEventLogs",
            "eventType": "AwsApiCall",
            "eventCategory": "MANAGEMENT",
            "eventSource": "manage",
            "eventTime": "2022-12-01T22:47:24.605000+00:00",
            "operationType": "READONLY",
            "userIdentity": {
                "userType": "USER",
                "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111"
                "userName": "MaryMajor"
            },
            "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "requestPayload": {
                "contentType": "application/json",
                "data": "{\"spaceName\":\"ExampleCorp\",\"startTime\":\"2022-12-01T00:00:00Z\",\"endTime\":\"2022-12-10T00:00:00Z\",\"maxResults\":\"2\"}"
            },
            "sourceIpAddress": "127.0.0.1",
            "userAgent": "aws-cli/2.9.0 Python/3.9.11 Darwin/21.3.0 exe/x86_64 prompt/off command/codecatalyst.list-event-logs"
        },
        {
            "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa",
            "eventName": "createProject",
            "eventType": "AwsApiCall",
            "eventCategory": "MANAGEMENT",
            "eventSource": "manage",
            "eventTime": "2022-12-01T09:15:32.068000+00:00",
            "operationType": "MUTATION",
            "userIdentity": {
                "userType": "USER",
                "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111",
                "userName": "MaryMajor"
            },
            "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "requestPayload": {
                "contentType": "application/json",
                "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\"}"
            },
            "responsePayload": {
                "contentType": "application/json",
                "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\",\"id\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE4444\"}"
            },
            "sourceIpAddress": "192.0.2.23",
            "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Firefox/102.0"
        }
    ]
}

  3. --next-token オプションと返されたトークンの値を使用してlist-event-logsコマンドを再度実行し、リクエストに一致するログに記録された次のイベントのセットを取得します。