本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 CloudWatch Logs 監控 Amazon Quick 用量
您可以使用 [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)。
## 支援的日誌目的地
Amazon Quick 可以將日誌交付至下列目的地：
+ **Amazon CloudWatch Logs** - 用於即時監控和分析
+ **Amazon S3** - 用於長期儲存和批次處理
+ **Amazon Data Firehose** - 用於串流分析和資料轉換
## 先決條件
在啟用記錄之前，請確定您有：
+ 具備企業或專業訂閱的作用中 Amazon Quick 執行個體
+ 設定日誌交付的適當 IAM 許可
+ 為您的日誌設定的目的地 (CloudWatch Logs、Amazon S3 儲存貯體或 Firehose)
## 設定 記錄
若要啟用 Amazon Quick 聊天和意見回饋的記錄，您需要設定 IAM 許可、建立交付來源和目的地，並確認日誌已成功交付。
**Topics**
+ [設定 IAM 許可](#quicksuite-chat-feedback-setup-iam-permissions)
+ [設定日誌訂閱](#quicksuite-chat-feedback-configure-log-subscription)
+ [驗證日誌交付](#quicksuite-chat-feedback-verify-log-delivery)
### 設定 IAM 許可
若要設定 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:*"
}
}
}
```
### 設定日誌訂閱
如需具有特定記錄目的地所有必要許可的 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 中提到的區域使用。
### 驗證日誌交付
設定完成後，請確認日誌已交付至您的目的地：
+ **驗證設定：**使用 CloudWatch Logs 中的 `DescribeDeliveries` API 驗證已在帳戶中建立的交付清單。
+ **CloudWatch Logs**：檢查指定的日誌群組是否有新的日誌串流。
+ **Amazon S3**：監控儲存貯體是否有新的日誌檔案。
+ **Firehose**：確認資料正在流經您的交付串流。
## 日誌結構描述和格式
Amazon Quick 日誌遵循結構化結構描述，其中包含所有日誌類型共用的通用欄位，以及聊天和意見回饋日誌的特定欄位。
### 常用欄位
所有日誌事件都包含下列常見欄位：
+ `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"`)
### 聊天日誌
聊天日誌會擷取對話互動，並包含下列欄位：
+ `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"}]
}
```
### 意見回饋日誌
意見回饋日誌會擷取使用者對聊天的意見回饋，並包含下列欄位：
+ `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"
}
```
## 客服人員/研究時數日誌
此日誌類型會擷取您 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 時需要明確指定這些項目。
## 安全考量
+ **加密**：針對敏感資料使用客戶受管 AWS KMS 金鑰
+ **存取控制**：實作最低權限的 IAM 政策
+ **資料保留**：為您的合規要求設定適當的保留政策