本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Quick 中的事件回應、記錄和監控
<a name="incident-response-logging-and-monitoring"></a>


|  | 
| --- |
|    目標對象：系統管理員和 Amazon Quick 管理員  | 

有效的事件回應、記錄和監控對於維護 Amazon Quick 執行個體的安全性、效能和可靠性至關重要。此監控架構提供跨所有 Amazon Quick 功能的使用者活動、系統效能、安全事件和操作指標的多層可見性，包括聊天、空間、流程、動作、研究、儀表板和自訂客服人員。

Amazon Quick AWS 與原生監控和記錄服務整合，以提供即時洞見和歷史分析功能。監控系統會擷取有關使用者參與、對話模式、資源使用率和安全相關事件的詳細分析，而 CloudTrail 記錄可確保完整的稽核線索以進行合規和鑑識分析。

本節涵蓋：
+ **分析和監控** - 全方位儀表板和指標，用於追蹤所有 Amazon Quick 功能的使用者採用率、效能、意見回饋和安全性事件
+ **CloudTrail 記錄** - 完成 API 呼叫和管理動作的稽核追蹤，以在 Amazon Quick Sight 中進行合規和安全性監控
+ **非 API 事件記錄** - 監控不會產生 API 呼叫的使用者互動、內容存取和系統事件
+ **日誌分析和解釋** - 了解日誌項目、識別安全事件，以及回應 Amazon Quick Sight 中的操作問題

無論您是要調查安全事件、分析使用者行為模式、測量系統效能，還是確保合規性，這些監控和記錄功能都能提供維護安全且正常運作的 Amazon Quick 環境所需的可見性和資料。

**Topics**
+ [使用 CloudWatch Logs 監控 Amazon Quick 用量](monitoring-quicksuite-chat-feedback-cloudwatch.md)
+ [使用 CloudTrail 在 Amazon Quick Sight 中回應、記錄和監控事件](incident-response-logging-and-monitoring-qs.md)
+ [使用 CloudWatch 監控 Amazon Quick Sight 中的資料](monitoring-quicksight.md)

# 使用 CloudWatch Logs 監控 Amazon Quick 用量
<a name="monitoring-quicksuite-chat-feedback-cloudwatch"></a>

您可以使用 [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) 在 Amazon Quick 中提供聊天對話、使用者意見回饋和客服人員/研究時數用量，供您分析。這些日誌可以傳送到多個目的地，例如 CloudWatch、Amazon S3 或 Amazon Data Firehose （適用標準費率）。我們建議您在啟用 Amazon Quick AI 功能後不久設定自動傳送的日誌。

以下是您可以使用 Amazon Quick 日誌完成的任務範例：
+ 檢閱聊天訊息內容來識別常見的使用者查詢和困擾。
+ 查看 `feedbackReason` 等指標來監控回應品質。
+ 分析意見回饋資料來瞭解使用者情緒和滿意度，包括評論和實用性評分。
+ 產生自訂儀表板和報告，以追蹤長期的關鍵指標和趨勢。
+ 識別和分析聊天未傳回答案或使用者查詢遭到封鎖的案例
+ 監控代理程式和研究時數用量

**重要**  
對話日誌可能包含聊天中傳遞的敏感或個人身分識別資料。設定日誌訂閱時，您可以從日誌中篩選掉此資訊。或者您可以使用 CloudWatch Logs 遮罩政策在日誌上遮罩此資料。如需詳細資訊，請參閱[使用遮罩功能協助保護敏感日誌資料](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html)。

## 支援的日誌目的地
<a name="quicksuite-chat-feedback-supported-log-destinations"></a>

Amazon Quick 可以將日誌交付至下列目的地：
+ **Amazon CloudWatch Logs** - 用於即時監控和分析
+ **Amazon S3** - 用於長期儲存和批次處理
+ **Amazon Data Firehose** - 用於串流分析和資料轉換

## 先決條件
<a name="quicksuite-chat-feedback-logging-prerequisites"></a>

在啟用記錄之前，請確定您有：
+ 具備企業或專業訂閱的作用中 Amazon Quick 執行個體
+ 設定日誌交付的適當 IAM 許可
+ 為您的日誌設定的目的地 (CloudWatch Logs、Amazon S3 儲存貯體或 Firehose)

## 設定 記錄
<a name="quicksuite-chat-feedback-configure-logging"></a>

若要啟用 Amazon Quick 聊天和意見回饋的記錄，您需要設定 IAM 許可、建立交付來源和目的地，並確認日誌已成功交付。

