AWS CloudTrail による AWS Device Farm API コールのロギング - AWS Device Farm
CloudTrail での AWS Device Farm 情報AWS Device Farm ログファイルエントリの理解

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

AWS CloudTrail による AWS Device Farm API コールのロギング

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

CloudTrail の詳細については「AWS CloudTrail ユーザーガイド」を参照してください。

CloudTrail での AWS Device Farm 情報

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

AWS Device Farm のイベントなど、AWS アカウントのイベントを継続的に記録するには、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで作成した証跡がすべての AWS リージョンに適用されます。証跡は、AWS パーティションのすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集したイベントデータをより詳細に分析し、それに基づいて対応するため、他の AWS サービスを構成できます。詳細については、次を参照してください:

AWS アカウントで CloudTrail のロギングを有効にすると、Device Farm アクションに行った API 呼び出しがログファイルに記録されます。Device Farm レコードは、他の AWS サービス記録と一緒にログファイルに記述されます。CloudTrail は、期間とファイルサイズに基づいて、新しいファイルをいつ作成して書き込むかを決定します。

Device Farm アクションはすべて、「AWS CLI リファレンス」および「Device Farm の自動化」に記録され、文書化されます。例えば、Device Farm で新しいプロジェクトまたは実行を作成する呼び出しを行うと、CloudTrail ログファイルにエントリが生成されます。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます:

  • リクエストが、ルート認証情報と AWS Identity and Access Management (IAM) ユーザー認証情報のどちらを使用して送信されたか。

  • リクエストがロールユーザーまたはフェデレーションユーザーの一時的セキュリティ認証情報を使用して行われたかどうか。

  • リクエストが別の AWS サービスによって行われたかどうか。

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

AWS Device Farm ログファイルエントリの理解

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

次の例は、Device Farm ListRuns アクションを証明する CloudTrail ログエントリを表します:

{
  "Records": [
    {
      "eventVersion": "1.03",
      "userIdentity": {
        "type": "Root",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:iam::123456789012:root",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
          "attributes": {
            "mfaAuthenticated": "false",
            "creationDate": "2015-07-08T21:13:35Z"
          }
        }
      },
      "eventTime":"2015-07-09T00:51:22Z",
      "eventSource": "devicefarm.amazonaws.com",
      "eventName":"ListRuns",
      "awsRegion":"us-west-2",
      "sourceIPAddress":"203.0.113.11",
      "userAgent":"example-user-agent-string",
      "requestParameters": {
        "arn":"arn:aws:devicefarm:us-west-2:123456789012:project:a9129b8c-df6b-4cdd-8009-40a25EXAMPLE"},
        "responseElements": { 
          "runs": [
            {
              "created": "Jul 8, 2015 11:26:12 PM",
              "name": "example.apk",
              "completedJobs": 2,
              "arn": "arn:aws:devicefarm:us-west-2:123456789012:run:a9129b8c-df6b-4cdd-8009-40a256aEXAMPLE/1452d105-e354-4e53-99d8-6c993EXAMPLE",
              "counters": {
                "stopped": 0,
                "warned": 0,
                "failed": 0,
                "passed": 4,
                "skipped": 0,
                "total": 4,
                "errored": 0
              },
              "type": "BUILTIN_FUZZ",
              "status": "RUNNING",
              "totalJobs": 3,
              "platform": "ANDROID_APP",
              "result": "PENDING"
            },
            ... additional entries ...
          ]
        }
      }
    }
  ]
}