From 7da45d65be36d36b880cc55c5036e96c24b53f00 Mon Sep 17 00:00:00 2001 From: Qiaowei Ren Date: Thu, 1 Mar 2018 14:38:11 +0800 Subject: remove ceph code This patch removes initial ceph code, due to license issue. Change-Id: I092d44f601cdf34aed92300fe13214925563081c Signed-off-by: Qiaowei Ren --- src/ceph/doc/dev/perf_histograms.rst | 677 ----------------------------------- 1 file changed, 677 deletions(-) delete mode 100644 src/ceph/doc/dev/perf_histograms.rst (limited to 'src/ceph/doc/dev/perf_histograms.rst') diff --git a/src/ceph/doc/dev/perf_histograms.rst b/src/ceph/doc/dev/perf_histograms.rst deleted file mode 100644 index c277ac2..0000000 --- a/src/ceph/doc/dev/perf_histograms.rst +++ /dev/null @@ -1,677 +0,0 @@ -================= - Perf histograms -================= - -The perf histograms build on perf counters infrastructure. Histograms are built for a number of counters and simplify gathering data on which groups of counter values occur most often over time. -Perf histograms are currently unsigned 64-bit integer counters, so they're mostly useful for time and sizes. Data dumped by perf histogram can then be feed into other analysis tools/scripts. - -Access ------- - -The perf histogram data are accessed via the admin socket. For example:: - - ceph daemon osd.0 perf histogram schema - ceph daemon osd.0 perf histogram dump - - -Collections ------------ - -The histograms are grouped into named collections, normally representing a subsystem or an instance of a subsystem. For example, the internal ``throttle`` mechanism reports statistics on how it is throttling, and each instance is named something like:: - - - op_r_latency_out_bytes_histogram - op_rw_latency_in_bytes_histogram - op_rw_latency_out_bytes_histogram - ... - - -Schema ------- - -The ``perf histogram schema`` command dumps a json description of which values are available, and what their type is. Each named value as a ``type`` bitfield, with the 5-th bit always set and following bits defined. - -+------+-------------------------------------+ -| bit | meaning | -+======+=====================================+ -| 1 | floating point value | -+------+-------------------------------------+ -| 2 | unsigned 64-bit integer value | -+------+-------------------------------------+ -| 4 | average (sum + count pair) | -+------+-------------------------------------+ -| 8 | counter (vs gauge) | -+------+-------------------------------------+ - -In other words, histogram of type "18" is a histogram of unsigned 64-bit integer values (16 + 2). - -Here is an example of the schema output:: - - { - "AsyncMessenger::Worker-0": {}, - "AsyncMessenger::Worker-1": {}, - "AsyncMessenger::Worker-2": {}, - "mutex-WBThrottle::lock": {}, - "objecter": {}, - "osd": { - "op_r_latency_out_bytes_histogram": { - "type": 18, - "description": "Histogram of operation latency (including queue time) + da ta read", - "nick": "" - }, - "op_w_latency_in_bytes_histogram": { - "type": 18, - "description": "Histogram of operation latency (including queue time) + da ta written", - "nick": "" - }, - "op_rw_latency_in_bytes_histogram": { - "type": 18, - "description": "Histogram of rw operation latency (including queue time) + data written", - "nick": "" - }, - "op_rw_latency_out_bytes_histogram": { - "type": 18, - "description": "Histogram of rw operation latency (including queue time) + data read", - "nick": "" - } - } - } - - -Dump ----- - -The actual dump is similar to the schema, except that there are actual value groups. For example:: - - "osd": { - "op_r_latency_out_bytes_histogram": { - "axes": [ - { - "name": "Latency (usec)", - "min": 0, - "quant_size": 100000, - "buckets": 32, - "scale_type": "log2", - "ranges": [ - { - "max": -1 - }, - { - "min": 0, - "max": 99999 - }, - { - "min": 100000, - "max": 199999 - }, - { - "min": 200000, - "max": 399999 - }, - { - "min": 400000, - "max": 799999 - }, - { - "min": 800000, - "max": 1599999 - }, - { - "min": 1600000, - "max": 3199999 - }, - { - "min": 3200000, - "max": 6399999 - }, - { - "min": 6400000, - "max": 12799999 - }, - { - "min": 12800000, - "max": 25599999 - }, - { - "min": 25600000, - "max": 51199999 - }, - { - "min": 51200000, - "max": 102399999 - }, - { - "min": 102400000, - "max": 204799999 - }, - { - "min": 204800000, - "max": 409599999 - }, - { - "min": 409600000, - "max": 819199999 - }, - { - "min": 819200000, - "max": 1638399999 - }, - { - "min": 1638400000, - "max": 3276799999 - }, - { - "min": 3276800000, - "max": 6553599999 - }, - { - "min": 6553600000, - "max": 13107199999 - }, - { - "min": 13107200000, - "max": 26214399999 - }, - { - "min": 26214400000, - "max": 52428799999 - }, - { - "min": 52428800000, - "max": 104857599999 - }, - { - "min": 104857600000, - "max": 209715199999 - }, - { - "min": 209715200000, - "max": 419430399999 - }, - { - "min": 419430400000, - "max": 838860799999 - }, - { - "min": 838860800000, - "max": 1677721599999 - }, - { - "min": 1677721600000, - "max": 3355443199999 - }, - { - "min": 3355443200000, - "max": 6710886399999 - }, - { - "min": 6710886400000, - "max": 13421772799999 - }, - { - "min": 13421772800000, - "max": 26843545599999 - }, - { - "min": 26843545600000, - "max": 53687091199999 - }, - }, - { - "min": 53687091200000 - } - ] - }, - { - "name": "Request size (bytes)", - "min": 0, - "quant_size": 512, - "buckets": 32, - "scale_type": "log2", - "ranges": [ - { - "max": -1 - }, - { - "min": 0, - "max": 511 - }, - { - "min": 512, - "max": 1023 - }, - { - "min": 1024, - "max": 2047 - }, - { - "min": 2048, - "max": 4095 - }, - { - "min": 4096, - "max": 8191 - }, - { - "min": 8192, - "max": 16383 - }, - { - "min": 16384, - "max": 32767 - }, - { - "min": 32768, - "max": 65535 - }, - { - "min": 65536, - "max": 131071 - }, - { - "min": 131072, - "max": 262143 - }, - { - "min": 262144, - "max": 524287 - }, - { - "min": 524288, - "max": 1048575 - }, - { - "min": 1048576, - "max": 2097151 - }, - { - "min": 2097152, - "max": 4194303 - }, - { - "min": 4194304, - "max": 8388607 - }, - { - "min": 8388608, - "max": 16777215 - }, - { - "min": 16777216, - "max": 33554431 - }, - { - "min": 33554432, - "max": 67108863 - }, - { - "min": 67108864, - "max": 134217727 - }, - { - "min": 134217728, - "max": 268435455 - }, - { - "min": 268435456, - "max": 536870911 - }, - { - "min": 536870912, - "max": 1073741823 - }, - { - "min": 1073741824, - "max": 2147483647 - }, - { - "min": 2147483648, - "max": 4294967295 - }, - { - "min": 4294967296, - "max": 8589934591 - }, - { - "min": 8589934592, - "max": 17179869183 - }, - { - "min": 17179869184, - "max": 34359738367 - }, - { - "min": 34359738368, - "max": 68719476735 - }, - { - "min": 68719476736, - "max": 137438953471 - }, - { - "min": 137438953472, - "max": 274877906943 - }, - { - "min": 274877906944 - } - ] - } - ], - "values": [ - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ], - [ - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0 - ] - ] - } - }, - -This represents the 2d histogram, consisting of 9 history entrires and 32 value groups per each history entry. -"Ranges" element denote value bounds for each of value groups. "Buckets" denote amount of value groups ("buckets"), -"Min" is a minimum accepted valaue, "quant_size" is quantization unit and "scale_type" is either "log2" (logarhitmic -scale) or "linear" (linear scale). -You can use histogram_dump.py tool (see src/tools/histogram_dump.py) for quick visualisation of existing histogram -data. -- cgit 1.2.3-korg