1. Overview
#
1.1 Plugin Name- Logging-Console Plugin
#
1.2 Appropriate Scenario- Users may want to view the information about request(including request headers, request parameters, response headers, response body...etc) where in the side of gateway when debugging during development or troubleshooting problems online.
#
1.3 Plugin functionality- Collect http request url, header, request body, response and response body by logback or log4j, the log file will be saved locally.
#
1.4 Plugin codeCore Module
shenyu-pluign-logging-console
.Core Class
org.apache.shenyu.plugin.logging.console.LoggingConsolePlugin
#
1.5 Added Since Which shenyu version- Since shenyu 2.4.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.
<dependency> <groupId>org.apache.shenyu</groupId> <artifactId>shenyu-spring-boot-starter-plugin-logging-console</artifactId> <version>${project.version}</version></dependency>
#
2.3 Enable plugin- In shenyu-admin --> BasicConfig --> Plugin --> loggingConsole set Status enable.
#
2.4 Config plugin- Selector and rule Config. Please refer: Selector and rule config.
#
2.5 Examples#
2.5.1 Collect all http request logyou must open loggingConsole plugin before you use loggingConsole plugin.
#
2.5.1.1 Selector Configuration#
2.5.1.2 Rule Configuration#
2.5.1.3 Call Http Service#
2.5.1.4 Check Resultif the request arrived successfully, you will see request information as follow.
Request Uri: http://localhost:9195/test/paymentRequest Method: POST
[Request Headers Start]Content-Type: application/jsonContent-Length: 46Host: localhost:9195Connection: Keep-AliveUser-Agent: Apache-HttpClient/4.5.13 (Java/11.0.11)Cookie: JSESSIONID=CD325CE813F61BB37783A1D0835959DDAccept-Encoding: gzip,deflate[Request Headers End]
[Request Body Start]{ "userId": "11", "userName": "xiaoming"}[Request Body End]
Response Code: 200 OK
[Response Headers Start]transfer-encoding: chunkedContent-Length: 37Content-Type: application/json[Response Headers End]
[Response Body Start]{"userId":"11","userName":"xiaoming"}[Response Body End]
3. How to disable plugin
- In
shenyu-admin
--> BasicConfig --> Plugin -->loggingConsole
set Status disable.