Tencent Server Web 2.0

What is it

Tencent Server Web(TSW) 是一套面向 WEB 前端开发者，以提升问题定位效率为初衷，提供染色抓包和全息日志的 Node.js 基础设施。TSW 关注业务的运维监控能力，适用于 http、https 协议的业务场景，可无缝与现有应用（Koa、Express）进行整合。

TSW 2.0 在 1.0 的基础上抽丝剥茧，辅以现代化的设计模式，去除了 1.0 中的大量糟粕，同时对容器化、云原生更加友好。做到了无侵入、低成本接入。

Highlights


:---	:---	:---
通过 Hack NodeJS 底层代码实现功能。对原有业务代码 0 侵入。	按照请求聚类的显微镜级别的全息日志，给开发者完美的现场还原。	可抓取 Server 端向外部发送的所有请求的完整包体内容，与后台沟通再无障碍。

特别提醒

TSW 1.0 迁移到 2.0 需要注意的地方

TSW 1.0 服务包含进程管理，日志管理等多项内置模块，在进行往 2.0 迁移的时候，请选择其他组件完成替代，如引入 PM2 管理 Node 进程，使用 winston 进行日志管理

另外 2.0 没有包含日志清理工具，建议选择 winston-rotating-file 类似工具来完成清理，避免日志存放过多，导致磁盘空间不足

Quick Start

1. 安装

``` shell
npm install --save @tswjs/tsw
// yarn add @tswjs/tsw
```

2. 添加配置文件

配置文件是 TSW 启动时加载进运行时的配置文件，主要声明需要使用的插件列表。默认会加载项目根目录下的 tswconfig.js 文件，也可以通过启动参数 -c 或者 --config 来手动指定配置文件路径。

注意事项: 2.0 中没有集成开放平台相关逻辑，而是封装成了一个插件让用户按需使用，详情见插件章节。

配置文件示例：

``` js
module.exports = {
plugins: [
new MyPlugin({})
]
}
```

参数列表:

Name	Type	default	Optional	Description
:---	:---	:---	:---	:---
plugins	Array<Plugin>	-	yes	插件列表
cleanLog	boolean	false	yes	是否关闭默认打印
logLevel	DEBUG/INFO/WARN/ERROR	DEBUG	yes	设置 log level
winstonTransports	Array<TransportStream>	-	yes	Winston日志通道

3. 启动

``` shell
npx @tswjs/tsw ./index.js
```

注意事项：原先 node --inspect ./index.js 中的 CLI 参数如 --inspect 需要转化为环境变量 NODE_OPTIONS 来执行，如 NODE_OPTIONS="--inspect" npx @tswjs/tsw ./index.js 。

使用 ts: 在保证项目有 ts-node 依赖包的情况下，按照如下方式执行即可直接加载 ts 文件。

``` shell
NODE_OPTIONS="--require=ts-node/register" npx @tswjs/tsw ./index.ts
```

CLI (Command Line Interface)

使用 npx @tswjs/tsw --help 来获取 CLI 选项。

Examples

我们提供了一些示例项目以让大家尽快了解该项目。

cd ~

git clone https://github.com/Tencent/TSW.git

cd TSW

Koa

cd examples/koa

yarn

yarn serve 或者 npm run serve

curl -v localhost:4443/path/to/foo -X POST -d "hello, server"

Plugins

插件是什么？

TSW 核心的实现方式是 Hack NodeJS 自身的 http.request 以及 http.createServer ，以此来实现抓包机制。在服务器处理请求的前后，在服务器向其他服务器发包的前后，等等，都会有相应的事件抛出，以供用户来进行自定义处理。为了让用户更加方便地复用、传播这样一组组自定义处理，我们将他们抽象出来，形成了插件机制。

一个最简单的插件

``` js
export.modules = class MyPlugin() {
constructor() {
this.name = "MyPlugin"
}
async init(eventBus, config) {
eventBus.on("RESPONSE_CLOSE", (payload) => {
console.log(payload);
})
}
}
```

init 方法是必须的，这个方法在插件加载开始时会被调用，可以是同步也可以是异步。

eventBus

eventBus 是通过 new EventEmitter() 得到的。TSW 核心会在各个关键时机触发上面的事件。

key	含义（触发时机）	payload
:---	:---	:---
DNS_LOOKUP_SUCCESS	在每次 DNS 查询成功之后触发	`string
DNS_LOOKUP_ERROR	在每次 DNS 查询失败之后触发	NodeJS.ErrorException
RESPONSE_START	在每次服务器开始返回响应（执行 writeHead）时触发	ResponseEventPayload
RESPONSE_FINISH	在响应结束时（res.on("finish")）触发	ResponseEventPayload
RESPONSE_CLOSE	在底层链接关闭时（res.on("close")）触发	ResponseEventPayload
REQUEST_START	在每次服务器接受到新的请求时触发	RequestEventPayload

Open Platform

在默认的情况下，TSW 只是会把所有的日志和抓包内容抓取到并且送到事件总线上，以供插件消费。所以将日志和抓包内容落地查看一般需要用户自己编写插件以及提供存储，使用成本过于高昂。因此，TSW 官方提供了公共的服务平台（https://tswjs.org），让用户低成本、更快、更方便地使用 TSW 的特性，详情见开放平台使用指引。