[GitHub] [apisix] SylviaBABY commented on a diff in pull request #7662: docs: refactor kafka-logger plugin doc

[GitBox <gi...@apache.org>]

SylviaBABY commented on code in PR #7662:
URL: https://github.com/apache/apisix/pull/7662#discussion_r947365788


##########
docs/zh/latest/plugins/kafka-logger.md:
##########
@@ -23,40 +29,43 @@ title: kafka-logger
 
 ## 描述
 
-`kafka-logger` 是一个插件，可用作 ngx_lua nginx 模块的 Kafka 客户端驱动程序。
+`kafka-logger` 插件用于将日志作为 JSON 对象推送到 Apache Kafka 集群中。可用作 `ngx_lua` NGINX 模块的 Kafka 客户端驱动程序。
 
-它可以将接口请求日志以 JSON 的形式推送给外部 Kafka 集群。如果在短时间内没有收到日志数据，请放心，它会在我们的批处理处理器中的计时器功能到期后自动发送日志。
+## 属性
 
-有关 Apache APISIX 中 Batch-Processor 的更多信息，请参考。
-[Batch-Processor](../batch-processor.md)
+| 名称                   | 类型    | 必选项 | 默认值          | 有效值                | 描述                                             |
+| ---------------------- | ------- | ------ | -------------- | --------------------- | ------------------------------------------------ |
+| broker_list            | object  | 是     |                |                       | 需要推送的 Kafka 的 broker 列表。                  |
+| kafka_topic            | string  | 是     |                |                       | 需要推送的 topic。                                 |
+| producer_type          | string  | 否     | async          | ["async", "sync"]     | 生产者发送消息的模式。          |
+| required_acks          | integer | 否     | 1              | [0, 1, -1]            | 生产者在确认一个请求发送完成之前需要收到的反馈信息的数量。该参数是为了保证发送请求的可靠性。该属性的配置与 Kafka `acks` 属性相同，具体配置请参考 [Apache Kafka 文档](https://kafka.apache.org/documentation/#producerconfigs_acks)。  |
+| key                    | string  | 否     |                |                       | 用于消息的分区分配的密钥。                             |

Review Comment:
   ```suggestion
   | key                    | string  | 否     |                |                       | 用于消息分区而分配的密钥。                             |
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org