Background
NGINX 是一个通用且流行的应用程序。也是最流行的 Web 服务器,它可用于提供静态文件内容,但也通常与其他服务一起用作分布式系统中的组件,在其中它用作反向代理、负载均衡 或 API 网关。
分布式追踪 distributed tracing
是一种可用于分析与监控应用程序的机制,将追踪在从源到目的的整个过程中的单个请求,这与仅通过单个应用程序域来追踪请求的形式不同。
换句话说,我们可以说分布式追踪是对跨多个系统的多个请求的拼接。拼接通常由一个或多个相关 ID 完成,并且跟踪通常是一组记录的、跨所有系统的结构化日志事件,存储在一个中心位置。
在这种背景的情况下, OpenTracing
应运而生。OpenTracing
是一个与应用供应商无关的 API,它可帮助开发人员轻松地跟踪单一请求的域。目前有多种开源产品都支持 OpenTracing(例如,Jaeger
, skywalking
等),并将其作为一种检测分布式追踪的标准化方法。
本文将围绕,从0到1实现在nginx配置分布式追踪的架构的简单实例说明。本文实例使用的组件为
- nginx v1.22
- jaeger-all-in-on v1.38
- nginx-opentracing v1.22
- jaeger-client-cpp v0.9
源码构建nginx-opentracing
准备nginx-opentracing
nginx-opentracing 仓库中可以看到,官方为每个nginx版本都提供了一个编译好的动态库(Nginx1.19.13+),我们可以直接拿来使用这个动态库,如果你想将这个利用Nginx 提供的编译参数 --add-module=/path/to/module
构建为nginx的内置功能的话,可能会出现一些问题,例如下面的一些错误:
ngx_http_opentracing_module.so/config was found
/root/nginx-opentracing-0.25.0/opentracing//src/ngx_http_opentracing_module.cpp
In file included from /root/nginx-opentracing-0.25.0/opentracing//src/ngx_http_opentracing_module.cpp:1:0:
/root/nginx-opentracing-0.25.0/opentracing//src/load_tracer.h:3:38: fatal error: opentracing/dynamic_load.h: No such file or directory
根据 issue 中查询得知 nginx-opentracing
需要嵌入到nginx中,是需要一些 opentracing-cpp 因为对c++不熟,尝试调试很久还是上面的错误,故直接使用了官方提供的动态库。
准备jaeger-client-cpp
根据 nginx-opentracing
中提到的,还需要一个 jaeger-client-cpp 的 tracer
才可以正常运行(这也是作为jaeger架构中的角色)
来到 jaeger-client-cpp
看到Release提供的编译好的动态库已经很久了,而最新版都没有提供相应编译的版本,需要我们自己编译
说明: 编译依赖CMake 3.3+,gcc 4.9.2+
我们的编译环境使用CentOS 7 默认gcc与CMake都符合要求需要自行编译两个的版本。
编译gcc
gcc下载地址: