Temporal 服务限制说明

本页详细介绍了编码到 Temporal 平台中的许多错误和警告（错误是硬限制，一旦达到就会失败；源）

1、标识符的最大长度限制

工作流 ID、工作流类型和任务队列名称等标识符的最大长度为 UTF-8 格式的 1,000 个字符。

2、gRPC 消息接收大小限制

收到的每条 gRPC 消息的限制为 4 MB。此限制适用于临时平台上的所有 gRPC 端点。

3、历史事务提交大小限制

配置 DefaultTransactionSizeLimit为 4 MB，表示持久事件历史记录所允许的最大事务大小。目前此功能不可配置。

4、Blob 大小限制

ps: 包括工作流上下文以及每个工作流和活动参数和返回值；源

• 256 KB 时出现 Temporal 警告：Blob 大小超出限制。
• 2 MB 时的 Temporal 错误：ErrBlobSizeExceedsLimit: Blob data size exceeds limit.

5、历史总大小限制

• 10 MB 时出现 Temporal 警告：history size exceeds warn limit.
• 50 MB 的 Temporal 错误：历史记录大小超出错误限制。

6、历史总计数限制

• 10,240 事件后 Temporal 警告：history size exceeds warn limit。
• 51,200 个事件后出现 Temporal 错误：历史记录大小超出错误限制。

7、命名空间级别的限制

• 每秒操作数：200（峰值为 400）
• 证书：32 KB 有效负载或 16 个证书，以较小者为准
• 并发任务轮询器：2,000（可配置；最多 100,000）

8、并发数大小限制

如果工作流程执行有 2,000 个不完整的活动、信号、子工作流程或外部工作流程取消请求，则该类型的其他命令将无法应用于该工作流程执行：

• ScheduleActivityTask
• SignalExternalWorkflowExecution
• StartChildWorkflowExecution
• RequestCancelExternalWorkflowExecution

批处理作业仅限于每个命名空间一次运行一个作业。

9、每个工作流收到的信号数量限制

每个工作流执行 10,000 个信号是限制，与命名空间级别相关。

10、Prometheus 端点保留数据

Prometheus 端点保留 30 天的数据。（帐户级别）

11、Temporal Cloud 数据默认保留期

默认保留期为 3 天。可以将保留期设置在 1 到 30 天之间。

12、Child Workflow - History 独立于 Parent - 可用于 Partition History 压力

• 每个 Workflow 最多 1000 Child Workflow
  • Child Workflow 的 Child Workflow 不受影响
  • 可以多层级
• 尽量在单层 Workflow History 有压力的时候再使用
  • 尽量 Activities 都在一层 Workflow
• ContinueAsNew - 从新计 History - 用于减缓 History 压力

13、自定义搜索属性限制

创建自定义搜索属性时，属性名称必须遵守以下约束：

• 最大字符数：64
• 允许的字符：[a-zA-Z0-9.,:-_\/ ].

可以为每个命名空间创建的时态云中每种类型的自定义搜索属性的默认最大数量为：

• bool：20
• double：20
• datetime：20
• int：20
• keyword：20
• text: 5

有关可以创建的自定义搜索属性的数量和大小限制的更多信息，请参阅自定义搜索属性限制。

14、Temporal Server 动态指标配置

服务	指标	值	含义	说明
frontend	rps	50000	每个前端服务主机接受的请求的速率限制（请求/秒）。默认 2400
	namespacerps	creator-activitys: 800 growth-material: 800 other: 1500	前端服务上每个命名空间接受的请求的速率限制（请求/秒）。默认 2400
matching	rps	2000	每个匹配服务主机接受的请求的速率限制（请求/秒）。    默认 1200
	numTaskqueueReadPartitions	16	用于读操作的任务队列分区数。默认 4	如果你的工作流执行每秒创建大量工作流和活动任务，可以向任务队列添加更多分区以处理任务的高吞吐量。
	numTaskqueueWritePartitions	16	用于写操作的任务队列分区数。默认 4
history	rps	3000	每个历史服务主机接受的请求的速率限制（请求/秒）。    默认 3000