背景
在前端开发中，我们常常需要处理分布式系统的调用链追踪、性能分析等问题，这就需要使用一些专门的工具或库来辅助我们完成这些任务。而 zipkin-express-wrapper 是一个 npm 包，它提供了一系列的方法来封装 Zipkin tracer，使得我们可以轻松地在 Express 应用程序中使用 Zipkin。
安装
在使用 zipkin-express-wrapper 之前，需要先安装 Zipkin，本教程不再赘述 Zipkin 的安装过程。安装 zipkin-express-wrapper 的方法如下：
npm install zipkin-express-wrapper --save
如何使用
初始化 Zipkin
在使用 Zipkin 之前，我们需要先创建一个 Zipkin tracer 实例。我们可以使用 zipkin-javascript-opentracing 这个包来创建一个 Zipkin tracer 实例，代码如下：
-- -------------------- ---- -------
----- - ------- -------------- ------------ ---------- - ------------------
----- - ---------- - - ---------------------------------
----- - ---------------------- - - ------------------------------------------
----- - ---------- - - -----------------------------------------
----- -------- - --- ---------------
------- --- ------------
--------- -------------------------------------
------------ --------
-------- ---------------- -------------------
--
---
----- ------ - --- -------------------
----- ----------------- - --- ---------------------------------在这段代码中，我们使用了 zipkin-javascript-opentracing 这个包来创建了一个 BatchRecorder 实例，它可以将 span 信息写入到 Zipkin 服务器中。然后我们创建了一个 Tracer 实例，并将 recorder 传入 Tracer 的构造函数中。
创建 Zipkin 跟踪器
接下来，我们需要创建一个 Zipkin 跟踪器。我们可以使用 zipkin-express-wrapper 提供的 createZipkinMiddleware 方法来创建一个 Zipkin 跟踪器，代码如下：
const { createZipkinMiddleware } = require('zipkin-express-wrapper');
const zipkinMiddleware = createZipkinMiddleware({
tracer,
serviceName: 'example-service',
});在这段代码中，我们传入了一个 tracer 实例和一个 serviceName。这个 serviceName 是当前服务的名称，它将用于在 Zipkin dashboard 中标识当前服务。
使用 Zipkin 跟踪器
接下来，我们需要将 Zipkin 跟踪器应用到 Express 应用程序中。我们可以使用 app.use() 方法将 Zipkin 跟踪器应用到应用程序中，代码如下：
const express = require('express');
const app = express();
app.use(zipkinMiddleware);
app.use(tracingMiddleware.middleware);在这段代码中，我们首先创建了一个 Express 应用程序实例，然后使用 app.use() 方法将 Zipkin 跟踪器中间件和 tracingMiddleware 中间件应用到了应用程序中。
示例代码
下面是一个完整的示例代码，我们可以使用它来测试 Zipkin 跟踪器是否正常工作：
-- -------------------- ---- -------
----- - ------- -------------- ------------ ---------- - ------------------
----- - ---------- - - ---------------------------------
----- - ---------------------- - - ------------------------------------------
----- - ---------- - - -----------------------------------------
----- ------- - -------------------
----- - ---------------------- - - ----------------------------------
----- -------- - --- ---------------
------- --- ------------
--------- -------------------------------------
------------ --------
-------- ---------------- -------------------
--
---
----- ------ - --- -------------------
----- ----------------- - --- ---------------------------------
----- ---------------- - ------------------------
-------
------------ ------------------
---
----- --- - ----------
--------------------------
--------------------------------------
------------ ----- ---- -- -
--------------- ---------
---
---------------- -- -- -
-------------------- --- --------- -- ---- --------
---总结
本文介绍了 npm 包 zipkin-express-wrapper 的使用方法，它可以封装 Zipkin tracer，使得我们可以轻松地在 Express 应用程序中使用 Zipkin。通过本文的学习，我们可以更好地了解如何对分布式系统进行调用链追踪和性能分析。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055c6181e8991b448d9e66