本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Quick 中进行事件响应、记录和监控
<a name="incident-response-logging-and-monitoring"></a>


|  | 
| --- |
|    目标受众：系统管理员和 Amazon Quick 管理员  | 

有效的事件响应、日志记录和监控对于维护 Amazon Quick 实例的安全性、性能和可靠性至关重要。该监控框架提供对所有Amazon Quick功能的用户活动、系统性能、安全事件和操作指标的多层可见性，包括聊天、空间、流程、操作、研究、控制面板和自定义代理。

Amazon Quick 与 AWS 原生监控和日志服务集成，可提供实时见解和历史分析功能。监控系统可捕获有关用户参与度、对话模式、资源利用率和安全相关事件的详细分析，而 CloudTrail 日志记录可确保完整的审计跟踪，以进行合规和取证分析。

本节内容：
+ **分析和监控**-全面的控制面板和指标，用于跟踪所有 Amazon Quick 功能中的用户采用率、绩效、反馈和安全事件
+ **CloudTrail 记录**-在 Amazon Quick Sight 中完成 API 调用和管理操作的审计跟踪，以实现合规和安全监控
+ **非 API 事件记录**-监控用户互动、内容访问和不生成 API 调用的系统事件
+ **日志分析和解释**-在 Amazon Quick Sight 中了解日志条目、识别安全事件并响应 Amazon Quick Sight 中的操作问题

无论您是在调查安全事件、分析用户行为模式、衡量系统性能还是确保合规性，这些监控和记录功能都能提供维护安全且运行良好的 Amazon Quick 环境所需的可见性和数据。

**Topics**
+ [使用 CloudWatch 日志监控 Amazon Quick 的使用情况](monitoring-quicksuite-chat-feedback-cloudwatch.md)
+ [使用 Amazon Quick Sight 中的事件响应、记录和监控 CloudTrail](incident-response-logging-and-monitoring-qs.md)
+ [使用 Amazon Quick Sight 监控数据 CloudWatch](monitoring-quicksight.md)

# 使用 CloudWatch 日志监控 Amazon Quick 的使用情况
<a name="monitoring-quicksuite-chat-feedback-cloudwatch"></a>

您可以使用 [Amazon CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) s 在 Amazon Quick 中提供聊天对话、用户反馈和 agent/research 工时使用情况，供您分析。这些日志可以传送到多个目的地，例如 CloudWatch Amazon S3 或 Amazon Data Firehose（适用标准费率）。我们建议您在启用 Amazon Quick AI 功能后立即设置销售日志。

以下是您可以使用 Amazon Quick 中的日志完成的任务示例：
+ 通过查看聊天消息内容，找出常见的用户查询和难点。
+ 通过查看 `feedbackReason` 等指标来监控回复的质量。
+ 通过分析反馈数据（包括评论和有用性评级）来了解用户的情绪和满意度。
+ 生成自定义控制面板和报告，以跟踪一段时间内的关键指标和趋势。
+ 识别并分析聊天未返回答案或用户查询被屏蔽的情况
+ 监控代理和研究时间的使用情况

