日志 X-Ray API 调用Amazon CloudTrail - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

日志 X-Ray API 调用Amazon CloudTrail

Amazon X-Ray已与 集成Amazon CloudTrail，以记录用户、角色或AmazonX-Ray 服务。您可以使用 CloudTrail 实时监控 X-Ray API 请求，并在 Amazon S3、Amazon CloudWatch 日志和 Amazon CloudWatch 事件中存储日志。X-Ray 支持在 CloudTrail 日志文件中将以下操作记录为事件：

支持的 API 操作

创建跟踪

  1. 打开跟踪页面。

  2. 选择 Create trail (创建跟踪)。

  3. 输入跟踪名称，然后选择要记录的事件类型。

    • 管理事件— 记录创建、读取、更新或删除的 API 操作Amazon资源的费用。记录调用所有 Amazon 服务的所有支持的 API 操作。

    • 数据事件— 记录针对特定资源的 API 操作，例如 Amazon S3 对象读取或Amazon Lambda函数调用。您可以选择要监控的存储桶和函数。

  4. 选择 Amazon S3 存储桶，并加密设置。

  5. 选择创建。

CloudTrail 会记录您所选类型的 API 调用，以日志 Amazon S3 中的日志文件。CloudTrail 日志是 JSON 格式的一系列无序事件。对于支持的 API 操作的每次调用，CloudTrail 会记录请求信息，以及发出请求的实体。日志事件中包含操作名称、参数和 X-Ray 响应，以及请求者的详细信息。

例 X-Ray Encryption Config 日志条目

{
    "eventVersion"=>"1.05",
    "userIdentity"=>{
        "type"=>"AssumedRole",
        "principalId"=>"AROAJVHBZWD3DN6CI2MHM:MyName",
        "arn"=>"arn:aws:sts::123456789012:assumed-role/MyRole/MyName",
        "accountId"=>"123456789012",
        "accessKeyId"=>"AKIAIOSFODNN7EXAMPLE",
        "sessionContext"=>{
            "attributes"=>{
                "mfaAuthenticated"=>"false",
                "creationDate"=>"2018-9-01T00:24:36Z"
            },
            "sessionIssuer"=>{
                "type"=>"Role",
                "principalId"=>"AROAJVHBZWD3DN6CI2MHM",
                "arn"=>"arn:aws:iam::123456789012:role/MyRole",
                "accountId"=>"123456789012",
                "userName"=>"MyRole"
            }
        }
    },
    "eventTime"=>"2018-9-01T00:24:36Z",
    "eventSource"=>"xray.amazonaws.com",
    "eventName"=>"GetEncryptionConfig",
    "awsRegion"=>"us-east-2",
    "sourceIPAddress"=>"33.255.33.255",
    "userAgent"=>"aws-sdk-ruby2/2.11.19 ruby/2.3.1 x86_64-linux",
    "requestParameters"=>nil,
    "responseElements"=>nil,
    "requestID"=>"3fda699a-32e7-4c20-37af-edc2be5acbdb",
    "eventID"=>"039c3d45-6baa-11e3-2f3e-e5a036343c9f",
    "eventType"=>"AwsApiCall",
    "recipientAccountId"=>"123456789012"
}

userIdentity 元素中包含生成请求的人员的相关信息。身份信息帮助您确定以下内容：

  • 请求是使用根用户凭证还是 IAM 用户凭证发出的。

  • 请求是使用角色还是联合身份用户的临时安全凭证发出的。

  • 请求是否由其他 Amazon 服务发出。

要在有可用的新日志文件时获得通知，请配置 CloudTrail，以发布 Amazon SNS 通知。有关更多信息，请参阅为 CloudTrail 配置 Amazon SNS 通知。

您还可以聚 X-Ray 来自多个Amazon区域和多个Amazon账户到单个 Amazon S3 存储桶。有关更多信息，请参阅接收来自多个区域的 CloudTrail 日志文件和从多个账户中接收 CloudTrail 日志文件。