SylviaBABY commented on code in PR #7602:
URL: https://github.com/apache/apisix/pull/7602#discussion_r936377349
##########
docs/zh/latest/plugins/tcp-logger.md:
##########
@@ -23,34 +29,30 @@ title: tcp-logger
## 描述
-`tcp-logger` 是用于将日志数据发送到 TCP 服务的插件。
-
-以实现将日志数据以 JSON 格式发送到监控工具或其它 TCP 服务的能力。
-
-该插件提供了将 Log Data 作为批处理推送到外部 TCP
服务器的功能。如果您没有收到日志数据，请等待一些时间，它会在我们的批处理处理器中的计时器功能到期后自动发送日志。
+`tcp-logger` 插件可用于将日志数据发送到 TCP 服务器。
-有关 Apache APISIX 中 Batch-Processor 的更多信息，请参考：
-[Batch-Processor](../batch-processor.md)
+该插件还实现了将日志数据以 JSON 格式发送到监控工具或其它 TCP 服务的能力。
## 属性
-| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
| ---------------- | ------- | ------ | ------ | ------- |
------------------------------------------------ |
-| host | string | 必须 | | | TCP 服务的 IP 地址或主机名
|
-| port | integer | 必须 | | [0,...] | 目标端口
|
-| timeout | integer | 可选 | 1000 | [1,...] | 发送数据超时间
|
-| tls | boolean | 可选 | false | | 用于控制是否执行 SSL 验证
|
-| tls_options | string | 可选 | | | TLS 选项
|
-| include_req_body | boolean | 可选 | | | 是否包括请求 body
|
+| host | string | 是 | | | TCP 服务器的 IP 地址或主机名。
|
+| port | integer | 是 | | [0,...] | 目标端口。
|
+| timeout | integer | 否 | 1000 | [1,...] | 发送数据超时间。
|
+| tls | boolean | 否 | false | | 用于控制是否执行 SSL 验证。
|
+| tls_options | string | 否 | | | TLS 选项。
|
+| include_req_body | boolean | 否 | | | 当设置为 `true`
时，将请求体包含在日志中。 |
-本插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认设置情况下批处理器会每 `5` 秒钟或队列中的数据达到
`1000` 条时提交数据，如需了解或自定义批处理器相关参数设置，请参考
[Batch-Processor](../batch-processor.md#配置) 配置部分。
+该插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认情况下批处理器每 `5` 秒钟或队列中的数据达到 `1000`
条时提交数据，如需了解或自定义批处理器相关参数设置，请参考 [Batch-Processor](../batch-processor.md#配置)。
-## 如何开启
+## 启用插件
-1. 下面例子展示了如何为指定路由开启 `tcp-logger` 插件的。
+你可以通过以下命令在路由中启用该插件：
Review Comment:
```suggestion
你可以通过以下命令在指定路由中启用该插件：
```
##########
docs/zh/latest/plugins/tcp-logger.md:
##########
@@ -23,34 +29,30 @@ title: tcp-logger
## 描述
-`tcp-logger` 是用于将日志数据发送到 TCP 服务的插件。
-
-以实现将日志数据以 JSON 格式发送到监控工具或其它 TCP 服务的能力。
-
-该插件提供了将 Log Data 作为批处理推送到外部 TCP
服务器的功能。如果您没有收到日志数据，请等待一些时间，它会在我们的批处理处理器中的计时器功能到期后自动发送日志。
+`tcp-logger` 插件可用于将日志数据发送到 TCP 服务器。
-有关 Apache APISIX 中 Batch-Processor 的更多信息，请参考：
-[Batch-Processor](../batch-processor.md)
+该插件还实现了将日志数据以 JSON 格式发送到监控工具或其它 TCP 服务的能力。
## 属性
-| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述
|
| ---------------- | ------- | ------ | ------ | ------- |
------------------------------------------------ |
-| host | string | 必须 | | | TCP 服务的 IP 地址或主机名
|
-| port | integer | 必须 | | [0,...] | 目标端口
|
-| timeout | integer | 可选 | 1000 | [1,...] | 发送数据超时间
|
-| tls | boolean | 可选 | false | | 用于控制是否执行 SSL 验证
|
-| tls_options | string | 可选 | | | TLS 选项
|
-| include_req_body | boolean | 可选 | | | 是否包括请求 body
|
+| host | string | 是 | | | TCP 服务器的 IP 地址或主机名。
|
+| port | integer | 是 | | [0,...] | 目标端口。
|
+| timeout | integer | 否 | 1000 | [1,...] | 发送数据超时间。
|
+| tls | boolean | 否 | false | | 用于控制是否执行 SSL 验证。
|
+| tls_options | string | 否 | | | TLS 选项。
|
+| include_req_body | boolean | 否 | | | 当设置为 `true`
时，将请求体包含在日志中。 |
-本插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认设置情况下批处理器会每 `5` 秒钟或队列中的数据达到
`1000` 条时提交数据，如需了解或自定义批处理器相关参数设置，请参考
[Batch-Processor](../batch-processor.md#配置) 配置部分。
+该插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认情况下批处理器每 `5` 秒钟或队列中的数据达到 `1000`
条时提交数据，如需了解或自定义批处理器相关参数设置，请参考 [Batch-Processor](../batch-processor.md#配置)。
Review Comment:
```suggestion
该插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认情况下批处理器每 `5` 秒钟或队列中的数据达到
`1000` 条时提交数据，如需了解自定义批处理器相关参数设置，请参考 [Batch-Processor](../batch-processor.md#配置)。
```
--
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: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
