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

# AWS CloudTrail を使用した Savings Plans API コールのログ記録
<a name="logging-using-cloudtrail"></a>

AWS Savings Plans は、AWS CloudTrail と統合されます。ユーザー、ロール、または AWS サービスで実行されたアクションのレコードを提供するサービスです。CloudTrail は、すべての API コールをイベントとしてキャプチャします。キャプチャされた呼び出しには、AWS マネジメントコンソール からの呼び出しと、Savings Plans API オペレーションへのコード呼び出しが含まれます。追跡を作成する場合は、Savings Plans など、Simple Storage Service (Amazon S3) バケットへの CloudTrail イベントの継続的な配信を有効にすることができます。追跡を設定しない場合でも、CloudTrail コンソールの **[Event history]** (イベント履歴) で最新のイベントを表示できます。CloudTrail が収集した情報を使用して、Savings Plans に対して行われたリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時、およびその他の詳細情報を確認できます。

CloudTrail の詳細については、 『[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)』を参照してください。

## CloudTrail での Savings Plans 情報
<a name="service-name-info-in-cloudtrail"></a>

AWS アカウントを作成すると、そのアカウントに対して CloudTrail が有効になります。Savings Plans でアクティビティが発生すると、そのアクティビティは、**[イベント履歴]** の他の AWS のサービスイベントとともに CloudTrail イベントに記録されます。最近のイベントは、AWSアカウントで表示、検索、ダウンロードできます。詳細については、 「[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。

Savings Plans のイベントなど、AWS アカウントでのイベントの継続的な記録については、証跡を作成します。*証跡*により、ログファイルを CloudTrail で Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成すると、すべての AWS リージョンに証跡が適用されます。証跡は、AWSパーティションのすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集したイベントデータをより詳細に分析し、それに基づいて対応するため、他の AWS サービスを構成できます。詳細については、次を参照してください: 
+ [証跡の作成のための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail がサポートするサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail 用 Amazon SNS 通知の構成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

すべての Savings Plans アクションは CloudTrail によりログに記録されます。これらのアクションについては、「[AWS Savings Plans API リファレンス](https://docs.aws.amazon.com/savingsplans/latest/APIReference/)」で説明されています。例えば、`CreateSavingsPlan` アクションを呼び出すと、CloudTrail ログにエントリが生成されます。

各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。
+ リクエストが、ルートとユーザーロール認証情報のどちらを使用して送信されたどうか。
+ リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。
+ リクエストが別の AWS サービスによって行われたかどうか。

詳細については、「[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)」を参照してください。

## Savings Plans ログファイルエントリを理解する
<a name="understanding-service-name-entries"></a>

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

`CreateSavingsPlan` アクションの CloudTrail ログエントリの例は、以下のとおりです。

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "[principalId]/[userName]",
        "arn": "arn:aws:sts::[accountId]:assumed-role/[userName]/",
        "accountId": "[accountId]",
        "accessKeyId": "[accessKeyId]",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2019-10-01T00:00:00Z"
            },
            "sessionIssuer": {
                "type": "Role",
                "principalId": "[principalId]",
                "arn": "arn:aws:iam::[accountId]:role/[userName]",
                "accountId": "[accountId]",
                "userName": "[userName]"
            }
        }
    },
    "eventTime": "2019-10-01T00:00:00Z",
    "eventSource": "savingsplans.amazonaws.com",
    "eventName": "CreateSavingsPlan",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "[userAgent]",
    "requestParameters": {
        "commitment": "2.50",
        "savingsPlanOfferingId": "[savingsPlanOfferingId]",
        "clientToken": "[clientToken]",
        "tags": {
            "tag-key": "tag-value"
        }
    },
    "responseElements": {
        "savingsPlanId": "[savingsPlanId]"
    },
    "requestID": "[requestId]",
    "eventID": "[eventId]",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "[accountId]"
}
```