You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/09/05 01:23:47 UTC
[GitHub] [apisix] SylviaBABY commented on a diff in pull request #7856: docs: add doc for tencent cloud cls
SylviaBABY commented on code in PR #7856:
URL: https://github.com/apache/apisix/pull/7856#discussion_r962400036
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
Review Comment:
```suggestion
`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614) API 推送到你的日志消息集合。
```
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
+
+## 属性
+
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
+| ----------------- | ------- | ------ |-------| ------------ |------------------------------------------------------------------------------|
+| cls_host | string | 是 | | | CLS API 域名，参考[使用 API 上传日志](https://cloud.tencent.com/document/api/614/16873) |
+| cls_topic | string | 是 | | | CLS 日志主题 id |
+| secret_id | string | 是 | | | 云 API 密钥 |
Review Comment:
```suggestion
| secret_id | string | 是 | | | 云 API 密钥的 ID。 |
```
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
+
+## 属性
+
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
+| ----------------- | ------- | ------ |-------| ------------ |------------------------------------------------------------------------------|
+| cls_host | string | 是 | | | CLS API 域名，参考[使用 API 上传日志](https://cloud.tencent.com/document/api/614/16873) |
+| cls_topic | string | 是 | | | CLS 日志主题 id |
+| secret_id | string | 是 | | | 云 API 密钥 |
+| secret_key | string | 是 | | | 云 API 密钥 |
Review Comment:
```suggestion
| secret_key | string | 是 | | | 云 API 密钥的 Key。 |
```
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
+
+## 属性
+
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
+| ----------------- | ------- | ------ |-------| ------------ |------------------------------------------------------------------------------|
+| cls_host | string | 是 | | | CLS API 域名，参考[使用 API 上传日志](https://cloud.tencent.com/document/api/614/16873) |
+| cls_topic | string | 是 | | | CLS 日志主题 id |
Review Comment:
```suggestion
| cls_topic | string | 是 | | | CLS 日志消息集合的 ID。 |
```
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
+
+| Name | Type | Required | Default | Valid values | Description |
+| ----------------- | ------- | -------- |---------| ------------- | ------------------------------------------------------------ |
+| cls_host | string | Yes | | | CLS API host，please refer [Uploading Structured Logs](https://www.tencentcloud.com/document/api/614/16873) |
+| cls_topic | string | Yes | | | topic of CLS |
+| secret_id | string | Yes | | | SecretId of your API Key |
+| secret_key | string | Yes | | | SecretKey of your API KEY |
+| sample_ratio | number | No | 1 | [0.00001, 1] | How often to sample the requests. Setting to `1` will sample all requests. |
+| include_req_body | boolean | No | false | [false, true] | When set to `true` includes the request body in the log. If the request body is too big to be kept in the memory, it can't be logged due to Nginx's limitations. |
Review Comment:
```suggestion
| include_req_body | boolean | No | false | [false, true] | When set to `true` includes the request body in the log. If the request body is too big to be kept in the memory, it can't be logged due to NGINX's limitations. |
```
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
+
+| Name | Type | Required | Default | Valid values | Description |
+| ----------------- | ------- | -------- |---------| ------------- | ------------------------------------------------------------ |
+| cls_host | string | Yes | | | CLS API host，please refer [Uploading Structured Logs](https://www.tencentcloud.com/document/api/614/16873) |
+| cls_topic | string | Yes | | | topic of CLS |
+| secret_id | string | Yes | | | SecretId of your API Key |
+| secret_key | string | Yes | | | SecretKey of your API KEY |
+| sample_ratio | number | No | 1 | [0.00001, 1] | How often to sample the requests. Setting to `1` will sample all requests. |
+| include_req_body | boolean | No | false | [false, true] | When set to `true` includes the request body in the log. If the request body is too big to be kept in the memory, it can't be logged due to Nginx's limitations. |
+| include_resp_body | boolean | No | false | [false, true] | When set to `true` includes the response body in the log. |
+| global_tag | object | No | | | kv pairs in json，send with each log |
Review Comment:
```suggestion
| global_tag | object | No | | | kv pairs in JSON，send with each log. |
```
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
Review Comment:
Pls add a period at the end of each sentence in Description
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
+
+| Name | Type | Required | Default | Valid values | Description |
+| ----------------- | ------- | -------- |---------| ------------- | ------------------------------------------------------------ |
+| cls_host | string | Yes | | | CLS API host，please refer [Uploading Structured Logs](https://www.tencentcloud.com/document/api/614/16873) |
+| cls_topic | string | Yes | | | topic of CLS |
+| secret_id | string | Yes | | | SecretId of your API Key |
+| secret_key | string | Yes | | | SecretKey of your API KEY |
+| sample_ratio | number | No | 1 | [0.00001, 1] | How often to sample the requests. Setting to `1` will sample all requests. |
Review Comment:
```suggestion
| sample_ratio | number | No | 1 | [0.00001, 1] | Sampling ratio. Setting to `1` will sample all requests. |
```
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
+
+| Name | Type | Required | Default | Valid values | Description |
+| ----------------- | ------- | -------- |---------| ------------- | ------------------------------------------------------------ |
+| cls_host | string | Yes | | | CLS API host，please refer [Uploading Structured Logs](https://www.tencentcloud.com/document/api/614/16873) |
+| cls_topic | string | Yes | | | topic of CLS |
+| secret_id | string | Yes | | | SecretId of your API Key |
+| secret_key | string | Yes | | | SecretKey of your API KEY |
+| sample_ratio | number | No | 1 | [0.00001, 1] | How often to sample the requests. Setting to `1` will sample all requests. |
+| include_req_body | boolean | No | false | [false, true] | When set to `true` includes the request body in the log. If the request body is too big to be kept in the memory, it can't be logged due to Nginx's limitations. |
+| include_resp_body | boolean | No | false | [false, true] | When set to `true` includes the response body in the log. |
+| global_tag | object | No | | | kv pairs in json，send with each log |
+
+This Plugin supports using batch processors to aggregate and process entries (logs/data) in a batch. This avoids the need for frequently submitting the data. The batch processor submits data every `5` seconds or when the data in the queue reaches `1000`. See [Batch Processor](../batch-processor.md#configuration) for more information or setting your custom configuration.
+
+## Metadata
+
+You can also set the format of the logs by configuring the Plugin metadata. The following configurations are available:
+
+| Name | Type | Required | Default | Description |
+| ---------- | ------ | -------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| log_format | object | False | {"host": "$host", "@timestamp": "$time_iso8601", "client_ip": "$remote_addr"} | Log format declared as key value pairs in JSON format. Values only support strings. [APISIX](../apisix-variable.md) or [Nginx](http://nginx.org/en/docs/varindex.html) variables can be used by prefixing the string with `$`. |
+
+:::info IMPORTANT
+
+Configuring the Plugin metadata is global in scope. This means that it will take effect on all Routes and Services which use the `tencent-cloud-cls` Plugin.
+
+:::
+
+The example below shows how you can configure through the Admin API:
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/plugin_metadata/tencent-cloud-cls \
+-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "log_format": {
+ "host": "$host",
+ "@timestamp": "$time_iso8601",
+ "client_ip": "$remote_addr"
+ }
+}'
+```
+
+With this configuration, your logs would be formatted as shown below:
+
+```shell
+{"host":"localhost","@timestamp":"2020-09-23T19:05:05-04:00","client_ip":"127.0.0.1","route_id":"1"}
+{"host":"localhost","@timestamp":"2020-09-23T19:05:05-04:00","client_ip":"127.0.0.1","route_id":"1"}
+```
+
+## Enabling the Plugin
+
+The example below shows how you can enable the Plugin on a specific Route:
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 \
+-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
+{
+ "plugins": {
+ "tencent-cloud-cls": {
+ "cls_host": "ap-guangzhou.cls.tencentyun.com",
+ "cls_topic": "xxxxxxxx-xxxx-xxxx-xxxx",
+ "global_tag": {
+ "module": "cls-logger",
+ "server_name": "YourApiGateWay"
+ },
+ "include_req_body": true,
+ "include_resp_body": true,
+ "secret_id": "xxx",
+ "secret_key": "xxxx"
+ }
+ },
+ "upstream": {
+ "type": "roundrobin",
+ "nodes": {
+ "127.0.0.1:1980": 1
+ }
+ },
+ "uri": "/hello"
+}'
+```
+
+## Example usage
+
+Now, if you make a request to APISIX, it will be logged in your cls topic:
+
+```shell
+curl -i http://127.0.0.1:9080/hello
+```
+
+## Disable Plugin
+
+To disable this Plugin, you can delete the corresponding JSON configuration from the Plugin configuration. APISIX will automatically reload and you do not have to restart for this to take effect.
+
+```shell
+curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
Review Comment:
```suggestion
curl http://127.0.0.1:9180/apisix/admin/routes/1 \
-H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
```
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
+
+## 属性
Review Comment:
Pls add a period at the end of each sentence in Description
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
Review Comment:
```suggestion
The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward APISIX logs to your topic.
```
##########
docs/en/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,141 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API Gateway
+ - Plugin
+ - CLS
+ - Tencent Cloud
+description: This document contains information about the Apache APISIX tencent-cloud-cls Plugin。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## Description
+
+The `tencent-cloud-cls` Plugin uses [TencentCloud CLS](https://cloud.tencent.com/document/product/614)API to forward logs to your topic.
+
+## Attributes
+
+| Name | Type | Required | Default | Valid values | Description |
+| ----------------- | ------- | -------- |---------| ------------- | ------------------------------------------------------------ |
+| cls_host | string | Yes | | | CLS API host，please refer [Uploading Structured Logs](https://www.tencentcloud.com/document/api/614/16873) |
+| cls_topic | string | Yes | | | topic of CLS |
+| secret_id | string | Yes | | | SecretId of your API Key |
+| secret_key | string | Yes | | | SecretKey of your API KEY |
Review Comment:
```suggestion
| secret_key | string | Yes | | | SecretKey of your API Key. |
```
##########
docs/zh/latest/plugins/tencent-cloud-cls.md:
##########
@@ -0,0 +1,147 @@
+---
+title: tencent-cloud-cls
+keywords:
+ - APISIX
+ - API 网关
+ - Plugin
+ - CLS
+ - 腾讯云
+description: API 网关 Apache APISIX tencent-cloud-cls 插件可用于将日志推送到[腾讯云日志服务](https://cloud.tencent.com/document/product/614)。
+---
+
+<!--
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+-->
+
+## 描述
+
+`tencent-cloud-cls` 插件可用于将 APISIX 日志使用[腾讯云日志服务](https://cloud.tencent.com/document/product/614)API 推送到您的日志主题。
+
+## 属性
+
+| 名称 | 类型 | 必选项 | 默认值 | 有效值 | 描述 |
+| ----------------- | ------- | ------ |-------| ------------ |------------------------------------------------------------------------------|
+| cls_host | string | 是 | | | CLS API 域名，参考[使用 API 上传日志](https://cloud.tencent.com/document/api/614/16873) |
+| cls_topic | string | 是 | | | CLS 日志主题 id |
+| secret_id | string | 是 | | | 云 API 密钥 |
+| secret_key | string | 是 | | | 云 API 密钥 |
+| sample_ratio | number | 否 | 1 | [0.00001, 1] | 采样的比例。设置为 `1` 时，将对所有请求进行采样。 |
+| include_req_body | boolean | 否 | false | [false, true]| 当设置为 `true` 时，日志中将包含请求体。 |
+| include_resp_body | boolean | 否 | false | [false, true]| 当设置为 `true` 时，日志中将包含响应体。 |
+| global_tag | object | 否 | | | kv 形式的 json 数据，写入每一条日志，便于 CLS 上检索 |
Review Comment:
```suggestion
| global_tag | object | 否 | | | kv 形式的 JSON 数据，可以写入每一条日志，便于在 CLS 中检索。 |
```
--
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