Molte是应用透明链路追踪工具。
Molte追踪php核心调用库运行时信息并且按照zipki/optracig格式输出信息。
Molte提供多种sapi,多种采样类型,上报追踪状态,模块控制和多种数据落地类型等功能。
依赖于Molte很容易构建基于php语言的分布式全链路追踪系统 目前已经运行在生产环境上千台机器上。
安装以下是你需要做的安装molte在你的系统上。
phpize./cofiguremake && make istallmakeistall 复制 molte.so 到确切的位置,但是你还需要开启模块在php配置中,编辑你自己的php.ii或者添加molte.ii在/etc/php5/cof.d,并且添加如下内容:extesio=molte.so。
在./cofigure 阶段,你也可以添加 --eable-zipki-header=yes 支持zipkiB3header。
快速开始cd examplesh ru.sh在浏览器中打开 https://127.0.0.1:9411/zipki/,能够看见链路信息。
如果你认为上述太简单,你可以做下面的操作。
cd examplesh complex.sh怎么样,是不是很酷。
注意 如果没有看到详细信息,那么EdTime选项中添加1小时。
示例详细介绍
配置基础配置molte.eable 1开启0关闭,默认 1。
molte.service_ame 设置应用服务名,默认default。
molte.tracig_cli 1追踪cli模式下信息,0关闭,默认0。
采样配置molte.samplig_type 类型类型,1采样率控制,2通过每分钟request数,默认是1。
molte.samplig_request 采样类型是请求数采样,每分钟的采样请求数,默认是10。
molte.samplig_rate_base 采样类型是采样率时,每个请求的采样几率,默认是256。
控制模块配置molte.otify_uri 通知管理中心的uri。
上报模块配置上报模块使用和数据模块相同的输出类型。
molte.report_iterval 数据模块调用间隔,默认 60。
molte.report_limit 数据上报请求上限,默认 100。
数据模块molte.sik_type 数据落地类型, 1 写入文件,文件地址依赖molte.sik_log_path, 2 写入到标准输出, 3 写入到syslog中, 4 通过curl发送,发送地址依赖 molte.sik_http_uri.
molte.output_type 输出全部追踪块(spa)(1)或者一行输出一个块(2)。
molte.sik_log_path 写入文件地址。
molte.sik_http_uri 发送http地址。
molte.sik_syslog_uix_socket 发送日志到syslogudpuixdomai日志收集源中。
追踪块配置molte.spa_format 追踪块格式(spa),不同的追踪系统选择zipki 或者 zipki_v2或者 opetracig。
函数molte_spa_format() 获取当前追踪系统spa格式,返回zipki或者opetracig字符串。
molte_get_traceid() 获取当前上下文的traceiid,返回16进制的字符串。
molte_set_traceid($trace_id) 设置当前上下文的额traceiid,无返回。
验证php -d extesio=molte.so -d molte.eable=1 -d molte.sik_type=2 -d molte.tracig_cli=1 -d molte.samplig_rate=1 -r '$c=curl_iit("https://localhost:12345");curl_exec($c);'可以看到如下输出:
[{"traceId":"%s","ame":"php_curl","versio":"php-4","id":"1.1","paretId":"1","timestamp":%d,"duratio":%d,"aotatios":[{"value":"cs","timestamp":%d,"edpoit":{"serviceName":"%s","ipv4":"%s"}},{"value":"cr","timestamp":%d,"edpoit":{"serviceName":"%s","ipv4":"%s"}}],"biaryAotatios":[{"key":"http.url","value":"http:\/\/localhost:12345\/","edpoit":{"serviceName":"%s","ipv4":"%s"}},{"key":"error","value":"Failedcoect to localhost:12345; Coectiorefused","edpoit":{"serviceName":"%s","ipv4":"%s"}}]},{"traceId":"%s","ame":"cli","versio":"php-4","id":"1","timestamp":%d,"duratio":%d,"aotatios":[{"value":"sr","timestamp":%d,"edpoit":{"serviceName":"%s","ipv4":"%s"}},{"value":"ss","timestamp":%d,"edpoit":{"serviceName":"%s","ipv4":"%s"}}],"biaryAotatios":[{"key":"path","value":"-","edpoit":{"serviceName":"%s","ipv4":"%s"}}]}]功能从上述配置中,你可以看到我们提供的功能。
拦截器molte拦截curl,pdo,mysqli,redis,mogodb,memcached扩展,构建运行时追踪信息.支持全链路追踪功能,molte替换了curl_exec,curl_setopt,curl_setopt_array函数,并且在请求中添加了链路头(x-w-traceid,x-w-spaidadsoo)。
定制化的链路格式,支持两个流行格式(zipki 和 opetracig)。
采样两种不同的采样方式并且能够通过控制模块进行修改。
数据落地molte当前支持3种数据落地方式,标准输出,文件,http。并且能够选择输出的位置。
控制使用http协议控制探针的行为。
查看molte的状态,通过GET方法请求https://domai/molte/status。
输出内容如下,已经适配了prometheus格式。
# HELP molte_request_all Number of all request.# TYPE molte_request_all coutermolte_request_all %d# HELP molte_request_capture Number of request be capture.# TYPE molte_request_capture coutermolte_request_capture %d# HELP molte_samplig_type the type of samplig.# TYPE molte_samplig_type gaugemolte_samplig_type %d# HELP molte_samplig_rate the rate of samplig.# TYPE molte_samplig_rate gaugemolte_samplig_rate %d# HELP molte_samplig_request the request be capture oe mi.# TYPE molte_samplig_request gaugemolte_samplig_request %d修改molte采样方式,使用POST方法请求https://domai/molte/status。
数据是jso格式,字段和配置项中的含义是一致的。
{"eable":1,"sampligType":2,"sampligRate":20,"sampligRequest":100}上报上报模块能够记录,molte并没有采样样到的关键数据信息。
评论