This is an automated email from the ASF dual-hosted git repository.
xiaoyu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/shenyu-website.git
The following commit(s) were added to refs/heads/main by this push:
new 91ffb1b404 [type:feat]add logging-huawei-lts plugin. (#929)
91ffb1b404 is described below
commit 91ffb1b404aba7a79513ac4eb6230fa865130e30
Author: NanMu <[email protected]>
AuthorDate: Tue Jul 18 12:04:42 2023 +0800
[type:feat]add logging-huawei-lts plugin. (#929)
* [type:feat]add logging-huawei-lts plugin.
* [type:feat]add logging-huawei-lts plugin.
* fix
* fix
* fix
* fix
* fix
* fix
---------
Co-authored-by: ‘xcsnx’ <‘[email protected]’>
---
.../observability/logging-huawei-lts.md | 172 +++++++++++++++++++++
.../observability/logging-huawei-lts.md | 170 ++++++++++++++++++++
.../logging/logging-huawei-lts/call-service.png | Bin 0 -> 79426 bytes
.../logging-huawei-lts/huawei-lts-access.png | Bin 0 -> 23408 bytes
.../logging-huawei-lts/huawei-lts-log-rule-en.png | Bin 0 -> 93030 bytes
.../logging-huawei-lts/huawei-lts-log-rule-zh.png | Bin 0 -> 44270 bytes
.../huawei-lts-log-selector-en.png | Bin 0 -> 92111 bytes
.../huawei-lts-log-selector-zh.png | Bin 0 -> 78761 bytes
.../logging/logging-huawei-lts/huawei-lts-log.png | Bin 0 -> 40705 bytes
.../logging-huawei-lts/huawei-lts-logGroupId.png | Bin 0 -> 38024 bytes
.../logging-huawei-lts/huawei-lts-logStreamId.png | Bin 0 -> 38029 bytes
.../logging-huawei-lts/huawei-lts-projectId.png | Bin 0 -> 22322 bytes
.../logging-huawei-lts/huawei-lts-regionName.png | Bin 0 -> 36294 bytes
.../logging-huawei-lts/plugin-config-en.png | Bin 0 -> 111908 bytes
.../logging-huawei-lts/plugin-config-zh.png | Bin 0 -> 90640 bytes
15 files changed, 342 insertions(+)
diff --git a/docs/plugin-center/observability/logging-huawei-lts.md
b/docs/plugin-center/observability/logging-huawei-lts.md
new file mode 100644
index 0000000000..22a0bb2921
--- /dev/null
+++ b/docs/plugin-center/observability/logging-huawei-lts.md
@@ -0,0 +1,172 @@
+---
+title: Logging-Huawei llts日志插件
+keywords: ["Logging"]
+description: logging plugin
+
+---
+
+# 1. Overview
+
+## 1.1 Plugin Name
+
+* Logging-HuaweiLts Plugin
+
+## 1.2 Appropriate Scenario
+
+* collect http request information to huawei lts, analysis request
information by huawei lts platform.
+
+## 1.3 Plugin functionality
+
+- The gateway receives requests from the client, forwards them to the server,
and returns the server results to the client. The gateway can record the
details of each request，
+
+* the plugin records access logs and sends to huawei lts platform.
+
+## 1.4 Plugin code
+
+* Core Module `shenyu-plugin-logging-huawei-lts`
+
+* Core Class `org.apache.shenyu.plugin.huawei.lts.LoggingHuaweiLtsPlugin`
+* Core Class
`org.apache.shenyu.plugin.huawei.lts.client.HuaweiLtsLogCollectClient`
+
+## 1.5 Added Since Which shenyu version
+
+ShenYu 2.6.0
+
+# 2. How to use plugin
+
+## 2.1 Plugin-use procedure chart
+
+
+
+- ## 2.2 Import pom
+
+ - import maven config in shenyu-bootstrap project's `pom.xml` file.
+
+```xml
+<!-- shenyu logging-huaweilts plugin start -->
+<dependency>
+ <groupId>org.apache.shenyu</groupId>
+
<artifactId>shenyu-spring-boot-starter-plugin-logging-huawei-lts</artifactId>
+ <version>${project.version}</version>
+</dependency>
+<!-- shenyu logging-huaweilts plugin end -->
+```
+
+## 2.3 Enable plugin
+
+- In `shenyu-admin` --> BasicConfig --> Plugin --> `loggingHuaweiLts` set
Status enable.
+
+## 2.4 Config plugin
+
+### 2.4.1 Plugin configuration
+
+### 
+
+| config-item | description
| type | remarks |
+| ------------------------- |
------------------------------------------------------------ | ------- |
-------- |
+| projectId | The project ID of the HUAWEI CLOUD
account（project id） | String | must |
+| accessKeyId | AK of the HUAWEI CLOUD account
| String | must |
+| accessKeySecret | SK of HUAWEI CLOUD account
| String | must |
+| regionName | Regions of Cloud Log Service
| String | must |
+| logGroupId | The log group ID of the LTS
| String | must |
+| logStreamId | The log stream ID of the LTS
| String | must |
+| totalSizeInBytes | The upper limit of the log size that can be
cached by a single producer instance | int | optional |
+| maxBlockMs | If the producer has insufficient free space, the
caller's maximum block time on the send method, in milliseconds. The default is
60 seconds (60000 milliseconds), and 0 seconds is recommended. When the
maxBlockMs value >= 0, it will block until the set time. If the blocking time
is reached, the memory cannot be obtained, that is, an error will be reported
and the log will be discarded. When the value of maxBlockMs=-1, it will be
blocked until the sending is s [...]
+| ioThreadCount | The thread pool size for executing log sending
tasks | int | optional |
+| batchSizeThresholdInBytes | When the cached log size in a ProducerBatch is
greater than or equal to batchSizeThresholdInBytes, the batch will be sent |
int | optional |
+| batchCountThreshold | When the number of cached logs in a
ProducerBatch is greater than or equal to batchCountThreshold, the batch will
be sent | int | optional |
+| lingerMs | The lingering time of a ProducerBatch from
creation until it is sendable | int | optional |
+| retries | If a ProducerBatch fails to send for the first
time, the number of times it can be retried is recommended to be 3 times. If
retries is less than or equal to 0, the ProducerBatch will directly enter the
failure queue after the first sending failure | int | optional |
+| baseRetryBackoffMs | The backoff time for the first retry
| long | optional |
+| maxRetryBackoffMs | Maximum backoff time for retries
| long | optional |
+| giveUpExtraLongSingleLog | For logs exceeding 1M, the data larger than 1M
will be discarded after splitting | boolean | optional |
+| enableLocalTest | 是否开启跨云上报日志
| boolean | optional |
+
+- get `regionName`
+
+
+
+| **区域名称** | **RegionName** |
+| ------------ | -------------- |
+| 华北-北京二 | cn-north-2 |
+| 华北-北京四 | cn-north-4 |
+| 华北-北京一 | cn-north-1 |
+| 华东-上海二 | cn-east-2 |
+| 华东-上海一 | cn-east-3 |
+| 华南-广州 | cn-south-1 |
+| 华南-深圳 | cn-south-2 |
+| 西南-贵阳一 | cn-southwest-2 |
+
+- get `projectId`
+
+
+
+- get `accessKeyId` and `accessKeySecret`
+
+
+
+- get `logGroupId` and `logStreamId`
+
+
+
+
+
+### 2.4.2 Configuration Selectors and Rules
+
+* Selector and rule Config. Please refer: [Selector and rule
config](../../user-guide/admin-usage/selector-and-rule.md).
+
+## 2.5 Logging Info
+
+collect request info as follows
+
+| Field Name | Meaning
| Description |
Remarks |
+| :-------------------- |
:----------------------------------------------------------: |
:----------------------------------------------------------- | :------ |
+| clientIp | Client IP
| |
|
+| timeLocal | Request time string, format: yyyy-MM-dd
HH:mm:ss.SSS |
| |
+| method | request method (different rpc type is not the same,
http class for: get, post wait, rpc class for the interface name) |
| |
+| requestHeader | Request header (json format)
| |
|
+| responseHeader | Response header (json format)
| |
|
+| queryParams | Request query parameters
| |
|
+| requestBody | Request Body (body of binary type will not be
captured) | |
|
+| requestUri | Request uri
| |
|
+| responseBody | Response body
| |
|
+| responseContentLength | Response body size
| |
|
+| rpcType | rpc type
| |
|
+| status | response status
| |
|
+| upstreamIp | Upstream (program providing the service) IP
| |
|
+| upstreamResponseTime | Time taken by the upstream (program providing the
service) to respond to the request (ms ms) |
| |
+| userAgent | Requested user agent
| |
|
+| host | The requested host
| |
|
+| module | Requested modules
| |
|
+| path | The requested path
| |
|
+| traceId | Requested Link Tracking ID
| Need to access link tracking plugins, such as skywalking,zipkin |
|
+
+## 2.6 Examples
+
+### 2.6.1 Collect Http Log by tencent cls platform
+
+#### 2.6.1.1 Plugin Configuration
+
+* Open the plugin and configure huawei lts, configure it as follows.
+
+
+
+#### 2.6.1.2 Selector Configuration
+
+
+
+#### 2.6.1.3 Rule Configuration
+
+
+
+#### 2.6.1.4 Send Request
+
+
+
+#### 2.6.1.5 Huawei lts Platform Display
+
+
+
+# 3. How to disable plugin
+
+- In `shenyu-admin` --> BasicConfig --> Plugin -->`loggingHuaweiLts`set Status
disable.
diff --git
a/i18n/zh/docusaurus-plugin-content-docs/current/plugin-center/observability/logging-huawei-lts.md
b/i18n/zh/docusaurus-plugin-content-docs/current/plugin-center/observability/logging-huawei-lts.md
new file mode 100644
index 0000000000..eb0c3061b2
--- /dev/null
+++
b/i18n/zh/docusaurus-plugin-content-docs/current/plugin-center/observability/logging-huawei-lts.md
@@ -0,0 +1,170 @@
+---
+title: Logging-ElasticSearch插件
+keywords: ["Logging", "HuaweiLts"]
+description: Logging-ElasticSearch插件
+---
+
+# 1. 概述
+
+## 1.1 插件名称
+
+- Huawei Lts 日志插件
+
+## 1.2 适用场景
+
+- 收集日志到`Huawei lts`日志平台，并通过`Huawei lts`日志平台进行数据分析
+
+## 1.3 插件功能
+
+- 网关接收客户端请求，向服务端转发请求，并将服务端结果返回给客户端.网关可以记录下每次请求对应的详细信息。
+- 插件便是记录访问日志并将访问日志发送到Huawei lts的插件.
+
+## 1.4 插件代码
+
+- 核心模块 `shenyu-plugin-logging-huawei-lts`
+- 核心类 `org.apache.shenyu.plugin.huawei.lts.LoggingHuaweiLtsPlugin
+- 核心类 `org.apache.shenyu.plugin.huawei.lts.client.HuaweiLtsLogCollectClient
+
+## 1.5 添加自哪个shenyu版本
+
+ShenYu 2.6.0
+
+# 2. 如何使用插件
+
+## 2.1 插件使用流程图
+
+
+
+## 2.2 导入pom
+
+- 在ShenYu-Bootstrap导入对应的pom依赖。
+
+```xml
+<!-- shenyu logging-huaweilts plugin start -->
+<dependency>
+ <groupId>org.apache.shenyu</groupId>
+
<artifactId>shenyu-spring-boot-starter-plugin-logging-huawei-lts</artifactId>
+ <version>${project.version}</version>
+</dependency>
+<!-- shenyu logging-huaweilts plugin end -->
+```
+
+## 2.3 启用插件
+
+- 在 `shenyu-admin` --> 基础配置 --> 插件管理-> `loggingHuaweiLts` ，设置为开启。
+
+## 2.4 配置插件
+
+### 2.4.1 插件配置
+
+### 
+
+| 配置项 | 描述
| 类型 | 备注 |
+| ------------------------- |
------------------------------------------------------------ | ------- | ---- |
+| projectId | 华为云帐号的项目ID（project id）。
| String | 必填 |
+| accessKeyId | 华为云帐号的AK。
| String | 必填 |
+| accessKeySecret | 华为云帐号的SK。
| String | 必填 |
+| regionName | 云日志服务的区域。
| String | 必填 |
+| logGroupId | LTS的日志组ID。
| String | 必填 |
+| logStreamId | LTS的日志流ID。
| String | 必填 |
+| totalSizeInBytes | 单个producer实例能缓存的日志大小上限。 |
int | 选填 |
+| maxBlockMs | 如果 producer 可用空间不足，调用者在 send
方法上的最大阻塞时间，单位为毫秒。默认为 60
秒（60000毫秒），建议为0秒。当maxBlockMs值>=0时，则阻塞到设置的时间，如果到达阻塞时间，还是不能获取到内存，即报错且丢弃日志。当maxBlockMs值=-1时，则一直阻塞到发送成功，且不会丢弃日志。
| long | 选填 |
+| ioThreadCount | 执行日志发送任务的线程池大小。 |
int | 选填 |
+| batchSizeThresholdInBytes | 当一个 ProducerBatch 中缓存的日志大小大于等于
batchSizeThresholdInBytes 时，该 batch 将被发送。 | int | 选填 |
+| batchCountThreshold | 当一个 ProducerBatch 中缓存的日志条数大于等于
batchCountThreshold 时，该 batch 将被发送。 | int | 选填 |
+| lingerMs | 一个 ProducerBatch 从创建到可发送的逗留时间。 |
int | 选填 |
+| retries | 如果某个 ProducerBatch 首次发送失败，能够对其重试的次数，建议为 3 次。如果
retries 小于等于 0，该 ProducerBatch 首次发送失败后将直接进入失败队列。 | int | 选填 |
+| baseRetryBackoffMs | 首次重试的退避时间。
| long | 选填 |
+| maxRetryBackoffMs | 重试的最大退避时间。
| long | 选填 |
+| giveUpExtraLongSingleLog | 超过1M的日志, 拆分后丢弃大于1M的数据。 |
boolean | 选填 |
+| enableLocalTest | 是否开启跨云上报日志
| boolean | 选填 |
+
+- 获取 `regionName`
+
+
+
+| **区域名称** | **RegionName** |
+| ------------ | -------------- |
+| 华北-北京二 | cn-north-2 |
+| 华北-北京四 | cn-north-4 |
+| 华北-北京一 | cn-north-1 |
+| 华东-上海二 | cn-east-2 |
+| 华东-上海一 | cn-east-3 |
+| 华南-广州 | cn-south-1 |
+| 华南-深圳 | cn-south-2 |
+| 西南-贵阳一 | cn-southwest-2 |
+
+- 获取 `projectId`
+
+
+
+
+- 获取 `accessKeyId`与`accessKeySecret`
+
+
+
+- 获取 `logGroupId`与`logStreamId`
+
+
+
+
+
+### 2.4.2 规则和选择器配置
+
+- 插件和选择器配置。请查看: [Selector and rule
config](https://shenyu.apache.org/zh/docs/user-guide/admin-usage/selector-and-rule).
+
+## 2.5 Logging信息
+
+采集的access log的字段如下：
+
+| 字段名称 | 含义
| 说明 | 备注 |
+| --------------------- |
------------------------------------------------------------ |
----------------------------------------- | ---- |
+| clientIp | 客户端IP
| | |
+| timeLocal | 请求时间字符串, 格式：yyyy-MM-dd HH:mm:ss.SSS |
| |
+| method | 请求方法(不同rpc类型不一样，http类的为:get,post等待，rpc类的为接口名称) |
| |
+| requestHeader | 请求头(json格式)
| | |
+| responseHeader | 响应头(json格式)
| | |
+| queryParams | 请求查询参数
| | |
+| requestBody | 请求Body（二进制类型的body不会采集） |
| |
+| requestUri | 请求uri
| | |
+| responseBody | 响应body
| | |
+| responseContentLength | 响应body大小
| | |
+| rpcType | rpc类型
| | |
+| status | 响应码
| | |
+| upstreamIp | 上游(提供服务的程序)IP
| | |
+| upstreamResponseTime | 上游(提供服务的程序)响应请求的耗时(毫秒ms) |
| |
+| userAgent | 请求的用户代理
| | |
+| host | 请求的host
| | |
+| module | 请求的模块
| | |
+| path | 请求的路径path
| | |
+| traceId | 请求的链路追踪ID
| 需要接入链路追踪插件，如skywalking,zipkin | |
+
+## 2.6 示例
+
+### 2.6.1 通过华为云lts日志平台收集日志
+
+#### 2.6.1.1 插件配置
+
+- 开启插件，并配置 huawei lts插件,配置如下：
+
+
+
+#### 2.6.1.2 选择器配置
+
+
+
+#### 2.6.1.3 规则配置
+
+
+
+#### 2.6.1.4 发送请求
+
+
+
+#### 2.6.1.5 hauwei lts日志平台展示
+
+
+
+# 3. 如何禁用插件
+
+- 在 `shenyu-admin` --> 基础配置 --> 插件管理-> `loggingHuaweiLts` ，设置为关闭。
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/call-service.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/call-service.png
new file mode 100644
index 0000000000..424bb0bcba
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/call-service.png differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-access.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-access.png
new file mode 100644
index 0000000000..dd902cd134
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-access.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-en.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-en.png
new file mode 100644
index 0000000000..5ccee9ac6c
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-en.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-zh.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-zh.png
new file mode 100644
index 0000000000..77b9ba512c
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-rule-zh.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-en.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-en.png
new file mode 100644
index 0000000000..226607da3a
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-en.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-zh.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-zh.png
new file mode 100644
index 0000000000..fa32793c97
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log-selector-zh.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log.png
new file mode 100644
index 0000000000..b9bc332b9b
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-log.png differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logGroupId.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logGroupId.png
new file mode 100644
index 0000000000..0dd26dd7d3
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logGroupId.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logStreamId.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logStreamId.png
new file mode 100644
index 0000000000..131daaba24
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-logStreamId.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-projectId.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-projectId.png
new file mode 100644
index 0000000000..c24598965a
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-projectId.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-regionName.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-regionName.png
new file mode 100644
index 0000000000..af299542bf
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/huawei-lts-regionName.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-en.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-en.png
new file mode 100644
index 0000000000..1981eec7e8
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-en.png
differ
diff --git
a/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-zh.png
b/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-zh.png
new file mode 100644
index 0000000000..a4a4207e6d
Binary files /dev/null and
b/static/img/shenyu/plugin/logging/logging-huawei-lts/plugin-config-zh.png
differ
