log.retention.bytes 是 Apache Kafka 配置文件中的一个参数，用于指定 Kafka 日志文件的最大存储大小。该参数控制每个日志主题分区（log partition）可以保留的最大字节数。

详细解释：

在 Kafka 中，消息以日志（log）的形式保存在磁盘上，每个日志主题有一个或多个分区，每个分区会存储消息数据。为了控制存储空间的使用，Kafka 允许设置日志的保留策略。

log.retention.bytes 参数指定了 单个分区 中日志数据的最大字节数。也就是说，当一个日志分区的大小达到这个值时，Kafka 将会删除旧的日志文件来为新的日志腾出空间。

作用：

• 控制日志大小：此配置用于限制每个分区的日志存储空间。当分区的大小达到此值时，Kafka 会根据保留策略删除旧的日志数据。
• 自动清理旧数据：当日志文件大小超出该限制时，Kafka 会根据保留策略删除最旧的日志消息，以保持分区的存储大小在指定的限制内。

默认值：

log.retention.bytes 默认值为 -1，表示没有大小限制，即不通过大小来控制日志的保留。Kafka 会依赖 log.retention.ms（日志保留时间）来控制数据的删除。

配置示例：

propertiesCopy Code

log.retention.bytes=1073741824

这个配置会将每个分区的日志文件大小限制为 1 GB（1 GB = 1073741824 字节）。当一个分区的日志大小达到 1 GB 时，Kafka 将会删除最旧的消息，直到日志文件大小不再超过这个限制。

组合使用 log.retention.ms 和 log.retention.bytes：

• log.retention.ms：控制消息的最大保留时间（例如：7 天）。这是时间维度的清理策略。
• log.retention.bytes：控制每个分区的最大日志大小（字节）。这是大小维度的清理策略。

如果同时配置了这两个参数，Kafka 将会根据这两个条件之一触发日志清理。也就是说，日志会在 满足时间条件 或 达到大小限制 时被删除。

使用场景：

• 磁盘空间有限的情况：如果 Kafka 集群的磁盘空间有限，配置 log.retention.bytes 可以防止日志文件占满磁盘空间。
• 高吞吐量的集群：在吞吐量较高的 Kafka 集群中，日志数据会迅速积累，配置此参数可以有效控制存储压力，避免磁盘空间耗尽。
• 与 log.retention.ms 配合使用：通过合理设置时间和大小的结合，能够精细化控制日志数据的存储方式。

配置示例：

假设你有一个 Kafka 集群，并且希望每个分区的日志最大保持 5 GB，而日志文件的最大保留时间为 3 天，可以配置如下：

propertiesCopy Code

log.retention.bytes=5368709120 # 5 GB log.retention.ms=259200000 # 3 天 (3 * 24 * 60 * 60 * 1000 毫秒)

这样，Kafka 会在日志文件达到 5 GB 或 3 天时，根据设置的策略删除旧的消息。

需要注意的事项：

1. 避免过低设置：如果设置的 log.retention.bytes 太小，可能会导致频繁删除数据，这可能会影响消费者的消费进度，尤其是在有高吞吐量或者消费者消费较慢的场景下。
2. 磁盘性能考虑：频繁的日志清理会增加磁盘 I/O 负担，影响集群的性能。因此需要根据实际的硬件和业务需求调整此参数。

总结：

log.retention.bytes 主要用于控制 Kafka 日志分区的最大存储空间，当分区日志的大小达到该限制时，Kafka 会清理最旧的消息来保持分区大小。与时间保留策略（log.retention.ms）配合使用，可以精细控制数据的存储和清理策略，避免过多的磁盘占用。