要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用适用于 InfluxDB 的 Amazon Timestream 的多可用区只读副本集群
只读副本集群部署是适用于 InfluxDB 的 Amazon Timestream 的一种异步部署模式，允许您配置连接到主数据库实例的只读副本。只读副本集群包含一个写入器数据库实例和一个读取器数据库实例，位于同一 AWS 区域的不同可用区。与多可用区数据库实例部署相比，只读副本集群可提供高可用性以及增加读取工作负载容量。
## 只读副本集群的实例类可用性
只读副本集群部署支持与常规适用于 InfluxDB 的 Timestream 实例相同的实例类型。
****
| 实例类 | vCPU | 内存（GiB） | 存储类型 | 网络带宽（Gbps) |
| --- | --- | --- | --- | --- |
| db.influx.medium | 1 | 8 | 已包含 Influx IOPS | 10 |
| db.influx.large | 2 | 16 | 已包含 Influx IOPS | 10 |
| db.influx.xlarge | 4 | 32 | 已包含 Influx IOPS | 10 |
| db.influx.2xlarge | 8 | 64 | 已包含 Influx IOPS | 10 |
| db.influx.4xlarge | 16 | 128 | 已包含 Influx IOPS | 10 |
| db.influx.8xlarge | 32 | 256 | 已包含 Influx IOPS | 12 |
| db.influx.12xlarge | 48 | 384 | 已包含 Influx IOPS | 20 |
| db.influx.16xlarge | 64 | 512 | 已包含 Influx IOPS | 25 |
| db.influx.24xlarge | 96 | 768 | 已包含 Influx IOPS | 40 |
## 只读副本集群架构
对于只读副本集群，适用于 InfluxDB 的 Amazon Timestream 会使用 InfluxData许可的只读副本插件自动将写入器数据库实例的所有写入复制到所有读取器数据库实例。此复制为异步复制，所有写入操作在写入节点提交后立即得到确认。写入操作无需获得所有读取器节点的确认即可视为成功写入。写入器数据库实例提交数据后，几乎可以立即将数据复制到只读副本实例。如果写入器出现无法恢复的故障，则任何还未复制到至少一个读取器的数据都将丢失。
只读副本实例是写入器数据库实例的只读副本。您可以将从应用程序发出的部分或全部查询路由到只读副本，以减轻写入器数据库实例上的负载。通过这种方法，可以实现弹性横向扩展并超越单个数据库实例的容量限制，以处理读取密集型数据库工作负载。
下图显示主数据库实例正在复制到不同可用区中的只读副本。客户端可以 read/write 访问主数据库实例，也可以对副本进行只读访问。
![\[可用区 A 中的主数据库实例以异步方式复制到可用区 C 中的只读副本实例。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/rr_azs_diagram.png)
## 只读副本集群的参数组
在只读副本集群中，*数据库集群参数组*充当引擎配置值的容器，这些值可应用于只读副本集群中的每个数据库实例。默认数据库参数组基于数据库引擎和数据库引擎版本进行设置。数据库参数组中的设置用于集群中的所有数据库实例。
使用[CreateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_CreateDbCluster.html)或[UpdateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_UpdateDbCluster.html)为多可用区数据库只读副本传递特定的数据库参数组时，请确保将持续时间设置`storage-wal-max-write-delay`为最少 1 小时。如果未指定数据库参数组，`storage-wal-max-write-delay` 默认为 1 小时。
## 只读副本集群中的副本滞后
尽管适用于 InfluxDB 的 Timestream 只读副本集群允许高写入性能，但基于引擎的异步复制的性质仍可能导致副本滞后。这种滞后可能导致失效转移时出现潜在数据丢失，因此必须进行监控。
您可以 CloudWatch 通过在 AWS 管理控制台 导航窗格中选择**所有指标**来跟踪副本延迟。**选择 **timeStream/InfluxD** B，然后选择 By。 DbCluster**选择你的 **DbClusterName**，然后选择你的**DbReaderInstanceName**。在这里，除了为InfluxDB实例的所有Timestream跟踪的常规指标集（参见下面的列表）外，您还将看到 ReplicaLag以毫秒为单位表示的指标。
+ CPUUtilization
+ MemoryUtilization
+ DiskUtilization
+ ReplicaLag （仅适用于副本实例模式的数据库实例）
### 副本滞后的常见原因
一般来说，写入工作负载和读取工作负载过高时，导致读取器数据库实例无法有效应用事务时，就会出现副本滞后。各种工作负载都可能会产生临时或持续副本滞后。以下是一些常见示例：
+ 写入器数据库实例的高写入并发或大量批处理更新，导致读取器数据库实例上的应用过程落后。
+ 在一个或多个读取器数据库实例上使用资源的繁重的读取工作负载。运行速度慢或查询数量多都可能会影响应用进程，继而导致副本滞后。
+ 由于数据库必须保留提交顺序，因此修改大量数据或 DDL 语句的事务有时会暂时加剧副本滞后问题。
有关介绍如何在副本延迟超过设定时间时创建 CloudWatch 警报的教程，请参阅[教程：针对适用于 InfluxD CloudWatch B 的亚马逊 Timestream 的多可用区集群副本延迟创建亚马逊警报](timestream-for-influx-creating-cw-alarms.md#timestream-for-influx-tutorial-alarm)。
### 缓解副本滞后问题
对于适用于 InfluxDB 的 Timestream 只读副本集群，可通过减少写入器数据库实例的负载以缓解副本滞后问题。
## 可用性与持久性
只读副本集群可配置为：在写入器故障时自动切换至其中一个读取器实例以优先保障写入可用性，或避免切换以最大限度减少提示数据丢失。提示数据是指尚未复制到至少一个读取器节点的数据复制间隙（请参阅[只读副本集群中的副本滞后](#timestream-for-influx-replica-lag)）。只读副本集群的默认和推荐行为是在写入器发生故障时自动进行故障转移。然而，如果对于您的使用案例，提示数据丢失比写入可用性更为重要，则可通过更新集群覆盖默认值。
只读副本集群确保集群的所有数据库实例分布在至少两个可用区中，从而在可用区发生故障时提升写入可用性并增强数据持久性。
**Topics**
+ [只读副本集群的实例类可用性](#timestream-for-influx-instance-class-rr)
+ [只读副本集群架构](#timestream-for-influx-rr-cluster-architecture)
+ [只读副本集群的参数组](#timestream-for-influx-rr-param-groups)
+ [只读副本集群中的副本滞后](#timestream-for-influx-replica-lag)
+ [可用性与持久性](#timestream-for-influx-availability)
+ [适用于 InfluxDB 的 Amazon Timestream 只读副本集群的概述](timestream-for-influx-read-replica-overview.md)
+ [创建适用于 InfluxDB 的 Timestream 只读副本集群](timestream-for-influx-create-rr-cluster.md)
+ [连接到适用于 InfluxDB 的 Timestream 只读副本数据库集群](timestream-for-influx-connecting-cluster.md)
+ [修改适用于 InfluxDB 的 Amazon Timestream 只读副本集群](timestream-for-influx-modifying-rr-cluster.md)
+ [在 Amazon Timestream 中重启适用于 InfluxDB 的只读副本集群](timestream-for-influx-rebooting-rr-cluster.md)
+ [创建 CloudWatch 警报以监控亚马逊 Timestream 的 InfluxDB](timestream-for-influx-creating-cw-alarms.md)
+ [读取副本许可 AWS Marketplace](timestream-for-influx-rr-licensing.md)
# 适用于 InfluxDB 的 Amazon Timestream 只读副本集群的概述
以下各节讨论适用于 InfluxDB 的 Timestream 只读副本集群：
**Topics**
+ [只读副本的使用案例](#timestream-for-influx-rr-use-cases)
+ [只读副本的工作原理](#timestream-for-influx-how-rr-work)
+ [适用于 InfluxDB 的 Timestream 只读副本特征](#timestream-for-influx-rr-characteristics)
+ [只读副本实例和存储类型](#timestream-for-influx-rr-instance-storage-types)
+ [删除副本时的注意事项](#timestream-for-influx-rr-deletion)
## 只读副本的使用案例
使用只读副本集群在多种情况下都可行，包括以下情况：
+ 扩展到单个数据库实例的计算或 I/O 容量之外，用于读取密集型数据库工作负载。可以将过多的读取流量引导到一个或多个只读副本。
+ 当主写入器实例不可用时，为读取流量提供服务。在某些情况下，您的主数据库实例可能无法接受 I/O 请求，例如，由于备份 I/O 暂停或定期维护。在这些情况下，可将读取流量引导到只读副本。对于这种使用案例，请注意，由于主数据库实例不可用，因而只读副本中的数据可能处于“静态”。另外，请注意，您需要关闭自动失效转移才能使这些场景正常运行。
+ 对于业务报告或数据仓库方案，您可能希望针对只读副本（而生产数据库实例）运行业务报告查询。
+ 实施灾难恢复。如果主数据库实例出现故障，则将只读副本提升为主副本作为灾难恢复解决方案。
+ 在可用性比持久性更重要的场景中实现更快地失效转移。由于只读副本使用异步复制，因此在失效转移之前，主写入器实例提交的某些数据可能尚未完成复制。然而，对于正常运行时间至关重要的应用程序而言，这种权衡可予以接受。根据工作负载特征，失效转移到只读副本可能远快于失效转移到使用同步复制的备用数据库实例，因为副本实例已在运行，无需启动引擎。这在分秒必争的使用案例中尤其有益。
## 只读副本的工作原理
要创建只读副本集群，适用于 InfluxDB 的 Amazon Timestream 使用许可 InfluxData的只读副本插件。附加订阅是通过直接从亚马逊 Timestream 管理控制台激活的。 AWS Marketplace有关更多详细信息，请参阅[读取副本许可 AWS Marketplace只读副本许可术语](timestream-for-influx-rr-licensing.md)。
只读副本按标准数据库实例计费，费率与集群中每个节点使用的数据库实例类型相同，再加上许可插件 InfluxData的费用。附加组件的费用通过 AWS Marketplace按实例小时数计费。在位于同一个 AWS 区域中的源数据库实例与只读副本之间复制数据所产生的数据传输不收费。
创建并配置只读副本集群，且开始接受写入后，每当主数据库实例发生更改时，适用于 InfluxDB 的 Amazon Timestream 就使用异步复制方法更新只读副本。
只读副本作为专用的数据库实例运行，仅接受只读连接。应用程序可像连接到任何其他数据库实例一样连接到只读副本，从而提供无缝且熟悉的体验。适用于 InfluxDB 的 Amazon Timestream 会自动将所有数据从主数据库实例复制到只读副本，从而确保数据一致性和准确性。请注意，更新在集群级别完成，并同时应用于主集群和副本。
## 适用于 InfluxDB 的 Timestream 只读副本特征
****
| 特征或操作 | 适用于 InfluxDB 的 Timestream |
| --- | --- |
| 复制方法是什么？ | 逻辑复制。 |
| 是否能将副本设置为可写？ | 否，适用于 InfluxDB 的 Timestream 只读副本设计为只读，不能设置为可写。虽然在失效转移时可将只读副本提升为主副本，从而接受写入，但在任何给定时间，适用于 InfluxDB 的 Timestream 只读副本集群中只能有一个写入器数据库实例。这可确保数据一致性，并防止可能由多个可写实例导致的冲突。只读副本的作用是提供数据的冗余只读副本，会自动拒绝写入请求以保持数据完整性。 |
| 是否能在副本上执行备份？ | 是，可使用内置引擎功能通过 Influx CLI 创建备份。 |
| 是否能使用并行复制？ | 否，适用于 InfluxDB 的 Timestream 使用单个进程处理复制。 |
## 只读副本实例和存储类型
将创建与主数据库实例的实例和存储类型相同的只读副本。任何配置更改都必须在集群级别进行，并将应用于集群内的所有实例。可用于适用于 InfluxDB 的 Timestream 数据库实例的所有实例和存储配置，同样可用于适用于 InfluxDB 的 Timestream 只读副本集群。
**实例类型**
****
| 实例类 | vCPU | 内存（GiB） | 存储类型 | 网络带宽（Gbps) |
| --- | --- | --- | --- | --- |
| db.influx.medium | 1 | 8 | 已包含 Influx IOPS | 10 |
| db.influx.large | 2 | 16 | 已包含 Influx IOPS | 10 |
| db.influx.xlarge | 4 | 32 | 已包含 Influx IOPS | 10 |
| db.influx.2xlarge | 8 | 64 | 已包含 Influx IOPS | 10 |
| db.influx.4xlarge | 16 | 128 | 已包含 Influx IOPS | 10 |
| db.influx.8xlarge | 32 | 256 | 已包含 Influx IOPS | 12 |
| db.influx.12xlarge | 48 | 384 | 已包含 Influx IOPS | 20 |
| db.influx.16xlarge | 64 | 512 | 已包含 Influx IOPS | 25 |
| db.influx.24xlarge | 96 | 768 | 已包含 Influx IOPS | 40 |
**存储选项**
****
| 适用于 InfluxDB 的 Timestream 数据库集群存储 | 源数据库实例存储分配 | 已包含 IOPS |
| --- | --- | --- |
| 已包含 Influx IO（3K） | 20GiB 至 16TiB | 3000 IOPS |
| 已包含 Influx IO（12K） | 400GiB 至 16TiB | 12000 IOPS |
| 已包含 Influx IO（16K） | 400GiB 至 16TiB | 16000 IOPS |
## 删除副本时的注意事项
如果不再需要只读副本，可通过调用 `delete-db-cluster` API 显式删除集群。在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。请注意，您目前无法从集群中移除单个节点。
```
aws timestream-influxdb delete-db-cluster \
--region region \
--endpoint endpoint \
--db-cluster-id cluster-id
```
# 创建适用于 InfluxDB 的 Timestream 只读副本集群
适用于 InfluxDB 的 Timestream 只读副本集群包含一个写入器数据库实例和一个读取器数据库实例，位于不同可用区。适用于 InfluxDB 的 Timestream 只读副本集群可提供高可用性、增加读取工作负载的容量以及在配置到副本的失效转移时实现更快的失效转移。
## 数据库集群先决条件
**重要**
以下是创建只读副本集群之前需要完成的先决条件。
**Topics**
+ [为数据库集群配置网络](#timestream-for-influx-config-network)
+ [其他先决条件](#timestream-for-influx-addl-prereqs)
### 为数据库集群配置网络
您只能在虚拟私有云（VPC）中基于 Amazon VPC 服务创建适用于 InfluxDB 的 Timestream 只读副本数据库集群。它必须位于至少 AWS 区域 有三个可用区的中。为数据库集群选择的数据库子网组必须包含至少三个可用区。此配置可确保数据库集群中的每个数据库实例都位于不同的可用区。
要从同一 VPC 中的 EC2 实例以外的资源连接到数据库集群，请手动配置网络连接。
### 其他先决条件
**在创建只读副本集群之前，请考虑以下附加先决条件：**
要定制您的数据库集群的配置参数，请通过必需的参数设置来指定数据库集群参数组。有关创建或修改数据库集群参数组的信息，请参阅[只读副本集群的参数组](timestream-for-influx-working-read-replica.md#timestream-for-influx-rr-param-groups)。
确定要为您的数据库集群指定的 TCP/IP 端口号。有些公司的防火墙将会阻止通往这些默认端口的连接。如果您的公司防火墙阻止默认端口，请为数据库集群选择其他端口。数据库集群中的所有数据库实例均使用相同的端口。
## 创建数据库集群
你可以使用 AWS 管理控制台、或 Amazon Timestream for InfluxDB API 为 InfluxDB 只读副本数据库集群创建 Timestream。 AWS CLI
------
#### [ Using the AWS 管理控制台 ]
通过在**部署设置**部分中选择**带只读副本的集群**，创建适用于 InfluxDB 的 Timestream 只读副本数据库集群。
使用控制台创建只读副本数据库集群：
1. 登录到 [AWS 管理控制台](https://console.aws.amazon.com/timestream)，并打开 Amazon Timestream 控制台。
1. 在的右上角 AWS 管理控制台，选择要 AWS 区域 在其中创建只读副本数据库集群的。
1. 在导航窗格中，选择 **InfluxDB 数据库**。
1. 选择**创建 InfluxDB 数据库**。
1. 在**部署设置**中，选择**带只读副本的集群**。
选择该选项后，将显示一条消息，提示您需要通过 AWS Marketplace 小工具激活订阅。点击**查看订阅选项**。请注意，订阅生效可能需要 1-2 分钟。
![\[创建 InfluxDB 数据库界面，显示新数据库可用的不同部署设置。已选中“带只读副本的集群”选项。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/deployment_settings_rr.jpg)
![\[部署设置界面显示订阅正在进行的消息。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/subscription_in_progress.jpg)
1. 订阅激活后，点击**查看订阅**。
![\[部署设置界面显示订阅现已激活的消息。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/subscription_success_message.jpg)
1. 将弹出一个窗口，显示每个区域中每 vCPU 每实例小时的成本信息。这遵循相同的计算定价模型，即根据您选择的实例类型，对实例处于活动状态的小时数计费。您只需要订阅一次该附加组件，即可在所有可使用适用于 InfluxDB 的 Timestream 的区域创建实例。
![\[订阅选项表单，显示每个区域中每 vCPU 每实例小时的定价详情。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/purchase_subscription.png)
**重要**
要订阅该优惠，您需要拥有 AWSMarketplaceManageSubscriptions 或 AWSMarketplaceFullAccess权限。有关这些权限的更多信息，请查看[控制对 AWS Marketplace 订阅的访问](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html)权限。
1. 确认订阅后，该服务将根据实例所在区域自动选择区域。
1. 在**数据库凭证**中，填写以下字段：
1. 对于**数据库集群名称**，请输入数据库集群的标识符。
1. 提供 InfluxDB 基本的初始配置参数：**用户名**、**组织名称**、**存储桶名称**以及**密码**。
1. 在**实例配置**中，指定**数据库实例类**。选择最适合工作负载需求的实例大小。请注意，此实例类型将用于只读副本数据库集群中的所有实例。
1. 在**存储配置**中，选择适合您需求的**存储类型**。在所有情况下，仅需要配置已分配的存储空间。请注意，此存储类型将用于只读副本数据库集群中的所有实例。
1. 在**连接配置**部分，请确保 InfluxDB 集群与需要连接到适用于 InfluxDB 的 Timestream 数据库实例的客户端位于同一子网中。您还可以在**公共访问**子部分中，选择将数据库实例设为公开可用。
1. 选择**创建 InfluxDB 数据库**。
1. 在 **InfluxDB 数据库**列表中，选择新 InfluxDB 集群的名称，以显示其详细信息。数据库集群具有**正在创建**状态，直到其就绪可供使用。
1. 当状态变为**可用**时，即可连接到该数据库集群。根据数据库实例类和存储量，新实例可能需要等待 20 分钟时间才可用。
![\[数据库集群摘要页面显示两个实例均处于“可用”状态。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/cluster_details_page.png)
1. 创建完成后，您可以点击数据库集群标识符，以检索新创建集群的相关信息。显示实例模式为 **PRIMARY** 的端点是您需要用于写入和引擎管理的端点。
------
#### [ Using the AWS CLI ]
要使用创建数据库实例 AWS Command Line Interface，请使用以下参数调用`create-db-cluster`命令。将每个 *user input placeholder* 替换为您自己的信息。
```
aws timestream-influxdb create-db-cluster \
--region region \
--vpc-subnet-ids subnet-ids \
--vpc-security-group-ids security-group-ids \
--db-instance-type db.influx.large \
--db-storage-type InfluxIOIncludedT2 \
--allocated-storage 400 \
--password password \
--name cluster-name \
--deployment-type MULTI_NODE_READ_REPLICAS \
--publicly-accessible
//--failover-mode is optional and defaults to AUTOMATIC.
```
------
### 创建只读副本集群的设置
有关创建只读副本集群时所选设置的详细信息，请参阅下表。有关这些 AWS CLI 选项的更多信息，请参阅[create-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/timestream-influxdb/create-db-cluster.html)。有关适用于 InfluxDB 的 Amazon Timestream API 参数的更多信息，请参阅。[CreateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_CreateDbCluster.html)
****
| 控制台设置 | 设置说明 | CLI 选项和适用于 InfluxDB 的 Timestream API 参数 |
| --- | --- | --- |
| 分配的存储空间 | 为数据库集群中的每个数据库实例分配的存储量（以 GiB 为单位）。有关更多信息，请参阅[InfluxDB 实例存储](timestream-for-influxdb.md#timestream-for-influx-dbi-storage)。 | **CLI 选项：**`--allocated-storage` **API 参数：**`allocatedStorage` |
| 数据库端口 | InfluxDB 接受连接的端口号。 有效值：1024-65535 默认值：8086 限制：该值不能为 2375-2376、7788-7799、8090 或 51678-51680。 | **CLI 选项：**`--port` **API 参数：**`port` |
| 数据库集群名称 | 唯一标识数据库集群的名称。每个客户和每个区域的数据库实例名称都必须具有唯一性。 | **CLI 选项：**`--name` **API 参数：**`name` |
| 数据库实例类型 | 适用于 InfluxDB 的 Timestream 数据库集群中各数据库实例（例如 db.influx.xlarge）的计算和内存容量。如有可能，请选择足够大的数据库实例类以便典型查询工作集能够保留在内存中。如果在内存中保留工作集，系统可以避免写入到磁盘，从而提高性能。 | **CLI 选项：**`--db-instance-type` **API 参数：**`dbInstanceType` |
| 数据库集群参数组 | 要分配给数据库集群的数据库参数组 ID。数据库参数组指定数据库的配置方式。例如，数据库参数组可指定查询并发的限制。 | **CLI 选项：**`--db-parameter-group-identifier` **API 参数：**`dbParameterGroupIdentifier` |
| 部署类型 | 指定将数据库集群部署为多节点只读副本还是多可用区多节点只读副本。 可能的值：`MULTI_NODE_READ_REPLICAS` | **CLI 选项：**`--deployment-type` **API 参数：**`deploymentType` |
| VPC 子网 ID | 要用于数据库集群的数据库子网 ID。选择选择现有以使用现有的数据库子网组，然后从现有数据库子网组下拉列表中，选择所需的子网组。选择自动设置，让适用于 InfluxDB 的 Timestream 选择兼容的数据库子网组。 | **CLI 选项：**`--vpc-subnet-ids` **API 参数：**`vpcSubnetIds` |
| Organization（组织） | InfluxDB 中初始管理员用户的初始组织名称。InfluxDB 组织是用户组的工作空间。 | **CLI 选项：**`--organization` **API 参数：**`organization` |
| 存储桶 | 初始 InfluxDB 存储桶的名称。所有 InfluxDB 数据都存储在存储桶中。存储桶结合数据库的概念和保留期（每个数据点存在的持续时间）。存储桶属于组织。 | **CLI 选项：**`--bucket` **API 参数：**`bucket` |
| 日志导出 | 用于将 InfluxDB 引擎日志发送至指定 S3 存储桶的配置。 S3 存储桶日志传输的配置：`s3Configuration -> (structure)` 要向其传输日志的 S3 存储桶名称：`bucketName -> (string)` 指示是否启用向 S3 存储桶传输日志：`enabled -> (boolean)` 速记语法：`s3Configuration={bucketName=string, enabled=boolean}` | **CLI 选项：**`--log-delivery-configuration` **API 参数：**`logDeliveryConfiguration` |
| 密码 | 在 InfluxDB 中创建的初始管理员用户的密码。此密码将允许您访问 InfluxDB UI 以执行各种管理任务，还可以使用 InfluxDB CLI 创建运算符令牌。这些属性将存储在账户的 AWS Secrets Manager 中创建的密钥中。 | **CLI 选项：**`--password` **API 参数：**`password` |
| 用户名 | 在 InfluxDB 中创建的初始管理员用户的用户名。必须以字母开头，且不能以连字符结束或包含两个连续的连字符。例如，my-user1。此用户名将允许您访问 InfluxDB UI 以执行各种管理任务，还可以使用 InfluxDB CLI 创建运算符令牌。这些属性将存储在账户的 AWS Secrets Manager 中创建的密钥中。 | **CLI 选项：**`--username` **API 参数：**`username` |
| 公有访问权限 | 指示是否可从 VPC 外部访问数据库集群。请选择**可公开访问**，为数据库集群提供公有 IP 地址，这表示可在 VPC 外部访问该实例。要可供公开访问，数据库集群还必须在 VPC 的公有子网中。 请选择**不可公开访问**，以设置只能从 VPC 内部访问数据库集群。 | **CLI 选项：**`--publicly-accessible``--no-publicly-accessible` **API 参数：**`publiclyAccessible` |
| 数据库存储类型 | InfluxDB 数据。根据工作负载的要求，您可以在三种不同类型的预置 Influx IOPS 内含存储之间进行选择： 可能的值： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/timestream-for-influx-create-rr-cluster.html) | **CLI 选项：**`--db-storage-type``--no-publicly-accessible` **API 参数：**`dbStorageType` |
| VPC 安全组 | IDs 要与数据库实例关联的 VPC 安全组列表。 | **CLI 选项：**`--vpc-security-group-ids``--no-publicly-accessible` **API 参数：**`vpcSecurityGroupIds` |
| VPC 子网 IDs | IDs 要与数据库实例关联的 VPC 子网列表。使用 InfluxDB 数据库集群的 Timestream 部署时， IDs 在不同的可用区中至少提供两个 VPC 子网。 | **CLI 选项：**`--vpc-subnet-ids` **API 参数：**`vpcSubnetIds` |
| 失效转移模式 | 集群如何响应主实例故障。可使用以下选项进行配置：`AUTOMATIC`：如果主实例失败，系统会自动将只读副本提升为新的主实例。 `NO_FAILOVER`：如果主实例失败，系统会尝试在不提升只读副本的情况下还原主实例。在主实例还原之前，集群将保持不可用状态。 | **CLI 选项：**`--failover-mode` **API 参数：**`failoverMode` |
**重要**
作为数据库集群响应对象的一部分，您将收到 `influxAuthParametersSecretArn`。这将在账户中保存 Secrets Manager 密钥的 ARN。仅在 InfluxDB 数据库实例可用后才会进行填充。该密钥包含 `CreateDbInstance` 过程中提供的 Influx 身份验证参数。这是**只读**副本，因为此密钥的任何updates/modifications/deletions副本都不会影响创建的数据库实例。如果您删除此密钥，我们的 API 响应仍将引用已删除的密钥 ARN。
# 连接到适用于 InfluxDB 的 Timestream 只读副本数据库集群
适用于 InfluxDB 的 Timestream 只读副本数据库集群包含两个可访问的数据库实例，而不是单个数据库实例。每个连接均由特定的数据库实例处理。在连接到只读副本数据库集群时，您指定的主机名和端口将指向名为*端点* 的完全限定域名。
主（写入器）端点将连接到只读副本数据库集群的写入器数据库实例，该实例同时支持读取和写入操作。读取器端点连接到读取器数据库实例，该实例仅支持读取操作。
通过使用端点，您可以根据使用案例将每个连接映射到相应的数据库实例。例如，要执行管理或写入语句，您可以连接到作为写入器数据库实例的任一数据库实例。要执行查询，您可以连接到读取器端点。对于诊断或优化，您可以连接到特定数据库实例端点 `/metrics`，以检查有关特定数据库实例的详细信息。
有关连接到数据库实例的信息，请参阅[连接到适用于 InfluxDB 的 Amazon Timestream 数据库实例](timestream-for-influx-db-connecting.md)。有关连接到只读副本集群的更多信息，请参阅以下主题。
## 只读副本集群端点的类型
端点由包含主机地址的唯一标识符表示。每个适用于 InfluxDB 的 Timestream 集群均包含：
+ 集群端点。
+ 集群只读端点。
+ 集群中每个实例的实例端点。
### 集群端点
只读副本集群的*集群端点*（或*写入器端点*）连接到该数据库集群的当前写入器数据库实例。此端点是唯一可执行写入操作的端点，例如：
+ InfluxDB 专属管理命令，例如创建、修改或删除组织、用户、存储桶、任务等。
+ 向数据库集群写入数据。
需使用集群端点执行数据库集群的所有写入操作，包括写入、更新插入、删除，以及所有配置和管理更改。
此外，您还可以对读取操作（如查询）使用集群端点。
如果数据库集群的当前写入器数据库实例失败，只读副本集群将自动故障转移到其中一个副本，并将其提升为新的写入数据库实例。在故障转移期间，数据库集群将继续为从新的写入器数据库实例到集群端点的请求提供服务，对服务造成的中断最少。部署新的副本之前，提升为写入器的只读副本端点将停止提供读取服务。
以下示例介绍只读副本集群的集群端点。
```
ipvtdwa5se-wmyjrrjko.us-west-2.timestream-influxdb.amazonaws.com
```
### 只读端点
*只读端点*连接到集群中的任何一个只读副本实例。只读副本将仅支持读取操作，例如 Flux 或 InfluxQL 查询；换言之，所有操作均通过 Flux 查询的 `/api/v2/query` 端点或 InfluxQL v1 兼容查询的 `/api/query` 端点执行。通过在读取器数据库实例上处理这些语句，此端点可减少写入器数据库实例上的开销。这也有助于集群处理更高的并发查询量。
以下示例介绍只读副本集群的读取器端点。读取器端点的只读意图由集群端点名称中的 `-ro` 指示。
```
ipvtdwa5se-wmyjrrjko-ro.us-west-2.timestream-influxdb.amazonaws.com
```
### 实例端点
*实例端点*连接到只读副本集群中的特定数据库实例。数据库集群中的每个数据库实例具有自己的唯一实例端点。因此，数据库集群（主集群）的当前写入器数据库实例具有一个实例端点，并且数据库集群中的每个读取器数据库实例都具有一个实例端点。
实例端点提供对数据库集群连接的直接控制。此控制可以帮助您解决可能不适合使用集群端点或读取器端点的场景。例如，客户端应用程序可能根据工作负载类型需要更精细的负载均衡。在这种情况下，您可以配置多个客户端以连接到数据库集群中的不同读取器数据库实例，以便分配读取工作负载。
以下示例介绍只读副本集群中数据库实例的实例端点。
```
mydbinstance-123456789012.us-east-1.timestream-influxdb.amazonaws.com
```
# 修改适用于 InfluxDB 的 Amazon Timestream 只读副本集群
只读副本集群包含一个写入器数据库实例和一个读取器数据库实例，位于不同可用区。与多可用区部署相比，只读副本集群可提供高可用性、增加的读取工作负载容量以及更快的失效转移。有关只读副本集群的更多信息，请参阅[适用于 InfluxDB 的 Amazon Timestream 只读副本集群的概述](timestream-for-influx-read-replica-overview.md)。
您可以修改只读副本集群以更改其设置。
**重要**
您无法修改只读副本集群中的数据库实例。所有修改都必须在数据库集群级别完成。
您可以使用 AWS 管理控制台、或 Amazon Timestream for InfluxDB API 修改只读副本集群。 AWS CLI
## 修改适用于 InfluxDB 的 Amazon Timestream 只读副本集群
------
#### [ Using the AWS 管理控制台 ]
使用控制台修改只读副本数据库集群：
1. 登录到 [AWS 管理控制台](https://console.aws.amazon.com/timestream)，并打开 Amazon Timestream 控制台。
1. 在导航窗格中，选择 **InfluxDB 数据库**，然后选择您希望修改的只读副本集群。
1. 选择**修改**。此时会显示**修改数据库集群**页面。
1. 根据需要选择任意设置。有关每项设置的信息，请参阅[修改只读副本集群的设置](#timestream-for-influx-rr-modify-settings)。
1. 完成更改后，选择**继续**并查看修改摘要。
1. 在确认页面上，检查您的更改。如果更改正确无误，请选择 **Modify DB cluster**（修改数据库集群）以保存更改。或者，选择**返回**以编辑更改，或者选择**取消**以取消更改。
**重要**
目前，适用于 InfluxDB 的 Amazon Timestream 仅支持**立即应用**对只读副本集群的更新。如果您确认更改，则在应用更改期间，数据库集群将出现停机时间。
------
#### [ Using the AWS CLI ]
要使用修改数据库实例 AWS Command Line Interface，请使用带有以下参数的`update-db-cluster`命令。将每个 *user input placeholder* 替换为您自己的信息。
```
aws timestream-influxdb update-db-cluster \
--region region \
--db-cluster-id db-cluster-id \
--db-instance-type db.influx.4xlarge \
--port 10000 \
--failover mode NO_FAILOVER
```
------
## 修改只读副本集群的设置
有关可用于修改只读副本集群的设置详细信息，请参见下表。有关这些 AWS CLI 选项的更多信息，请参阅[update-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/timestream-influxdb/update-db-cluster.html)。
****
| 控制台设置 | 设置说明 | CLI 选项和适用于 InfluxDB 的 Timestream API 参数 |
| --- | --- | --- |
| 数据库端口 | InfluxDB 接受连接的端口号。 有效值：1024-65535 默认值：8086 限制：该值不能为 2375-2376、7788-7799、8090 或 51678-51680。 | **CLI 选项：**`--port` **API 参数：**`port` |
| 数据库实例类型 | 适用于 InfluxDB 的 Timestream 数据库集群中各数据库实例（例如 db.influx.xlarge）的计算和内存容量。如有可能，请选择足够大的数据库实例类以便典型查询工作集能够保留在内存中。如果在内存中保留工作集，系统可以避免写入到磁盘，从而提高性能。 | **CLI 选项：**`--db-instance-type` **API 参数：**`dbInstanceType` |
| 数据库集群参数组 | 要分配给数据库集群的数据库参数组 ID。数据库参数组指定数据库的配置方式。例如，数据库参数组可指定查询并发的限制。 | **CLI 选项：**`--db-parameter-group-identifier` **API 参数：**`dbParameterGroupIdentifier` |
| 日志导出 | 用于将 InfluxDB 引擎日志发送至指定 S3 存储桶的配置。 S3 存储桶日志传输的配置：`s3Configuration -> (structure)` 要向其传输日志的 S3 存储桶名称：`bucketName -> (string)` 指示是否启用向 S3 存储桶传输日志：`enabled -> (boolean)` 速记语法：`s3Configuration={bucketName=string, enabled=boolean}` | **CLI 选项：**`--log-delivery-configuration` **API 参数：**`logDeliveryConfiguration` |
| 失效转移模式 | 使用以下选项配置集群对主实例故障的响应方式：`AUTOMATIC`：如果主实例失败，系统会自动将只读副本提升为新的主实例。 `NO_FAILOVER`：如果主实例失败，系统会尝试在不提升只读副本的情况下还原主实例。在主实例还原之前，集群将保持不可用状态。 | **CLI 选项：**`--failover-mode` **API 参数：**`failoverMode` |
# 在 Amazon Timestream 中重启适用于 InfluxDB 的只读副本集群
如果出现任何运行状况问题，您可以重启只读副本集群。
## 为适用于 InfluxDB 的 Amazon Timestream 重启只读副本集群
------
#### [ Using the AWS 管理控制台 ]
要使用控制台重启只读副本数据库集群，请执行以下操作：
1. 登录到 [AWS 管理控制台](https://console.aws.amazon.com/timestream)，并打开 Amazon Timestream 控制台。
1. 在导航窗格中，选择 **InfluxDB 数据库**，然后选择要重启的只读副本集群。
1. 选择 “**重新启动数据库**”。
1. 选择 “**确认并重新启动**”。
------
#### [ Using the AWS CLI ]
要使用重启数据库实例 AWS Command Line Interface，请使用带有以下参数的`reboot-db-cluster`命令。将每个 *user input placeholder* 替换为您自己的信息。
```
aws timestream-influxdb reboot-db-cluster \
--region region \
--db-cluster-id db-cluster-id \
```
------
# 创建 CloudWatch 警报以监控亚马逊 Timestream 的 InfluxDB
您可以创建一个 CloudWatch 警报，当警报状态发生变化时，该警报会发送 Amazon SNS 消息。警报会监控您指定的时间段内的某个指标。此外，警报会根据指标值在多个时间段内对比给定阈值的情况执行一项或多项操作。操作是向 Amazon SNS 主题或 Amazon EC2 Auto Scaling 策略发送的通知。
警报仅针对持续的状态变化调用操作。 CloudWatch 警报不会仅仅因为它们处于特定状态就调用操作。该状态必须改变并在指定数量的时间段内一直保持。
你可以为 InfluxDB 的 Timestream 的任何可用指标设置 CloudWatch 警报，包括、`CPUUtilization``MemoryUtilization`、`DiskUtilization`和。`ReplicaLag`
我们建议您开始为InfluxDB数据库的时间流创建`DiskUtilization`相关的警报，因为 out-of-storage空间问题可能会给InfluxDB带来相当大的问题。我们建议将警报设置为在 `DiskUtilization` 超过约 75-80% 时发送。
## 要使用设置警报 AWS CLI
调用 `put-metric-alarm`。有关更多信息，请参阅《AWS CLI 命令参考》**中的 [put-metric-alarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html)。
## 使用 CloudWatch API 设置警报
调用 `PutMetricAlarm`。有关更多信息，请参阅 *Amazon CloudWatch API 参考[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)*中的。有关设置 Amazon SNS 主题和创建警报的更多信息，请参阅使用[亚马逊 CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)警报。
## 教程：针对适用于 InfluxD CloudWatch B 的亚马逊 Timestream 的多可用区集群副本延迟创建亚马逊警报
您可以创建一个 Amazon CloudWatch 警报，当多可用区数据库集群的副本延迟超过阈值时，该警报会发送 Amazon SNS 消息。告警会在您指定的时间范围内监控 `ReplicaLag` 指标。操作是向 Amazon SNS 主题或 Amazon EC2 Auto Scaling 策略发送的通知。
### 为多可用区数据库集群副本延迟设置 CloudWatch 警报
1. 登录 AWS 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch)。
1. 在导航窗格中，选择**警报**，然后选择**所有警报**。
1. 选择 **Create Alarm (创建警报)**。
1. 在 **Specify metric and conditions (指定指标和条件)** 页面上，选择 **Select metric (选择指标)**。
1. 在搜索框中，输入数据库集群的名称，选择 **TimeStream/InfluxDB、B** **y DbCluster**，然后选择您的集群。
![\[“选择指标” 页面显示了一个空 CloudWatch 图表和两个时间流，供InfluxDB排序选项可供选择。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/select_metric_page.png)
1. 下图显示**选择指标**页面，其中已选择名为 `inframonitoringcluster` 的只读副本集群。选择您要为其（本例中为 `ReplicaLag`）创建警报的指标。点击**选择指标**。
![\[“选择指标” 页面显示了一个空 CloudWatch 图表和七个 CloudWatch 指标可供选择。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/select_metric_cluster_selected.png)
1. 在**指定指标和条件**页面上，自定义以下字段：
![\[“指定指标和条件”页面显示为 inframonitoringcluster 集群选定的设置。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/replica_lag_metrics_conditions.png)
1. 在**时段**部分，选择计算的时间段。
1. 设置与警报相关的条件。对于**阈值类型**，可以在**静态**和**异常检测**之间进行选择。
在此情况下，我们将使用**静态**，因为我们了解工作负载的行为。每个工作负载对“正常运行”状态的要求可能存在差异。
1. 选择阈值。对于**静态**阈值，这些值以毫秒为单位。
1. 选择**下一步**。
1. 在**通知**部分的**配置操作**页面中，自定义以下设置：
![\[“配置操作”页面显示六种不同操作的列表。“通知”部分已完成。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/configure_actions.png)
1. 对于**警报状态触发器**，选择**在警报中**。
1. 在**向以下 SNS 主题发送通知**中，选择**新建主题**。
1. 输入接收通知的唯一主题名称和有效电子邮件地址。
1. 选择**创建主题**。向下滚动并选择**下一步**。
1. 在**添加名称和说明**页面中，输入 **警报名称**和**警报说明**。选择**下一步**。
![\[“添加名称和说明”页面显示警报名称和警报说明的字段。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/add_name_desc.png)
1. 在**预览和创建**页面上，查看警报设置，然后选择**创建警报**。
**重要**
为确保适用于 InfluxDB 的 Timestream 集群处于正常运行状态，我们还建议您进行监控，并为持续超过 85% 正常使用率的 `CPUUtilization` 和 `MemoryUtilization`，以及超过 75% 使用率的 `DiskUtilization` 设置警报。
# 读取副本许可 AWS Marketplace
要将 Timestream 用于 InfluxDB 只读副本，你需要通过激活 InfluxDB 只读副本的 Timestream 附加许可证。 AWS Marketplace许可证激活后，您将按小时费率支付使用只读副本集群的费用。您只需为只读副本集群处于活动状态的小时数付费。如果您订阅许可证，但未启用适用于 InfluxDB 的 Timestream 只读副本集群，则无需支付任何费用。
**Topics**
+ [只读副本许可术语](#timestream-for-influx-rr-licensing-terminology)
+ [付款和计费](#timestream-for-influx-rr-license-billing)
+ [在 Marketplace 列表上订阅 InfluxDB 只读副本附加组件](#timestream-for-influx-subscribe-rr-add-on)
## 只读副本许可术语
本页在讨论与 InfluxDB 集成的亚马逊 Timestream 时使用了以下术语。 AWS Marketplace
**SaaS 订阅**
在中 AWS Marketplace， software-as-a-service（SaaS）产品（例如 pay-as-you-go许可模式）采用基于使用量的订阅模式。 InfluxData，只读副本插件的软件销售商，会跟踪您的使用情况，您只需为实际用量付费。
**InfluxData 商城费用**
按照 InfluxDB 只读副本附加软件许可证使用情况收取的费用。 InfluxData这些服务费按量计费， AWS Marketplace 并显示在 AWS 账单上的该 AWS Marketplace 部分下。
**适用于 InfluxDB 的 Amazon Timestream 费用**
向亚马逊 Timestream AWS 收取的 InfluxDB 服务费用，其中不包括将 Timestream 用于 InfluxDB 只读副本集群时的许可证。使用InfluxDB服务的费用通过Amazon Timestream计量，并显示在您的账单上。 AWS
## 付款和计费
InfluxDB 的 Timestream 与集成， AWS Marketplace 为只读副本插件提供按小时计费的 pay-as-you-go许可证。只读副本 Marketplace 费用涵盖只读副本附加组件软件的许可费用，Amazon Timestream 费用涵盖使用适用于 InfluxDB 的 Timestream 只读副本集群所产生的费用。有关定价的信息，请参阅 [Amazon Timestream 定价](https://aws.amazon.com/timestream/pricing)。
要停止收取这些费用，则必须删除所有适用于 InfluxDB 的 Timestream 只读副本集群。此外，您还可以取消对只读副本附加许可证 AWS Marketplace 的订阅。如果在未删除只读副本集群的情况下取消订阅，Amazon Timestream 将继续向您收取只读副本集群的使用费用。有关更多信息，请参阅[删除副本时的注意事项](timestream-for-influx-read-replica-overview.md#timestream-for-influx-rr-deletion)。
您可以在 AWS Billing 控制台，查看适用于 InfluxDB 的 Timestream 只读副本集群的账单并管理相关付款。您的账单包括两项费用：一项是您通过使用许可附加组件 InfluxData的费用 AWS Marketplace，另一项是您使用Amazon Timestream的费用。有关更多信息，请参阅《AWS 账单与成本管理 用户指南》**中的[了解您的账单](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html)。
## 在 Marketplace 列表上订阅 InfluxDB 只读副本附加组件
要通过使用只读副本附加许可证 AWS Marketplace，您必须使用 Amazon Timestream AWS 管理控制台 订阅 InfluxDB 只读副本附加组件。你无法通过 AWS CLI 或 InfluxDB 的 Timestream API 来完成这些任务。
**Topics**
+ [从亚马逊 Timestream 订阅 AWS 管理控制台](#timestream-for-influx-subscribe-console)
+ [在中订阅 InfluxDB 只读副本插件 AWS Marketplace](#timestream-for-influx-subscribe-marketplace)
**注意**
如果要使用 AWS CLI 或 InfluxDB 的 Timestream API 创建只读副本集群，则必须先完成此步骤。
### 从亚马逊 Timestream 订阅 AWS 管理控制台
您可以使用 Timestream 管理控制台订阅 InfluxDB 只读副本附加组件。启动**创建 InfluxDB 数据库**流程，并按照步骤操作。有关更多信息，请参阅 [创建适用于 InfluxDB 的 Timestream 只读副本集群](timestream-for-influx-create-rr-cluster.md)。
### 在中订阅 InfluxDB 只读副本插件 AWS Marketplace
要将 InfluxDB 附加许可与一起使用 AWS Marketplace，您需要有效 AWS Marketplace 订阅 InfluxDB 只读副本附加组件。您需要订阅单个附加组件优惠，这使您能够在任何可用区域创建所需的任何实例类型。有关 AWS Marketplace 订阅的信息，请参阅《AWS Marketplace 买家指南》**中[通过 AWS Marketplace的 SaaS 产品](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html#saas-pricing-models)。
建议您在开始创建数据库实例*之前*，在 AWS Marketplace 中订阅 InfluxDB。
1. 导航到[AWS Marketplace](https://console.aws.amazon.com/marketplace)并搜索 InfluxData。
![\[InfluxDB 只读副本插件的时间流出现在搜索中。 AWS Marketplace\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/search_mkt_influxdb.png)
1. 选择**适用于 InfluxDB 的 Timestream 只读副本（附加组件）**。
1. 选择**查看购买选项**。
1. 查看最终用户许可协议，并选择**订阅**。
![\[适用于 InfluxDB 的 Timestream 只读副本附加组件的优惠和定价详情。\]](http://docs.aws.amazon.com/zh_cn/timestream/latest/developerguide/images/kronos/addon_details.png)
1. 现在，您可以使用 Timestream 管理控制台、CLI 或 API 创建适用于 InfluxDB 的 Timestream 只读副本集群。