**Topics**
+ [設定 IAM 許可](#quicksuite-chat-feedback-setup-iam-permissions)
+ [設定日誌訂閱](#quicksuite-chat-feedback-configure-log-subscription)
+ [驗證日誌交付](#quicksuite-chat-feedback-verify-log-delivery)

### 設定 IAM 許可
<a name="quicksuite-chat-feedback-setup-iam-permissions"></a>

若要設定 Amazon Quick 的 CloudWatch Logs，請使用下列 IAM 政策範例來授予必要的許可。

```
{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [{
        "Sid": "QuicksightLogDeliveryPermissions",
        "Effect": "Allow",
        "Action": "quicksight:AllowVendedLogDeliveryForResource",
        "Resource": "arn:aws:quicksight:region:account-id:account/account-id"
    }]
}
```

您還必須在客戶受管 AWS KMS 金鑰政策中允許 `delivery.logs.amazonaws.com`服務主體。

```
{
    "Effect": "Allow"		 	 	 ,
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*"
        }
    }
}
```

### 設定日誌訂閱
<a name="quicksuite-chat-feedback-configure-log-subscription"></a>

如需具有特定記錄目的地所有必要許可的 IAM 政策，請參閱《*Amazon CloudWatch Logs 使用者指南*》中的[從 AWS 服務啟用記錄](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)。

使用 [PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html) CloudWatch Logs API 操作建立交付來源。為交付來源指定名稱，並為 `resourceArn` 指定應用程式 ARN。針對 `logType`，指定 `CHAT_LOGS`或 `AGENT_HOURS_LOGS` `FEEDBACK_LOGS`

```
{
    "logType": "CHAT_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "FEEDBACK_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

```
{
    "logType": "AGENT_HOURS_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```

若要使用 CloudWatch Logs API 操作啟用使用者對話記錄，您可以呼叫 `PutDeliverySource`、 `PutDeliveryDestination`和 `CreateDelivery` API 操作。

**注意**  
日誌可供`PutDeliverySource`輸入中資源 ARN 中提到的區域使用。

### 驗證日誌交付
<a name="quicksuite-chat-feedback-verify-log-delivery"></a>

設定完成後，請確認日誌已交付至您的目的地：
+ **驗證設定：**使用 CloudWatch Logs 中的 `DescribeDeliveries` API 驗證已在帳戶中建立的交付清單。
+ **CloudWatch Logs**：檢查指定的日誌群組是否有新的日誌串流。
+ **Amazon S3**：監控儲存貯體是否有新的日誌檔案。
+ **Firehose**：確認資料正在流經您的交付串流。

## 日誌結構描述和格式
<a name="quicksuite-chat-feedback-log-schema-format"></a>

Amazon Quick 日誌遵循結構化結構描述，其中包含所有日誌類型共用的通用欄位，以及聊天和意見回饋日誌的特定欄位。

### 常用欄位
<a name="quicksuite-chat-feedback-common-fields"></a>

所有日誌事件都包含下列常見欄位：
+ `resource_arn` - Amazon Quick 帳戶的資源 ARN （例如 `arn:aws:quicksight:us-east-1:111122223333:account/111122223333:`)
+ `event_timestamp` - 事件的 ISO 8601 時間戳記 （例如 `1763532110061`)
+ `logType` - 日誌類型 （例如 `Chat`或 `Feedback`)
+ `accountId` - AWS 帳戶 ID （例如 `123456789012`)
+ `user_arn` - 與事件相關聯的 Amazon Quick 使用者 ARN （例如 `"arn:aws:quicksight:us-west-2:111122223333:user/default/user"`)

### 聊天日誌
<a name="quicksuite-chat-logs"></a>

聊天日誌會擷取對話互動，並包含下列欄位：
+ `status_code` - 聊天請求的狀態 （例如 `Success, request_blocked, no_answer_found` )
+ `namespace*` - 事件的 Amazon Quick 命名空間 （例如 `default`)
+ `user_type` - 與事件相關聯的 Amazon Quick 使用者類型 （例如 `ADMIN_PRO`)
+ `conversation_id` - 使用者對話的唯一 ID
+ `system_message_id` - 系統產生的訊息 ID
+ `latency*` - 聊天訊息延遲，以毫秒為單位
+ `time_to_first_token*` - 第一個回應字符的時間，以毫秒為單位
+ `message_scope` - 訊息的範圍 （例如 `all_resources, specific_resources, no_resources` )
+ `user_message_id` - 使用者訊息的唯一 ID
+ `user_message` - 對話中的使用者訊息
+ `agent_id` - 聊天客服人員的唯一 ID
+ `flow_id` - Amazon Quick Flow 的唯一 ID
+ `system_text_message` - 對話中的系統回應
+ `surface_type*` - 用於對話的應用程式
+ `web_search*` - 是否啟用 Web 搜尋
+ `user_selected_resources`- 使用者選取的資源清單
+ `action_connectors` - 動作連接器的清單
+ `cited_resource` - 引用的資源清單
+ `file_attachment` - 使用者附加的檔案清單

以下是聊天日誌的範例：