**重要**  
源自对话的日志可能包含聊天中传递的敏感信息或个人身份数据。在设置日志订阅时，您可以从日志中筛选出这些信息。或者，您可以使用日志屏蔽策略屏蔽 CloudWatch 日志中的这些数据。有关更多信息，请参阅 [Help protect sensitive log data with masking](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 日志**-用于实时监控和分析
+ **Amazon S3**-用于长期存储和批处理
+ **Amazon Data Firehose**-用于流媒体分析和数据转换

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

在启用日志记录之前，请确保您已具备以下条件：
+ 具有企业版或专业版订阅的活跃 Amazon Quick 实例
+ 配置日志传输的相应 IAM 权限
+ 为您的日志配置的目的地（日CloudWatch 志、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 日志，请使用以下 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 策略，请参阅 A *mazon [Log CloudWatch s 用户指南中的启用 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 日志 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 日志 API 操作启用用户对话日志记录，请调用`PutDeliverySource``PutDeliveryDestination`、和 `CreateDelivery` API 操作。

**注意**  
将提供输入中资源 ARN 中提及的区域的日志。`PutDeliverySource`

### 验证日志传送
<a name="quicksuite-chat-feedback-verify-log-delivery"></a>

配置完成后，请验证日志是否已传送到您的目的地：
+ **验证设置：**使用 CloudWatch 日志中的 `DescribeDeliveries` API 验证账户中已创建的交付列表。
+ **CloudWatch 日志**：检查指定的日志组中是否有新的日志流。
+ **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*`-网络搜索是否启用
+ `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`-企业版或专业版
+ `reporting_service`-与代理对应的服务：研究、流程或自动化
+ `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 策略
+ **数据保留**：根据您的合规性要求配置适当的保留策略

# 使用 Amazon Quick Sight 中的事件响应、记录和监控 CloudTrail
<a name="incident-response-logging-and-monitoring-qs"></a>

Amazon Quick Sight 已与 AWS CloudTrail。该服务记录用户、角色或 AWS 服务在 Amazon Quick Sight 中执行的操作。 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 本身不支持使用亚马逊 CloudWatch 或其他外部系统发出警报。但是，可以开发自定义解决方案来处理 CloudTrail 日志。

可以在 Service Healt [h Dashboard 上查看 Amazon Quick Sight 服务](https://status.aws.amazon.com/)状态。

默认情况下，传送 CloudTrail 到您的存储桶的日志文件由亚马逊[服务器端加密，使用亚马逊 S3 托管的加密密钥 (SSE-S3) 进行加密](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html)。要提供可直接管理的安全层，您可以改为使用[服务器端加密和 KMS AWS 托管密钥 (SSE-KMS) 来处理](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html)日志文件。 CloudTrail 启用服务器端加密将使用 SSE-KMS 加密日志文件而不加密摘要文件。摘要文件使用 [Simple Storage Service（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>


|  | 
| --- |
|    目标受众：系统管理员  | 

CloudTrail 在您创建 AWS 账户时已在您的账户上启用。当 Amazon Quick Sight 中出现支持的事件活动时，该活动会与其他 AWS 服务 CloudTrail 事件一起记录在**事件历史**记录中。您可以在自己的 AWS 账户中查看、搜索和下载最近发生的事件。有关更多信息，请参阅[使用 CloudTrail 事件历史记录查看事件](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)
+ [配置 Amazon SNS 通知 CloudTrail](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登录 — 本主题包含在跨账户 CloudTrail日志](https://docs.aws.amazon.com/lake-formation/latest/dg/cross-account-logging.html)中包含委托人身份的说明。

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** – 只读

  
+  **AWS 区域 —** AWS 区域

  
+  E@@ **ventSource（quicksight）**— 事件来源（Amazon Quick Sight）

  
+  **事件类型 AwsServiceEvent ()-事件类型（**服务事件）AWS 

  
+  **recipientAccountId （客户 AWS 账户）**-收件人账户 ID（客户 AWS 账户）

  

**注意**  
 CloudTrail 显示用户，就好`unknown`像他们是由 Amazon Quick Sight 配置的。这样显示是因为这些用户不是已知的 IAM 身份类型。

## 使用 CloudTrail 日志跟踪非 API 事件
<a name="logging-non-api"></a>

以下是可以跟踪的非 API 事件的列表。

**User management**
+  **CreateAccount**— 创建账户

  
+ **BatchCreateUser**— 创建用户

  
+ **BatchResendUserInvite**— 邀请用户

  
+ **UpdateGroups**— 更新群组

  此事件仅与企业版配合使用。

  
+ **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

    
  + I@@ **mports3 ManifestFile** — S3 清单文件

    
  + **Presto** – Presto

    
  + **RDS** – RDS

    
  + **Redshift** – Redshift（手动）

    
+ **UpdateDataSource**— 更新数据源

  
+ **DeleteDataSource**— 删除数据源

  

**数据集**
+  **CreateDataSet**— 创建数据集

  
  + **CustomSQL** – 自定义 SQL

    
  + **SQLTable**— SQL 表

    
  + **File** – CSV 或 XLSX

    
+ **UpdateDataSet**— 更新 SQL 联接数据集

  
+ **UpdateDatasetAccess**— 更新数据集访问权限

  
+ **DeleteDataSet**— 删除数据集

  
+ **Querydatabase** – 在数据集刷新期间，查询数据来源。

## 示例：Amazon Quick Sight 日志文件条目
<a name="understanding-quicksight-entries"></a>

 跟踪是一种配置，允许将事件作为日志文件传输到您指定的 Amazon S3 存储桶。 CloudTrail 日志文件包含一个或多个日志条目。一个事件表示来自任何源的一个请求，包括有关所请求的操作、操作的日期和时间、请求参数等方面的信息。 CloudTrail 日志文件不是公用 API 调用的有序堆栈跟踪，因此它们不会以任何特定顺序显示。

以下示例显示了演示该 BatchCreateUser操作的 CloudTrail 日志条目。

```
{ 
   "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"
				]
			}
	   }
   }
```

# 使用 Amazon Quick Sight 监控数据 CloudWatch
<a name="monitoring-quicksight"></a>

Amazon Quick 向亚马逊发送指标 CloudWatch ，您可以使用这些指标近乎实时地观察和响应 Amazon Quick 环境的可用性和性能。目前，您可以监控 Amazon Quick Sight 控制面板、视觉对象和数据集提取以及非结构化数据集和快速操作连接器的指标，从而为读者提供一致、高性能和不间断的 Amazon Quick 体验。

有关使用亚马逊的更多信息 CloudWatch，请参阅[亚马逊 CloudWatch 用户指南](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)。

## 在 Amazon 中访问快速指标 CloudWatch
<a name="access-cw"></a>

使用以下步骤在亚马逊中访问 Amazon Quick 指标 CloudWatch。

**要访问 Amazon Quick 指标，请访问 CloudWatch**

1. 登录与您 AWS 账户 的 Amazon Quick 账户关联的。

1. 在 AWS 管理控制台 主页的左上角，选择 “**服务**”，然后选择。**CloudWatch**

1. 在导航窗格中，选择**指标**、**所有指标**、**QuickSight**。

**Topics**
+ [使用 Amazon CloudWatch 控制台绘制指标图](#cw-graph)
+ [使用 Amazon CloudWatch 控制台创建警报](#cw-alerts)
+ [指标](#cw-metrics)
+ [聚合指标](#cw-aggregate-metrics)
+ [聚合 SPICE 指标](#aggregate-spice-metrics)
+ [Dimensions](#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 会自动向您发送通知。有关示例，请参阅[亚马逊* CloudWatch 用户指南中的创建亚马逊 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>

以下指标跟踪控制面板的查看次数和加载时间。您可以在中的`AWS/QuickSight/Dashboard Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 维度 | 单位 | 
| --- | --- | --- | --- | 
|  DashboardViewCount  |  控制面板被查看的次数。此数字包括所有访问模式，例如 Web、移动和嵌入式。 此指标最有用的统计数据是 `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) 数据集的摄取量。您可以在中的`AWS/QuickSight/Ingestion Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 维度 | 单位 | 
| --- | --- | --- | --- | 
|  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 控制面板上各个视觉对象的加载时间和错误数。您可以在中的`AWS/QuickSight/Visual Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 维度 | 单位 | 
| --- | --- | --- | --- | 
|  VisualLoadTime  |  Amazon Quick Sight 视觉对象接收视觉对象初始绘制所需的查询数据所花费的时间。这包括从客户到 Amazon Quick Sight 服务，然后返回客户的往返查询时间。 此指标最有用的统计数据是 `AVERAGE`，表示设定时段内视觉对象的平均加载时间。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/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_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 

#### 每个非结构化数据集指标
<a name="per-unstructured-dataset-metrics"></a>

以下指标跟踪 Amazon Quick Sight 非结构化数据集的文档统计数据和索引状态。您可以在中的`AWS/QuickSight/QuickInstanceId`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 维度 | 单位 | 
| --- | --- | --- | --- | 
|  QuickIndexDocumentCount  |  非结构化快速索引中的文档数量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  QuickIndexExtractedTextSize  |  非结构化快速索引的提取文本大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  字节  | 
|  QuickIndexPurchasedInMB  |  为非结构化快速索引购买的存储量。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  MB  | 
|  QuickIndexCapacityConsumedRawFileSizeInGB  |  非结构化快速索引消耗的原始文件大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  GB  | 
|  QuickIndexCapacityRawFileSizeLimitInGB  |  非结构化快速索引的原始文件大小限制。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  GB  | 
|  DocumentsCrawled  |  在非结构化快速索引中搜寻的已上传文档数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  DocumentsIndexed  |  在非结构化快速索引中编入索引的文档数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  DocumentsDeleted  |  从非结构化快速索引中删除的文档数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  DocumentsModified  |  在非结构化快速索引中修改的文档数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  DocumentsFailedToIndex  |  未能在非结构化快速索引中编制索引的文档数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  ExtractedTextSize  |  连接器级别同步期间在非结构化快速索引中提取的总文本大小。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  MB  | 

#### 每操作连接器指标
<a name="per-action-connector-metrics"></a>

以下指标跟踪对快速操作连接器的调用次数。您可以在中的`AWS/QuickSight`命名空间下找到这些指标 CloudWatch。


| 指标 | 说明 | 维度 | 单位 | 
| --- | --- | --- | --- | 
|  ActionInvocationCount  |  您的操作连接器被调用的次数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/monitoring-quicksight.html)  |  计数  | 
|  ActionInvocationError  |  您的操作连接器调用失败的次数。  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/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 账户和区域中所有控制面板的查看次数和加载时间。您可以在中的`AWS/QuickSight/Aggregate Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  DashboardViewCount  |  在该地区的整个 Amazon Quick 账户中查看所有 Amazon Quick Sight 控制面板的次数。此数字是一个聚合值，包括所有访问模式，例如 Web、移动和嵌入式。 该指标最有用的统计数据是`SUM`，它表示在设定时间段内 Amazon Quick Sight 控制面板的浏览总数。  |  计数  | 
|  DashboardViewLoadTime  |  加载所有 Amazon Quick Sight 控制面板所需的时间。测量从用户导航到 Amazon Quick Sight 控制面板时开始，并在控制面板的所有视觉效果完成渲染后结束。 该指标最有用的统计数据是`AVERAGE`，它表示在设定时间段内所有 Amazon Quick Sight 控制面板的平均加载时间。  |  毫秒  | 

#### 聚合摄取指标
<a name="aggregate-ingestion-metrics"></a>

以下指标跟踪与Amazon Quick账户关联的所有摄取量，以及. AWS 区域您可以在中的`AWS/QuickSight/Aggregate Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  IngestionErrorCount  |  失败摄取的数量。 此指标最有用的统计数据是 `SUM`，表示设定时段内失败摄取的总数。  |  计数  | 
|  IngestionInvocationCount  |  已启动的摄取数量。这包括通过控制台和 Amazon Quick Sight API 操作启动的计划和手动摄取。 此指标最有用的统计数据是 `SUM`，表示设定时段内启动的摄取的总数。  |  计数  | 
|  IngestionLatency  |  从开始摄取到完成摄取之间的时间段。 此指标最有用的统计数据是 `AVERAGE`，表示设定时段内摄取的平均运行时。  |  秒  | 
|  IngestionRowCount  |  成功行摄取的数量。  此指标最有用的统计数据是 `SUM`，表示设定时段内摄取的总数据量。  |  计数  | 

#### 聚合视觉对象指标
<a name="aggregate-visual-metrics"></a>

以下指标跟踪控制面板和 Amazon Quick 账户中所有视觉对象的加载时间和错误计数。您可以在`AWS/QuickSight/Aggregate Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  VisualLoadTime  |  所有 Amazon Quick Sight 视觉对象接收初始绘制视觉效果所需的查询数据所花费的时间。这包括从客户到 Amazon Quick 服务，然后返回客户的往返查询时间。 此指标最有用的统计数据是 `AVERAGE`，表示设定时段内所有视觉对象的平均加载时间。  |  毫秒  | 
|  VisualLoadErrorCount  |  属于 Amazon Quick 账户的所有 Amazon Quick Sight 视觉效果未能完成初始绘画数据查询的次数。 此指标最有用的统计数据是 `SUM`，表示设定时段内失败的视觉对象的总数。  |  计数  | 

#### 聚合非结构化数据集指标
<a name="aggregate-unstructured-dataset-metrics"></a>

以下指标跟踪某个地区的 Amazon Quick 账户内的所有非结构化数据集指标。您可以在`AWS/QuickSight/Aggregate Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  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 账户关联的所有快速操作连接器调用。您可以在`AWS/QuickSight/Aggregate Metrics`群组下找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  ActionInvocationCount  |  动作连接器调用的次数。 该指标最有用的统计数据是`SUM`，它表示在设定的时间段内启动的操作连接器调用的总数。  |  计数  | 
|  ActionInvocationError  |  操作连接器调用失败的次数。 该指标最有用的统计数据是`SUM`，它表示在设定的时间段内失败的操作连接器调用的总数。  |  计数  | 

### 聚合 SPICE 指标
<a name="aggregate-spice-metrics"></a>

以下指标监控 SPICE 使用信息，以帮助您避免达到可能导致摄取失败的 SPICE 使用上限。统计数据最多可存储 15 个月，因此您可以访问历史信息，更好地了解 Amazon Quick 账户的消费趋势。您可以在`AWS/QuickSight/Aggregate Metrics`群组中找到这些指标 CloudWatch。


| 指标 | 说明 | 单位 | 
| --- | --- | --- | 
|  SPICECapacityLimitInMB  |  此值表示特定时间点的预置 SPICE 容量。当使用或购买的容量更新为 1MB 或更多时，该指标就会刷新。  |  MegaBytes  | 
|  SPICECapacityConsumedInMB  |  此值表示特定时间点使用的 SPICE 容量。当使用或购买的容量更新为 1MB 或更多时，该指标就会刷新。  |  MegaBytes  | 

### Dimensions
<a name="cw-dimensions"></a>

以下是亚马逊上显示的快速指标维度列表 CloudWatch。


| 维度 | 说明 | 
| --- | --- | 
|  DashboardId  |  Amazon Quick Sight 控制面板的公共 ID。 您可以使用 `ListDashboards` API 操作来查看您的 Amazon Quick 账户中每个控制面板的列表。有关更多信息，请参阅[ ListDashboards](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-dashboards.html)《*Amazon Quick Sight API 参考*》。  | 
|  DatasetId  |  Amazon Quick Sight 数据集的公共 ID。 您可以使用 `ListDataSets` API 操作来查看您的 Amazon Quick Sight 账户中每个数据集的列表。有关更多信息，请参阅[ ListDataSets](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-datasets.html)《*Amazon Quick Sight API 参考*》。  | 
|  SheetId  |  Amazon Quick Sight 工作表的公共 ID。  | 
|  VisualId  |  Amazon Quick Sight 视觉效果的公共 ID。  | 
|  KnowledgeBaseId  |  Amazon Quick Sight 知识库的公共 ID。  | 
|  QuickInstanceId  |  Quick 实例的公有 ID。  | 
|  ActionConnectorId  |  快速操作连接器的公共 ID。  | 
|  ActionConnectorType  |  快速操作连接器的类型。  | 
|  ActionId  |  快速操作的公共 ID。  | 
|  InvokeErrorCode  |  与快速操作连接器调用失败相关的错误代码。  |