本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 記錄 DataBrew API 呼叫AWS CloudTrail
DataBrew 已與 服務整合AWS CloudTrail，此服務提供由使用者、角色或 DataBrew 中的AWS服務所採取之動作的記錄。CloudTrail 會將 DataBrew 的所有 API 呼叫擷取為事件。擷取的呼叫包括來自 DataBrew 主控台的呼叫，以及對 DataBrew API 操作的程式碼呼叫。如果您建立追蹤，則可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 DataBrew 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 所收集的資訊，判斷對 DataBrew 提出的請求。您還可以判斷提出請求的來源 IP 地址、提出請求的人員和時間以及其他詳細資訊。
若要進一步了解 CloudTrail，請參閱[「AWS CloudTrail使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
## CloudTrail 中的 DataBrew 資訊
當您建立AWS帳戶時，會在您的帳戶上啟用 CloudTrail。當活動在 DataBrew 中發生時，該活動會與**事件歷史記錄**中的其他服務AWS事件一起記錄在 CloudTrail 事件中。您可以在AWS帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱《AWS CloudTrail使用者指南》**中的[使用 CloudTrail 事件歷史記錄檢視事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
若要持續記錄您AWS帳戶中的事件，包括 DataBrew 的事件，請建立追蹤。*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。根據預設，當您在主控台中建立線索時，線索會套用至所有AWS區域。線索會記錄AWS分割區中所有區域的事件，並將日誌檔案傳送到您指定的 Amazon S3 儲存貯體。此外，您可以設定其他AWS服務，以進一步分析和處理 CloudTrail 日誌中收集的事件資料。如需詳細資訊，請參閱《AWS CloudTrail使用者指南》** 中的下列主題：
+ [建立追蹤的概觀](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)
CloudTrail 會記錄所有 DataBrew 動作，並記錄在 [API 參考](https://docs.aws.amazon.com/databrew/latest/APIReference/Welcome.html)中。例如，對 `CreateDataset`、`UpdateRecipe` 和 `StartJobRun` 動作發出的呼叫會在 CloudTrail 記錄檔案中產生專案。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是否使用根或使用者憑證提出。
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。
+ 請求是否由其他AWS服務提出。
如需詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 了解 DataBrew 日誌檔案項目
同樣地，CloudTrail *追蹤*是一種組態，可讓您將事件做為日誌檔案交付至您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個*事件*為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔案並非依公有 API 呼叫的堆疊追蹤排序，因此不會以任何特定順序出現。
以下範例顯示的 CloudTrail 日誌項目會示範 `CreateProfileJob` 操作：
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::1234567890:user/joe",
"accountId": "1234567890",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "joe"
},
"eventTime": "2020-11-09T18:54:44Z",
"eventSource": "databrew.amazonaws.com",
"eventName": "CreateProfileJob",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"requestParameters": {
"OutputLocation": {
"Bucket": "{{bucketName}}",
"Key": "{{keyName}}"
},
"DatasetName": "my-chess-dataset",
"RoleArn": "arn:aws:iam::1234567890:role/custom-role",
"Name": "my-profile-job"
},
"responseElements": {
"Name": "my-profile-job"
},
"requestID": "993bc3b8-3980-48dd-961e-c1c8529eb248",
"eventID": "f8128dfa-df29-458b-a2d5-34805b46eefd",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "1234567890"
}
```