RGW Usage類解析

1、概述。

     RGW Usage類實現了RGW的流量統計功能，其中包括髮送／接收的字節數、執行操做的個數以及成功之行操做的個數。Usage類統計的這些內容對於通常的流量統計來講已經夠用了。

2、核心數據結構解析。

RGW Usage核心數據結構以下：

struct rgw_usage_log_entry {

     rgw_user owner;

     rgw_user payer;

     string bucket;

     uint64_t epoch;

     rgw_usage_data total_usage;

     map<string, rgw_usage_data> usage_map;

};

3、核心類關係圖。

4、核心處理函數解析。

一、獲取RGWUsage信息。

RGWUsage::show()

|__RGWRados::read_usage()

     |__RGWRados::cls_obj_usage_log_read()

          |__cls_rgw_usage_log_read()

               |__rgw_user_usage_log_read()

                    |__usage_iterate_range()

                         |__cls_cxx_map_get_vals()          CEPH_OSD_OP_OMAPGETVALS

                         |__usage_record_decode()          從bufferlist中解析出rgw_usage_log_entry對象

                         |__usage_log_read_cb()

                              |__經過rgw_usage_log_entry::owner和rgw_usage_log_entry::bucket建立rgw_user_bucket對象

                              |__以rgw_user_bucket對象爲key，rgw_usage_log_entry爲value寫入到map中

二、刪除RGWUsage信息。

RGWUsage::trim()

|__RGWRados::trim_usage()

     |__RGWRados::cls_obj_usage_log_trim()

          |__cls_rgw_usage_log_trim()

               |__rgw_user_usage_log_trim()

                    |__usage_iterate_range()

                         |__cls_cxx_map_get_vals()          CEPH_OSD_OP_OMAPGETVALS

                         |__usage_record_decode()          從bufferlist中解析出rgw_usage_log_entry對象

                         |__usage_log_trim_cb()               

                              |__usage_record_name_by_time()          格式：epoch_user_bucket

                              |__usage_record_name_by_user()          格式：user_epoch_bucket

                              |__cls_cxx_map_remove_key()     CEPH_OSD_OP_OMAPRMKEYS

                              |__cls_cxx_map_remove_key()     CEPH_OSD_OP_OMAPRMKEYS

三、增長RGWUsage信息。

能夠經過flush()函數或經過rgw_log_op()函數來增長RGWUsage信息，增長RGWUsage信息的入口代碼位於RGWRados::log_usage()。下面詳細描述該函數的處理流程。

RGWRados::log_usage()

|__RGWRados::cls_obj_usage_log_add()

     |__cls_rgw_usage_log_add()

          |__rgw_user_usage_log_add()

               |__usage_record_name_by_time()                         格式：epoch_user_bucket

               |__cls_cxx_map_set_val()                                      CEPH_OSD_OP_OMAPSETVALS

               |__usage_record_name_by_user()                         格式：user_epoch_bucket

               |__cls_cxx_map_set_val()                                      CEPH_OSD_OP_OMAPSETVALS