原创

RocketMQ学习-参数约束和建议

温馨提示：
本文最后更新于 2023年02月08日，已超过 682 天没有更新。若文章内的图片失效（无法正常加载），请留言反馈或直接联系我。

参数约束和建议

Apache RocketMQ 系统中存在很多自定义参数和资源命名，您在使用 Apache RocketMQ 时建议参考如下说明规范系统设置，避对某些具体参数设置不合理导致应用出现异常。

参数建议范围说明
Topic名称字符建议：字母a~z或A~Z、数字0~9以及下划线（）、短划线（-）和百分号（%）。
长度建议：1~64个字符。
系统保留字符：Topic名称不允许使用以下保留字符或含有特殊前缀的字符命名。
保留字符: TBW102 BenchmarkTest SELF_TEST_TOPIC OFFSET_MOVED_EVENT SCHEDULE_TOPIC_XXXX RMQ_SYS_TRANS_HALF_TOPIC RMQ_SYS_TRACE_TOPIC RMQ_SYS_TRANS_OP_HALF_TOPIC
特殊前缀: rmq_sys %RETRY% %DLQ% rocketmq-broker-		Topic命名应该尽量使用简短、常用的字符，避免使用特殊字符。特殊字符会导致系统解析出现异常，字符过长可能会导致消息收发被拒绝。
ConsumerGroup名称字符建议：支持字母a~z或A~Z、数字0~9以及下划线（）、短划线（-）和百分号（%）。
长度建议：1~64个字符。
系统保留字符：ConsumerGroup不允许使用以下保留字符或含有特殊前缀的字符命名。
保留字符: DEFAULT_CONSUMER DEFAULT_PRODUCER TOOLS_CONSUMER FILTERSRV_CONSUMER __MONITOR_CONSUMER CLIENT_INNER_PRODUCER SELF_TEST_P_GROUP SELF_TEST_C_GROUP CID_ONS-HTTP-PROXY CID_ONSAPI_PERMISSION CID_ONSAPI_OWNER CID_ONSAPI_PULL CID_RMQ_SYS_TRANS 特殊字符 * CID_RMQ_SYS * CID_HOUSEKEEPING		无。
ACL Credentials字符建议：AK（AccessKey ID）、SK（AccessKey Secret）和Token仅支持字母a~z或A~Z、数字0~9。
长度建议：不超过1024个字符。		无。
请求超时时间默认值：3000毫秒。
取值范围：该参数为客户端本地行为，取值范围建议不要超过30000毫秒。		请求超时时间是客户端本地同步调用的等待时间，请根据实际应用设置合理的取值，避免线程阻塞时间过长。
消息大小默认值：不超过4 MB。不涉及消息压缩，仅计算消息体body的大小。
取值范围：建议不超过4 MB。		消息传输应尽量压缩和控制负载大小，避免超大文件传输。若消息大小不满足限制要求，可以尝试分割消息或使用OSS存储，用消息传输URL。
消息自定义属性字符限制：所有可见字符。
长度建议：属性的Key和Value总长度不超过16 KB。
系统保留属性：不允许使用以下保留属性作为自定义属性的Key。 保留属性Key		无。
MessageGroup字符限制：所有可见字符。
长度建议：1~64字节。		MessageGroup是顺序消息的分组标识。一般设置为需要保证顺序的一组消息标识，例如订单ID、用户ID等。
消息发送重试次数默认值：3次。
取值范围：无限制。		消息发送重试是客户端SDK内置的重试策略，对应用不可见，建议取值不要过大，避免阻塞业务线程。 如果消息达到最大重试次数后还未发送成功，建议业务侧做好兜底处理，保证消息可靠性。
消息消费重试次数默认值：16次。消费重试次数应根据实际业务需求设置合理的参数值，避免使用重试进行无限触发。重试次数过大容易造成系统压力过量增加。
事务异常检查间隔默认值：60秒。事务异常检查间隔指的是，半事务消息因系统重启或异常情况导致没有提交，生产者客户端会按照该间隔时间进行事务状态回查。 间隔时长不建议设置过短，否则频繁的回查调用会影响系统性能。
半事务消息第一次回查时间默认值：取值等于[事务异常检查间隔] * 最大限制：不超过1小时。无。
半事务消息最大超时时长默认值：4小时。 * 取值范围：不支持自定义修改。半事务消息因系统重启或异常情况导致没有提交，生产者客户端会按照事务异常检查间隔时间进行回查，若超过半事务消息超时时长后没有返回结果，半事务消息将会被强制回滚。 您可以通过监控该指标避免异常事务。
PushConsumer本地缓存默认值：
最大缓存数量：1024条。
最大缓存大小：64 M。
取值范围：支持用户自定义设置，无限制。		消费者类型为PushConsumer时，为提高消费者吞吐量和性能，客户端会在SDK本地缓存部分消息。缓存的消息的数量和大小应设置在系统内存允许的范围内。
PushConsumer重试间隔时长默认值：
非顺序性投递：间隔时间阶梯变化，具体取值，请参见PushConsumer消费重试策略。
顺序性投递：3000毫秒。		无。
PushConsumer消费并发度默认值：20个线程。无。
获取消息最大批次默认值：32条。消费者从服务端获取消息时，一次获取到最大消息条数。建议按照实际业务设置合理的参数值，一次获取消息数量过大容易在消费失败时造成大批量消息重复。
SimpleConsumer最大不可见时间默认值：用户必填参数，无默认值。
取值范围建议：最小10秒；最大12小时。

消费不可见时间指的是消息处理+失败后重试间隔的总时长，建议设置时取值比实际需要耗费的时间稍微长一些。
正文到此结束
所属分类：后端技术
热门推荐
相关文章
说给你听

本文目录
    标签云
    Linux Java Spring Spring Boot 其他 Python Flink Spark MapReduce Sqoop DataX kettle Flume Maxwell Canal Nifi zookeeper Redis kafka Pulsar Elasticsearch LogStash Kibana HDFS HBase Hive Hudi Iceberg DeltaLake SEO quartz
    近期评论
    1. 暂无相关文章
    网站信息
    • 文章总数：47 篇
    • 标签总数：31 个
    • 分类总数：5 个
    • 留言数量：14 条
    • 在线人数：1人
    • 运行天数：787天
    • 最后更新：2022年10月26日11点
    • 系统版本：v2.3.4