A trail is a configuration that enables delivery of events as log files to an Amazon S3 bucket that you specify. CloudTrail log files contain one or more log entries. An event represents a single request from any source and includes information about the requested action, the date and time of the action, request parameters, and so on. CloudTrail log files are not an ordered stack trace of the public API calls, so they do not appear in any specific order.
The following example shows a CloudTrail log for a user that created a snapshot of a DB instance
and then deleted that instance using the Neptune console. The console is identified by the
userAgent element. The requested API calls made by the console
(CreateDBSnapshot and DeleteDBInstance) are found in the
eventName element for each record. Information about the user
(Alice) can be found in the userIdentity element.
{
Records:[
{
"awsRegion":"us-west-2",
"eventName":"CreateDBSnapshot",
"eventSource":"domainSource",
"eventTime":"2014-01-14T16:23:49Z",
"eventVersion":"1.0",
"sourceIPAddress":"192.0.2.01",
"userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08",
"userIdentity":
{
"accessKeyId":"0123456789012",
"accountId":"123456789012",
"arn":"arn:aws:iam::123456789012:user/Alice",
"principalId":"AIDAI2JXM4FBZZEXAMPLE",
"sessionContext":
{
"attributes":
{
"creationDate":"2014-01-14T15:55:59Z",
"mfaAuthenticated":false
}
},
"type":"IAMUser",
"userName":"Alice"
}
},
{
"awsRegion":"us-west-2",
"eventName":"DeleteDBInstance",
"eventSource":"domainSource",
"eventTime":"2014-01-14T16:28:27Z",
"eventVersion":"1.0",
"sourceIPAddress":"192.0.2.01",
"userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08",
"userIdentity":
{
"accessKeyId":"0123456789012",
"accountId":"123456789012",
"arn":"arn:aws:iam::123456789012:user/Alice",
"principalId":"AIDAI2JXM4FBZZEXAMPLE",
"sessionContext":
{
"attributes":
{
"creationDate":"2014-01-14T15:55:59Z",
"mfaAuthenticated":false
}
},
"type":"IAMUser",
"userName":"Alice"
}
}
]
}