Architecture

Pepper Metrics項目從核心概念上來說，基于Tom Wilkie的RED理論，即對每個服務 （這里的服務特指進程中的某種調用，比如調用一次數據庫查詢）進行RED指標收集，并持久化到數據庫，并通過dashboard進行展示，輔助進行性能趨勢分析。

Concept

Arch

各個組件說明

• Profiler， 核心部分，用于啟動定期調度任務，并通過ExtensionLoad加載所有的ScheduledRun擴展，按照指定周期發起調度。同時內部維護Stats的構造器Profiler.Builder
• Scheduler， 虛擬概念，在Profiler作為一個定時任務存在
• ExtensionLoader， 非常重要的組件，通過Java SPI機制加載插件，使項目的各個模塊可以靈活插拔，也是項目架構的基石
• ScheduledRun， 擴展點：pepper metrics core會定時調度，傳遞所有的Stats，實現插件可以使用Stats當中收集到的性能數據，目前已實現的為scheduled printer組件
• Pepper Metrics X， 具體的集成，我們的目標是度量一切，目前計劃實現的為：jedis，motan，dubbo，servlet，mybatis等最常用組件

Getting started

以Mybatis集成為例，更多其他請參考：User Guide

• 增加maven依賴

    
    
        top.zrbcool
        pepper-metrics-mybatis
        1.0.11
    
    
    
        top.zrbcool
        pepper-metrics-ds-prometheus
        1.0.11
    

• 配置Pepper Metrics定制的Mybatis插件使集成生效

    
        ...
    
    
    
        
    
    
        ...
    

• 日志輸出效果：

18:27:28 [perf-mybatis:20190822182728] ---------------------------------------------------------------------------------------------------------------------------------------------------------
18:27:28 [perf-mybatis:20190822182728] | Metrics                                                                     Concurrent Count(Err/Sum)   P90(ms)   P99(ms)  P999(ms)   Max(ms)     Qps | 
18:27:28 [perf-mybatis:20190822182728] | com.pepper.metrics.sample.mybatis.mapper.HotelMapper.selectByCityId                  0         0/1950       0.6       1.4       2.5       3.5    32.5 | 
18:27:28 [perf-mybatis:20190822182728] | sample.mybatis.mapper.CityMapper.selectCityById                                      0         0/1950       0.8       2.4      56.6      56.6    32.5 | 
18:27:28 [perf-mybatis:20190822182728] ---------------------------------------------------------------------------------------------------------------------------------------------------------

• Prometheus指標輸出效果（默認的實現，可以修改為其他數據庫）

 ? curl localhost:9146/metrics
# HELP app_mapper_summary_seconds_max  
# TYPE app_mapper_summary_seconds_max gauge
app_mapper_summary_seconds_max{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,} 0.051129036
app_mapper_summary_seconds_max{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,} 0.011559611
# HELP app_mapper_summary_seconds  
# TYPE app_mapper_summary_seconds summary
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,,} 5.5296E-4
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,,} 0.001765376
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,,} 0.052424704
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,,} 0.052424704
app_mapper_summary_seconds_count{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,} 3040.0
app_mapper_summary_seconds_sum{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,} 1.45711331
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,,} 4.4032E-4
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,,} 0.001308672
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,,} 0.002881536
app_mapper_summary_seconds{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,,} 0.012056576
app_mapper_summary_seconds_count{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,} 3040.0
app_mapper_summary_seconds_sum{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,} 0.772147736
# HELP app_mapper_concurrent_gauge  
# TYPE app_mapper_concurrent_gauge gauge
app_mapper_concurrent_gauge{class="com/pepper/metrics/sample/mybatis/mapper/CityMapper.xml",,} 0.0
app_mapper_concurrent_gauge{class="com/pepper/metrics/sample/mybatis/mapper/HotelMapper.xml",,} 0.0

Maven dependency

以Mybatis為例，更多其他請參考：User Guide

    
    
        top.zrbcool
        pepper-metrics-mybatis
        1.0.11
    
    
    
        top.zrbcool
        pepper-metrics-ds-prometheus
        1.0.11
    

Next steps

• Pepper Metrics User Guide
• Pepper Metrics Architecture
• Pepper Metrics ROAD-MAP
• Pepper Metrics Development Guide
• Pepper Metrics Development Plan

Theory

• Dubbo集成原理
• Http-Servlet集成原理
• Pepper-Metrics-Printer用戶及設計文檔

Building

mvn clean package install