点击右上方,关注开源中国OSC头条号,获取最新技术资讯
Molten 是应用透明链路追踪工具。
Molten 追踪php核心调用库运行时信息并且按照zipkin/optracing格式输出信息。
Molten 提供多种sapi, 多种采样类型, 上报追踪状态, 模块控制和多种数据落地 类型等功能。
依赖于Molten 很容易构建基于php语言的分布式全链路追踪系统 目前已经运行在生产环境上千台机器上。
安装
以下是你需要做的安装molten在你的系统上。
phpize./configuremake && make install
make install 复制 molten.so 到确切的位置, 但是你还需要开启模块在php配置中,编辑你自己的php.ini或者添加molten.ini在/etc/php5/conf.d, 并且添加如下内容:extension=molten.so。
在./configure 阶段, 你也可以添加 --enable-zipkin-header=yes 支持zipkin B3 header。
快速开始
cd examplesh run.sh
在浏览器中打开 http://127.0.0.1:9411/zipkin/, 能够看见链路信息。
如果你认为上述太简单,你可以做下面的操作。
cd examplesh complex.sh
怎么样,是不是很酷。
注意 如果没有看到详细信息,那么EndTime选项中添加1小时。
示例详细介绍
配置
基础配置
molten.enable 1开启0关闭, 默认 1。
molten.service_name 设置应用服务名, 默认default。
molten.tracing_cli 1追踪cli模式下信息, 0关闭, 默认0。
采样配置
molten.sampling_type 类型类型, 1采样率控制, 2通过每分钟request数, 默认是1。
molten.sampling_request 采样类型是请求数采样,每分钟的采样请求数, 默认是10。
molten.sampling_rate_base 采样类型是采样率时,每个请求的采样几率, 默认是256。
控制模块配置
molten.notify_uri 通知管理中心的uri。
上报模块配置
上报模块使用和数据模块相同的输出类型。
molten.report_interval 数据模块调用间隔, 默认 60。
molten.report_limit 数据上报请求上限, 默认 100。
数据模块
molten.sink_type 数据落地类型, 1 写入文件, 文件地址依赖molten.sink_log_path, 2 写入到标准输出, 3 写入到syslog中, 4 通过curl发送, 发送地址依赖 molten.sink_http_uri.
molten.output_type 输出全部追踪块(span)(1) 或者一行输出一个块(2)。
molten.sink_log_path 写入文件地址。
molten.sink_http_uri 发送http地址。
molten.sink_syslog_unix_socket 发送日志到syslog udp unixdomain日志收集源中。
追踪块配置
molten.span_format 追踪块格式(span), 不同的追踪系统选择zipkin 或者 zipkin_v2或者 opentracing。
函数
molten_span_format() 获取当前追踪系统span格式, 返回zipkin或者opentracing字符串。
molten_get_traceid() 获取当前上下文的traceiid,返回16进制的字符串。
molten_set_traceid($trace_id) 设置当前上下文的额traceiid, 无返回。
验证
php -d extension=molten.so -d molten.enable=1 -d molten.sink_type=2 -d molten.tracing_cli=1 -d molten.sampling_rate=1 -r '$c=curl_init("http://localhost:12345");curl_exec($c);'
可以看到如下输出:
[{"traceId":"%s