```
{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "latency": "10000", 
    "time_to_first_token": "10000",
    "message_scope": "all_resources",
    "user_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message": "Hi chat",
    "agent_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "flow_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?",
    "system_text_message": "Hello user",
    "surface_type": "WEB_EXPERIENCE",
    "web_search": "true"
    "user_selected_resources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}],
    "action_connectors": [{"action_connector_id": "quicksight-website"},{"action_connector_id": "123abs-1234-534894"}]
    "cited_resource": [{"cited_resource_name": "Dashboard","cited_resource_id": "146abs-1222-534894","cited_resource_name": "ds1"},{"cited_resource_name": "Space","cited_resource_id": "123abs-1234-534894","cited_resource_name": "space1"}],
    "file_attachment": [{"file_attachmet_type": "pdf","file_attachment_name": "file1.pdf"},{"file_attachmet_type": "txt","file_attachment_name": "file2.txt"}]
}
```

### 意見回饋日誌
<a name="quicksuite-chat-feedback-logs"></a>

意見回饋日誌會擷取使用者對聊天的意見回饋，並包含下列欄位：
+ `status_code` - 事件交付的狀態
+ `namespace*` - 事件的 Amazon Quick 命名空間 （例如 `default`)
+ `user_type` - 與事件相關聯的 Amazon Quick 使用者類型 （例如 `ADMIN_PRO`)
+ `conversation_id` - 對話的唯一 ID
+ `system_message_id` - 系統產生的訊息 ID
+ `user_message_id` - 使用者訊息的唯一 ID
+ `feedback_type` - 意見回饋類型 `Not Useful, Useful` （例如 )
+ `feedback_reason` - 使用者選取的意見回饋原因
+ `feedback_details` - （選用） 使用者提供的其他詳細資訊

以下是意見回饋日誌的範例：

```
{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message_id" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "feedback_type" :"Not Useful / Useful"
    "feedback_reason" : "Too wordy,Issue with sources,Other etc."
    "feedback_details" : "additional text shared by user"
}
```

## 客服人員/研究時數日誌
<a name="quicksuite-agent-hours-logs"></a>

此日誌類型會擷取您 Quick 帳戶中用於定價之不同客服人員的使用日誌：
+ `subscription_type` - ENTERPRISE 或 PROFESSIONAL
+ `reporting_service` - 對應至代理程式的服務：RESEARCH、FLOWS 或 AUTOMATIONS
+ `usage_group` - `Included or Extra` 根據到目前為止的訂閱類型和用量
+ `usage_hours` - 表示特定日誌執行個體使用時數的十進位值
+ `service_resource_arn` - 對應客服人員服務的 ARN

以下是客服人員時數日誌的範例：

```
{
    "subscription_type": "ENTERPRISE",
    "reporting_service": "RESEARCH",
    "usage_group": "Included",
    "usage_hours": 0.3333,
    "service_resource_arn": "arn:aws:quicksight:eu-west-1:111222333444:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d"
}
```

**注意**  
 \$1 根據預設，標記為「\$1」的欄位不會新增至您的日誌訂閱。如果需要，在呼叫 CreateDelivery 時需要明確指定這些項目。

## 安全考量
<a name="quicksuite-chat-feedback-security-considerations"></a>
+ **加密**：針對敏感資料使用客戶受管 AWS KMS 金鑰
+ **存取控制**：實作最低權限的 IAM 政策
+ **資料保留**：為您的合規要求設定適當的保留政策

# 使用 CloudTrail 在 Amazon Quick Sight 中回應、記錄和監控事件
<a name="incident-response-logging-and-monitoring-qs"></a>

Amazon Quick Sight 已與 整合 AWS CloudTrail。此服務提供 Amazon Quick Sight AWS 中使用者、角色或服務所採取動作的記錄。CloudTrail 會將 Amazon Quick Sight 的所有 API 呼叫擷取為事件。擷取的呼叫包括來自 Amazon Quick Sight 主控台的一些呼叫，以及對 Amazon Quick Sight API 操作的所有程式碼呼叫。如果您建立線索，您可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 Amazon Quick Sight 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 所收集的資訊，判斷向 Amazon Quick Sight 提出的請求、提出請求的 IP 地址、提出請求的人員、提出請求的時間，以及其他詳細資訊。

Amazon Quick Sight 原生不支援使用 Amazon CloudWatch 或其他外部系統發出警示。不過，您可以開發自訂解決方案來處理 CloudTrail 日誌。

您可以在服務[運作狀態儀表板上檢視 Amazon Quick Sight 服務](https://status.aws.amazon.com/)狀態。

根據預設，CloudTrail 交付至您儲存貯體的日誌檔案是透過 Amazon [伺服器端加密與 Amazon Simple Storage Service (Amazon S3) 受管加密金鑰 (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) 進行加密。若要提供可直接管理的安全層，您可以改為為 CloudTrail 日誌檔案使用[伺服器端加密搭配 AWS KMS 受管金鑰 (SSE-KMS)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html)。啟用伺服器端加密可加密日誌檔案，但未使用 SSE-KMS 加密摘要檔案。摘要檔案是使用 [Amazon S3 受管加密金鑰 (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) 進行加密。

若要進一步了解 CloudTrail，包括如何設定及啟用，請參閱[《AWS CloudTrail 使用者指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。

**Topics**
+ [使用 記錄 Amazon Quick Sight 資訊 AWS CloudTrail](#logging-using-cloudtrail)
+ [使用 CloudTrail 日誌追蹤非 API 事件](#logging-non-api)
+ [範例：Amazon Quick Sight 日誌檔案項目](#understanding-quicksight-entries)

## 使用 記錄 Amazon Quick Sight 資訊 AWS CloudTrail
<a name="logging-using-cloudtrail"></a>


|  | 
| --- |
|    目標對象：系統管理員  | 

當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當 Amazon Quick Sight 中發生支援的事件活動時，該活動會與**事件歷史記錄**中的其他 AWS 服務事件一起記錄在 CloudTrail 事件中。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱《使用 CloudTrail 事件歷史記錄檢視事件》[https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。

若要持續記錄您 AWS 帳戶中的事件，包括 Amazon Quick Sight 的事件，請建立追蹤。*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。依預設，當您在主控台中建立追蹤時，該追蹤會套用至所有的 。該追蹤會記錄來自 AWS 分割區中所有區域的事件，並將日誌檔案交付到您指定的 Amazon S3 儲存貯體。此外，您可以設定其他 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)
+ 《 AWS Lake Formation 開發人員指南》中的[跨帳戶 CloudTrail 記錄](https://docs.aws.amazon.com/lake-formation/latest/dg/cross-account-logging.html) – 本主題包含在跨帳戶 CloudTrail 日誌中包含主體身分的說明。

Amazon Quick Sight 支援將下列動作記錄為 CloudTrail 日誌檔案中的事件：
+ 是否使用根登入資料或 AWS Identity and Access Management 使用者登入資料提出請求
+ 提出該請求時，是否使用了 IAM 角色或聯合身分使用者的暫時安全登入資料
+ 請求是否由其他 AWS 服務提出

如需有關使用者身分的詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。

根據預設，每個 Amazon Quick Sight 日誌項目都包含下列資訊：
+  **userIdentity** – 使用者身分

  
+  **eventTime** – 事件時間

  
+  **eventId** – 事件 ID

  
+  **readOnly** – 唯讀

  
+  **awsRegion** – AWS 區域

  
+  **eventSource (Qucksight)** – 事件來源 (Amazon Quick Sight)

  
+  **eventType (AwsServiceEvent)** – 事件類型 (AWS 服務事件）

  
+  **recipientAccountId （客戶 AWS 帳戶）** – 收件人帳戶 ID （客戶 AWS 帳戶）

  

**注意**  
 CloudTrail 會顯示使用者，`unknown`就像他們是由 Amazon Quick Sight 佈建一樣。如此顯示的原因為這些使用者不是已知的 IAM 身分類型。

## 使用 CloudTrail 日誌追蹤非 API 事件
<a name="logging-non-api"></a>

以下是您可以追蹤之非 API 事件的清單。

**使用者管理**
+  **CreateAccount** – 建立帳戶

  
+ **BatchCreateUser** – 建立使用者

  
+ **BatchResendUserInvite** – 邀請使用者

  
+ **UpdateGroups** – 更新群組

  這個事件僅會使用 Enterprise Edition。

  
+ **UpdateSpiceCapacity** – 更新 SPICE 容量

  
+ **DeleteUser** – 刪除使用者

  
+ **Unsubscribe** – 取消訂閱使用者

  

**訂閱**
+ **CreateSubscription** – 建立訂閱

  
+ **UpdateSubscription** – 更新訂閱

  
+ **DeleteSubscription** – 刪除訂閱

  

**儀表板**
+ **GetDashboard** – 取得儀表板

  
+ **CreateDashboard** – 建立儀表板

  
+ **UpdateDashboard** – 更新儀表板

  
+ **UpdateDashboardAccess** – 更新儀表板存取

  
+ **DeleteDashboard** – 刪除儀表板

  

**分析**
+ **GetAnalysis** – 取得分析

  
+ **CreateAnalysis** – 建立分析

  
+ **UpdateAnalysisAccess** – 更新分析存取

  
+ **UpdateAnalysis** – 更新分析

  
  + **RenameAnalysis** – 重新命名分析

    
  + **CreateVisual** – 建立視覺效果

    
  + **RenameVisual** – 重新命名視覺效果

    
  + **DeleteVisual** – 刪除視覺效果

    
  + **DeleteAnalysis** – 刪除分析

    

**資料來源**
+ **CreateDataSource** – 建立資料來源

  
  + **FlatFile** – 一般檔案

    
  + **External** – 外部

    
  + **S3** – S3

    
  + **ImportS3ManifestFile** – S3 清單檔案

    
  + **Presto** – Presto

    
  + **RDS** – RDS

    
  + **Redshift** – Redshift (手動)

    
+ **UpdateDataSource** – 更新資料來源

  
+ **DeleteDataSource** – 刪除資料來源

  

**資料集**
+  **CreateDataSet** – 建立資料集

  
  + **CustomSQL** – 自訂 SQL

    
  + **SQLTable** – SQL 資料表

    
  + **File** – CSV 或 XLSX

    
+ **UpdateDataSet** – 更新 SQL Join 資料集

  
+ **UpdateDatasetAccess** – 更新資料集存取

  
+ **DeleteDataSet** – 刪除資料集

  
+ **Querydatabase** – 在資料集重新整理期間，查詢資料來源。

## 範例：Amazon Quick Sight 日誌檔案項目
<a name="understanding-quicksight-entries"></a>

 追蹤是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔並非依公有 API 呼叫的堆疊追蹤排序，因此不會以任何特定順序出現。

下列範例所顯示的 CloudTrail 日誌項目示範 BatchCreateUser 動作。

```
{ 
   "eventVersion":"1.05",
   "userIdentity":
	{ 
	   "type":"Root",
	   "principalId":"123456789012",
	   "arn":"arn:aws:iam::123456789012:root",
	   "accountId":"123456789012",
	   "userName":"test-username"
	},
	   "eventTime":"2017-04-19T03:16:13Z",
	   "eventSource":"quicksight.amazonaws.com",
	   "eventName":"BatchCreateUser",
	   "awsRegion":"us-west-2",
	   "requestParameters":null,
	   "responseElements":null,
	   "eventID":"e7d2382e-70a0-3fb7-9d41-a7a913422240",
	   "readOnly":false,
	   "eventType":"AwsServiceEvent",
	   "recipientAccountId":"123456789012",
	   "serviceEventDetails":
	   { 
		   "eventRequestDetails":
		   { 
				"users":
				{ 
					"test-user-11":
					{ 
						"role":"USER"
					},
					"test-user-22":
					{ 
						"role":"ADMIN"
					}
				}
			},
			"eventResponseDetails":
			{ 
			"validUsers":[ 
				],
			"InvalidUsers":[ 
				"test-user-11",
				"test-user-22"
				]
			}
	   }
   }
```

# 使用 CloudWatch 監控 Amazon Quick Sight 中的資料
<a name="monitoring-quicksight"></a>

Amazon Quick 會將指標傳送至 Amazon CloudWatch，您可以用來近乎即時地觀察和回應 Amazon Quick 環境的可用性和效能。目前，您可以監控 Amazon Quick Sight 儀表板、視覺效果和資料集擷取的指標，以及非結構化資料集和快速動作連接器，為讀者提供一致、高效能和不間斷的 Amazon Quick 體驗。

如需有關如何使用 Amazon CloudWatch 的詳細資訊，請參閱[《Amazon CloudWatch 使用者指南》](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)。

## 在 Amazon CloudWatch 中存取快速指標
<a name="access-cw"></a>

使用下列程序存取 Amazon CloudWatch 中的 Amazon Quick 指標。

**在 CloudWatch 中存取 Amazon Quick 指標**

1. 登入與您的 Amazon Quick AWS 帳戶 帳戶相關聯的 。

1. 在 AWS 管理主控台 首頁的左上角，選擇**服務**，然後選擇 **CloudWatch**。

1. 在導覽窗格中，選擇**指標**，再選擇**所有指標**，最後選擇 **QuickSight**。

**Topics**
+ [使用 Amazon CloudWatch 主控台繪製指標](#cw-graph)
+ [使用 Amazon CloudWatch 主控台建立警示](#cw-alerts)
+ [指標](#cw-metrics)
+ [彙總指標](#cw-aggregate-metrics)
+ [彙總 SPICE 指標](#aggregate-spice-metrics)
+ [維度](#cw-dimensions)

### 使用 Amazon CloudWatch 主控台繪製指標
<a name="cw-graph"></a>

您也可以使用 Amazon CloudWatch 主控台來繪製 Quick 產生的指標資料。如需詳細資訊，請參閱「*Amazon CloudWatch 使用者指南*」 中的[圖形指標](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/graph_metrics.html)。

### 使用 Amazon CloudWatch 主控台建立警示
<a name="cw-alerts"></a>

您可以建立 Amazon CloudWatch 警示來監控 Quick 資產的 CloudWatch 指標。CloudWatch 會在指標達到您指定的閾值時，自動傳送通知給您。如需範例，請參閱《Amazon CloudWatch 使用者指南》**中的[建立 Amazon CloudWatch 警示](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)一節。

### 指標
<a name="cw-metrics"></a>

`AWS/QuickSight` 命名空間包含下列指標，用於監控 Amazon Quick 資產的流量和延遲。

**Topics**
+ [每個儀表板指標](#per-dashboard-metrics)
+ [每個資料集擷取指標](#per-ingestion-metrics)
+ [每個視覺化效果指標](#per-visual-metrics)
+ [每個非結構化資料集指標](#per-unstructured-dataset-metrics)
+ [每個動作連接器指標](#per-action-connector-metrics)

#### 每個儀表板指標
<a name="per-dashboard-metrics"></a>

下列指標追蹤儀表板檢視計數和載入時間。您可以在 CloudWatch 中的 `AWS/QuickSight/Dashboard Metrics` 群組下找到這些指標。


| 指標 | Description | 維度 | 單位 | 
| --- | --- | --- | --- | 
|  DashboardViewCount  |  儀表板被檢視的次數。此數字涵蓋所有存取模式，例如網路、行動和內嵌。 此指標最有用的統計資料是 `SUM`，它表示一段時間內儀表板被檢視的總數。  |  DashboardId  |  計數  | 
|  DashboardViewLoadTime  |  Amazon Quick Sight 儀表板載入所需的時間。測量會在使用者到達 Amazon Quick Sight 儀表板時開始，並在儀表板的所有視覺效果完成轉譯時結束。 此指標最有用的統計資料是 `AVERAGE`，代表 Amazon Quick Sight 儀表板在設定期間內的平均載入時間。  |  DashboardId  |  毫秒  | 

#### 每個資料集擷取指標
<a name="per-ingestion-metrics"></a>

下列指標會追蹤特定 [SPICE](https://docs.aws.amazon.com/quicksight/latest/user/spice.html) 資料集的擷取。您可以在 CloudWatch 中的 `AWS/QuickSight/Ingestion Metrics` 群組下找到這些指標。


| 指標 | Description | 維度 | 單位 | 
| --- | --- | --- | --- | 
|  IngestionErrorCount  |  擷取失敗的次數。 此指標最有用的統計資料是 `SUM`，它表示一段時間內失敗的擷取總數。  |  DatasetId  |  計數  | 
|  IngestionInvocationCount  |  啟動的擷取次數。這包括透過主控台和 Amazon Quick Sight API 操作啟動的排程和手動擷取。 此指標最有用的統計資料是 `SUM`，它表示一段時間內啟動的擷取總數。  |  DatasetId  |  計數  | 
|  IngestionLatency  |  從開始擷取到完成擷取所經過的時間。 此指標最有用的統計資料是 `AVERAGE`，它表示一段時間內擷取的平均執行期。  |  DatasetId  |  秒  | 
|  IngestionRowCount  |  成功列擷取的數量。 此指標最有用的統計資料是 `SUM`，它表示一段時間內擷取的資料總量。  |  DatasetId  |  計數  | 

#### 每個視覺化效果指標
<a name="per-visual-metrics"></a>

下列指標會追蹤 Amazon Quick Sight 儀表板上個別視覺效果的載入時間和錯誤計數。您可以在 CloudWatch 中的 `AWS/QuickSight/Visual Metrics` 群組下找到這些指標。


| 指標 | Description | 維度 | 單位 | 
| --- | --- | --- | --- | 
|  VisualLoadTime  |  Amazon Quick Sight 視覺效果接收視覺效果初始繪製所需的查詢資料所需的時間。這包括從用戶端到 Amazon Quick Sight 服務的往返查詢時間，然後返回用戶端。 此指標最有用的統計資料是 `AVERAGE`，它表示一段時間內視覺化效果的平均載入時間。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  毫秒  | 
|  VisualLoadErrorCount  |  Amazon Quick Sight 視覺效果無法完成初始繪製資料查詢的次數。視覺化效果載入期間發生的任何錯誤都會計入此指標。 此指標最有用的統計資料是 `SUM`，它表示一段時間內失敗的視覺化效果載入總數。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 

#### 每個非結構化資料集指標
<a name="per-unstructured-dataset-metrics"></a>

下列指標會追蹤 Amazon Quick Sight 非結構化資料集的文件統計資料和索引狀態。您可以在 CloudWatch 中的 `AWS/QuickSight/QuickInstanceId` 群組下找到這些指標。


| 指標 | Description | 維度 | 單位 | 
| --- | --- | --- | --- | 
|  QuickIndexDocumentCount  |  非結構化快速索引中的文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  QuickIndexExtractedTextSize  |  非結構化快速索引擷取的文字大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  位元組  | 
|  QuickIndexPurchasedInMB  |  已為非結構化快速索引購買的儲存量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  MB  | 
|  QuickIndexCapacityConsumedRawFileSizeInGB  |  非結構化快速索引使用的原始檔案大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  GB  | 
|  QuickIndexCapacityRawFileSizeLimitInGB  |  非結構化快速索引的原始檔案大小限制。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  GB  | 
|  DocumentsCrawled  |  非結構化快速索引中抓取的上傳文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  DocumentsIndexed  |  在非結構化快速索引中編製索引的文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  DocumentsDeleted  |  從非結構化快速索引中刪除的文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  DocumentsModified  |  在非結構化快速索引中修改的文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  DocumentsFailedToIndex  |  無法在非結構化快速索引中編製索引的文件數量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  ExtractedTextSize  |  在非結構化快速索引中的連接器層級同步期間擷取的總文字大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  MB  | 

#### 每個動作連接器指標
<a name="per-action-connector-metrics"></a>

下列指標會追蹤對 Quick Action Connectors 發出的呼叫數量。您可以在 CloudWatch 的`AWS/QuickSight`命名空間下找到這些指標。


| 指標 | Description | 維度 | 單位 | 
| --- | --- | --- | --- | 
|  ActionInvocationCount  |  叫用 Action Connector 的次數。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 
|  ActionInvocationError  |  Action Connector 無法調用的次數。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/monitoring-quicksight.html)  |  計數  | 

### 彙總指標
<a name="cw-aggregate-metrics"></a>

`AWS/QuickSight` 命名空間包含下列彙總指標，用於監控 Amazon Quick 資產的流量和延遲。

**Topics**
+ [彙總儀表板指標](#aggregate-dashboard-metrics)
+ [彙總擷取指標](#aggregate-ingestion-metrics)
+ [彙總視覺化效果指標](#aggregate-visual-metrics)
+ [彙總非結構化資料集指標](#aggregate-unstructured-dataset-metrics)
+ [彙總動作連接器指標](#aggregate-action-connector-metrics)

#### 彙總儀表板指標
<a name="aggregate-dashboard-metrics"></a>

下列指標會追蹤 Amazon Quick 帳戶和區域中所有儀表板的檢視計數和載入時間。您可以在 CloudWatch 中的 `AWS/QuickSight/Aggregate Metrics` 群組下找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  DashboardViewCount  |  區域中整個 Amazon Quick 帳戶的所有 Amazon Quick Sight 儀表板已檢視的次數。此數字是一個彙總值，涵蓋所有存取模式，例如網路、行動和內嵌。 此指標最有用的統計資料是 `SUM`，代表在一段期間內 Amazon Quick Sight 儀表板檢視的總數。  |  計數  | 
|  DashboardViewLoadTime  |  所有 Amazon Quick Sight 儀表板載入所需的時間量。測量會在使用者導覽至 Amazon Quick Sight 儀表板時開始，並在儀表板的所有視覺效果完成轉譯時結束。 此指標最有用的統計資料是 `AVERAGE`，代表所有 Amazon Quick Sight 儀表板在設定期間內的平均載入時間。  |  毫秒  | 

#### 彙總擷取指標
<a name="aggregate-ingestion-metrics"></a>

下列指標會追蹤與 Amazon Quick 帳戶和 相關聯的所有擷取 AWS 區域。您可以在 CloudWatch 中的 `AWS/QuickSight/Aggregate Metrics` 群組下找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  IngestionErrorCount  |  擷取失敗的次數。 此指標最有用的統計資料是 `SUM`，它表示一段時間內失敗的擷取總數。  |  計數  | 
|  IngestionInvocationCount  |  啟動的擷取次數。這包括透過主控台和 Amazon Quick Sight API 操作啟動的排程和手動擷取。 此指標最有用的統計資料是 `SUM`，它表示一段時間內啟動的擷取總數。  |  計數  | 
|  IngestionLatency  |  從開始擷取到完成擷取所經過的時間。 此指標最有用的統計資料是 `AVERAGE`，它表示一段時間內擷取的平均執行期。  |  秒  | 
|  IngestionRowCount  |  成功列擷取的數量。  此指標最有用的統計資料是 `SUM`，它表示一段時間內擷取的資料總量。  |  計數  | 

#### 彙總視覺化效果指標
<a name="aggregate-visual-metrics"></a>

下列指標會追蹤區域中 Amazon Quick 帳戶中儀表板上所有視覺效果的載入時間和錯誤計數。您可以在 CloudWatch 的 `AWS/QuickSight/Aggregate Metrics` 群組下找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  VisualLoadTime  |  所有 Amazon Quick Sight 視覺效果接收視覺效果初始繪製所需的查詢資料所需的時間。這包括從用戶端到 Amazon Quick 服務的往返查詢時間，然後返回用戶端。 此指標最有用的統計資料是 `AVERAGE`，它表示一段時間內所有視覺化效果的平均載入時間。  |  毫秒  | 
|  VisualLoadErrorCount  |  屬於 Amazon Quick 帳戶的所有 Amazon Quick Sight 視覺效果無法完成初始繪製資料查詢的次數。 此指標最有用的統計資料是 `SUM`，它表示一段時間內失敗的視覺化效果總數。  |  計數  | 

#### 彙總非結構化資料集指標
<a name="aggregate-unstructured-dataset-metrics"></a>

下列指標會追蹤 區域中 Amazon Quick 帳戶中的所有非結構化資料集指標。您可以在 CloudWatch 的 `AWS/QuickSight/Aggregate Metrics` 群組下找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  QuickIndexDocumentCount  |  非結構化快速索引中的文件數量。 此指標最有用的統計資料是 `SUM`，代表在一段期間內新增至索引的文件總數。  |  計數  | 
|  QuickIndexExtractedTextSize  |  非結構化快速索引擷取的文字大小。 此指標最有用的統計資料是 `SUM`，代表索引中所有文件的所有文字總大小。  |  位元組  | 
|  QuickIndexPurchasedInMB  |  已為非結構化快速索引購買的儲存量。 此指標最有用的統計資料是 `SUM`，代表整個索引中以 MB 為單位購買的儲存空間總大小。  |  MB  | 
|  QuickIndexCapacityConsumedRawFileSizeInGB  |  非結構化快速索引使用的原始檔案大小。 此指標最有用的統計資料是 `SUM`，代表索引中消耗的總原始檔案大小，以 GB 為單位。  |  GB  | 
|  QuickIndexCapacityRawFileSizeLimitInGB  |  非結構化快速索引的原始檔案大小限制。 此指標最有用的統計資料是 `SUM`，代表索引的總原始檔案大小限制，以 GB 為單位。  |  GB  | 
|  DocumentsCrawled  |  非結構化快速索引中抓取的上傳文件數量。 此指標最有用的統計資料是 `SUM`，代表索引中抓取的文件總數。  |  計數  | 
|  DocumentsIndexed  |  在非結構化快速索引中編製索引的文件數量。 此指標最有用的統計資料是 `SUM`，代表編製索引的文件總數。  |  計數  | 
|  DocumentsDeleted  |  從非結構化快速索引中刪除的文件數量。 此指標最有用的統計資料是 `SUM`，代表從索引中刪除的文件總數。  |  計數  | 
|  DocumentsModified  |  在非結構化快速索引中修改的文件數量。 此指標最有用的統計資料是 `SUM`，代表索引中修改的文件總數。  |  計數  | 
|  DocumentsFailedToIndex  |  無法在非結構化快速索引中編製索引的文件數量。 此指標最有用的統計資料是 `SUM`，代表無法編製索引的文件總數。  |  計數  | 
|  ExtractedTextSize  |  在非結構化快速索引中的連接器層級同步期間擷取的總文字大小。 此指標最有用的統計資料是 `SUM`，代表在連接器層級同步期間擷取的文件總大小。  |  MB  | 

#### 彙總動作連接器指標
<a name="aggregate-action-connector-metrics"></a>

下列指標會追蹤與 AWS 區域中 Amazon Quick 帳戶相關聯的所有快速動作連接器調用。您可以在 CloudWatch 的 `AWS/QuickSight/Aggregate Metrics` 群組下找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  ActionInvocationCount  |  動作連接器調用的數量。 此指標最有用的統計資料是 `SUM`，代表在一段期間內啟動的動作連接器調用總數。  |  計數  | 
|  ActionInvocationError  |  失敗動作連接器調用的數量。 此指標最有用的統計資料是 `SUM`，代表在一段期間內失敗的動作連接器調用總數。  |  計數  | 

### 彙總 SPICE 指標
<a name="aggregate-spice-metrics"></a>

下列指標監控 SPICE 耗用情況，可用於避免達到可能導致擷取失敗的 SPICE 耗用限制。統計資料會儲存長達 15 個月，因此您可以存取歷史資訊，以進一步了解 Amazon Quick 帳戶的耗用趨勢。您可以在 CloudWatch 的 `AWS/QuickSight/Aggregate Metrics` 群組中找到這些指標。


| 指標 | Description | 單位 | 
| --- | --- | --- | 
|  SPICECapacityLimitInMB  |  此值表示特定時間點佈建的 SPICE 容量。當耗用或購買導致容量變化為 1 MB 或更多時，此指標將會重新整理。  |  MB  | 
|  SPICECapacityConsumedInMB  |  此值代表特定時間點耗用的 SPICE 容量。當耗用或購買導致容量變化為 1 MB 或更多時，此指標將會重新整理。  |  MB  | 

### 維度
<a name="cw-dimensions"></a>

以下是 Amazon CloudWatch 中顯示的快速指標維度清單。


| 維度 | Description | 
| --- | --- | 
|  DashboardId  |  Amazon Quick Sight 儀表板的公有 ID。 您可以使用 `ListDashboards` API 操作來查看 Amazon Quick 帳戶中每個儀表板的清單。如需詳細資訊，請參閱《*Amazon Quick Sight API 參考*》中的 [ ListDashboards](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-dashboards.html)。  | 
|  DatasetId  |  Amazon Quick Sight 資料集的公有 ID。 您可以使用 `ListDataSets` API 操作來查看 Amazon Quick Sight 帳戶中每個資料集的清單。如需詳細資訊，請參閱《*Amazon Quick Sight API 參考*》中的 [ ListDataSets](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-datasets.html)。  | 
|  SheetId  |  Amazon Quick Sight 工作表的公有 ID。  | 
|  VisualId  |  Amazon Quick Sight 視覺效果的公有 ID。  | 
|  KnowledgeBaseId  |  Amazon Quick Sight 知識庫的公有 ID。  | 
|  QuickInstanceId  |  快速執行個體的公有 ID。  | 
|  ActionConnectorId  |  Quick Action Connector 的公有 ID。  | 
|  ActionConnectorType  |  Quick Action Connector 的類型。  | 
|  ActionId  |  快速動作的公有 ID。  | 
|  InvokeErrorCode  |  與失敗的 Quick Action Connector 調用相關的錯誤代碼。  |