Doc: add use cases for `dashboard global` (#65)
diff --git a/README.md b/README.md
index c1d0dee..62ee0da 100644
--- a/README.md
+++ b/README.md
@@ -579,6 +579,17 @@
<details>
+<summary>Query the data of global dashboard</summary>
+
+```shell
+$ ./bin/swctl db g
+{"metrics":[[{"name":"projectC.business-zone","id":"","value":"210","refId":null},{"name":"projectD.business-zone","id":"","value":"198","refId":null},{"name":"projectB.business-zone","id":"","value":"198","refId":null},{"name":"load balancer1.system","id":"","value":"197","refId":null},{"name":"load balancer2.system","id":"","value":"197","refId":null},{"name":"projectA.business-zone","id":"","value":"197","refId":null}],[{"name":"projectC.business-zone","id":"","value":"4576","refId":null},{"name":"load balancer1.system","id":"","value":"2001","refId":null},{"name":"load balancer2.system","id":"","value":"2000","refId":null},{"name":"projectA.business-zone","id":"","value":"1996","refId":null},{"name":"projectB.business-zone","id":"","value":"639","refId":null},{"name":"projectD.business-zone","id":"","value":"0","refId":null}],[{"name":"load balancer2.system","id":"","value":"3086","refId":null},{"name":"projectA.business-zone","id":"","value":"3086","refId":null},{"name":"load balancer1.system","id":"","value":"3087","refId":null},{"name":"projectC.business-zone","id":"","value":"4725","refId":null},{"name":"projectB.business-zone","id":"","value":"7453","refId":null},{"name":"projectD.business-zone","id":"","value":"10000","refId":null}],[{"name":"projectC.business-zone - /projectC/{value}","id":"","value":"4576","refId":null},{"name":"projectA.business-zone - /projectA/{name}","id":"","value":"1998","refId":null},{"name":"load balancer1.system - /projectA/test","id":"","value":"1997","refId":null},{"name":"load balancer2.system - /projectA/test","id":"","value":"1997","refId":null},{"name":"projectB.business-zone - /projectB/{value}","id":"","value":"639","refId":null},{"name":"projectD.business-zone - Kafka/test-trace-topic/Consumer/test","id":"","value":"0","refId":null}]],"responseLatency":[{"2020-10-08 1911":1130,"2020-10-08 1912":1100,"2020-10-08 1913":1130,"2020-10-08 1914":1130,"2020-10-08 1915":1120,"2020-10-08 1916":1130,"2020-10-08 1917":1120,"2020-10-08 1918":1120,"2020-10-08 1919":1120,"2020-10-08 1920":1130,"2020-10-08 1921":1120,"2020-10-08 1922":1120,"2020-10-08 1923":1130,"2020-10-08 1924":1130,"2020-10-08 1925":1130,"2020-10-08 1926":1130,"2020-10-08 1927":1130,"2020-10-08 1928":1130,"2020-10-08 1929":1130,"2020-10-08 1930":1120,"2020-10-08 1931":1130,"2020-10-08 1932":1130,"2020-10-08 1933":1130,"2020-10-08 1934":1120,"2020-10-08 1935":1100,"2020-10-08 1936":1130,"2020-10-08 1937":1120,"2020-10-08 1938":1130,"2020-10-08 1939":1120,"2020-10-08 1940":1130,"2020-10-08 1941":1110},{"2020-10-08 1911":2130,"2020-10-08 1912":2130,"2020-10-08 1913":2130,"2020-10-08 1914":2130,"2020-10-08 1915":2130,"2020-10-08 1916":2130,"2020-10-08 1917":2120,"2020-10-08 1918":2130,"2020-10-08 1919":2130,"2020-10-08 1920":2130,"2020-10-08 1921":2120,"2020-10-08 1922":2120,"2020-10-08 1923":2130,"2020-10-08 1924":2120,"2020-10-08 1925":2130,"2020-10-08 1926":2130,"2020-10-08 1927":2130,"2020-10-08 1928":2170,"2020-10-08 1929":2130,"2020-10-08 1930":2120,"2020-10-08 1931":2130,"2020-10-08 1932":2130,"2020-10-08 1933":2130,"2020-10-08 1934":2020,"2020-10-08 1935":2130,"2020-10-08 1936":2130,"2020-10-08 1937":2130,"2020-10-08 1938":2130,"2020-10-08 1939":2130,"2020-10-08 1940":2130,"2020-10-08 1941":2020},{"2020-10-08 1911":3130,"2020-10-08 1912":3130,"2020-10-08 1913":3130,"2020-10-08 1914":3130,"2020-10-08 1915":3130,"2020-10-08 1916":3130,"2020-10-08 1917":3120,"2020-10-08 1918":3150,"2020-10-08 1919":3130,"2020-10-08 1920":3130,"2020-10-08 1921":3130,"2020-10-08 1922":3130,"2020-10-08 1923":3130,"2020-10-08 1924":3130,"2020-10-08 1925":3130,"2020-10-08 1926":3130,"2020-10-08 1927":3160,"2020-10-08 1928":3160,"2020-10-08 1929":3130,"2020-10-08 1930":3120,"2020-10-08 1931":3130,"2020-10-08 1932":3130,"2020-10-08 1933":3130,"2020-10-08 1934":3130,"2020-10-08 1935":3130,"2020-10-08 1936":3130,"2020-10-08 1937":3130,"2020-10-08 1938":3130,"2020-10-08 1939":3130,"2020-10-08 1940":3130,"2020-10-08 1941":3130},{"2020-10-08 1911":3190,"2020-10-08 1912":3210,"2020-10-08 1913":3290,"2020-10-08 1914":3220,"2020-10-08 1915":3260,"2020-10-08 1916":3270,"2020-10-08 1917":3230,"2020-10-08 1918":3280,"2020-10-08 1919":3260,"2020-10-08 1920":3230,"2020-10-08 1921":3180,"2020-10-08 1922":3200,"2020-10-08 1923":3210,"2020-10-08 1924":3190,"2020-10-08 1925":3440,"2020-10-08 1926":3190,"2020-10-08 1927":3240,"2020-10-08 1928":3210,"2020-10-08 1929":3260,"2020-10-08 1930":3200,"2020-10-08 1931":3240,"2020-10-08 1932":3280,"2020-10-08 1933":3200,"2020-10-08 1934":3200,"2020-10-08 1935":3260,"2020-10-08 1936":3230,"2020-10-08 1937":3360,"2020-10-08 1938":3200,"2020-10-08 1939":5190,"2020-10-08 1940":3180,"2020-10-08 1941":3170},{"2020-10-08 1911":60020,"2020-10-08 1912":8220,"2020-10-08 1913":60020,"2020-10-08 1914":60020,"2020-10-08 1915":60020,"2020-10-08 1916":60020,"2020-10-08 1917":60020,"2020-10-08 1918":60020,"2020-10-08 1919":60020,"2020-10-08 1920":60020,"2020-10-08 1921":60030,"2020-10-08 1922":60020,"2020-10-08 1923":8180,"2020-10-08 1924":8130,"2020-10-08 1925":60020,"2020-10-08 1926":8160,"2020-10-08 1927":60020,"2020-10-08 1928":8170,"2020-10-08 1929":60020,"2020-10-08 1930":60020,"2020-10-08 1931":60020,"2020-10-08 1932":8140,"2020-10-08 1933":8140,"2020-10-08 1934":8160,"2020-10-08 1935":60060,"2020-10-08 1936":60020,"2020-10-08 1937":60020,"2020-10-08 1938":60020,"2020-10-08 1939":60020,"2020-10-08 1940":8130,"2020-10-08 1941":7190}],"heatMap":{"values":[{"id":"202010081911","values":[279,171,20,0,0,0,0,1,0,0,71,247,48,11,0,0,0,0,0,1,394]},{"id":"202010081912","values":[278,226,31,0,1,0,0,0,0,0,65,223,27,0,0,0,0,0,0,0,400]},{"id":"202010081913","values":[268,156,25,1,0,0,0,0,0,0,62,257,27,9,0,0,0,0,0,0,399]},{"id":"202010081914","values":[265,143,13,6,0,0,0,0,0,1,72,263,23,4,3,0,0,0,3,3,404]},{"id":"202010081915","values":[269,166,25,0,0,0,0,1,0,1,68,232,33,6,0,0,0,0,0,0,403]},{"id":"202010081916","values":[246,141,17,3,0,0,0,0,0,0,61,255,29,8,1,0,0,0,0,0,410]},{"id":"202010081917","values":[267,182,27,0,0,0,0,0,0,0,73,248,29,4,0,0,0,0,0,0,393]},{"id":"202010081918","values":[278,192,22,5,0,0,0,0,1,0,55,241,39,1,0,0,0,0,3,0,398]},{"id":"202010081919","values":[276,165,37,4,0,0,0,0,0,1,57,268,21,3,6,0,0,0,0,0,383]},{"id":"202010081920","values":[267,181,18,0,0,0,0,0,0,0,77,259,45,3,0,0,0,0,0,0,390]},{"id":"202010081921","values":[286,169,11,12,0,0,0,0,0,0,54,264,41,14,1,0,0,0,1,3,383]},{"id":"202010081922","values":[268,178,9,0,0,3,0,0,0,0,66,268,23,3,0,1,0,0,1,1,400]},{"id":"202010081923","values":[267,169,8,0,0,0,0,0,0,0,63,284,22,0,0,0,0,0,0,0,403]},{"id":"202010081924","values":[264,174,3,0,0,0,0,0,0,0,72,292,23,0,0,0,0,0,0,0,385]},{"id":"202010081925","values":[254,189,7,0,0,0,0,0,0,0,73,238,21,0,0,0,0,0,0,0,416]},{"id":"202010081926","values":[247,136,12,0,0,0,0,0,0,0,65,257,16,5,0,0,0,0,0,0,427]},{"id":"202010081927","values":[260,135,17,3,0,0,0,1,0,0,53,244,40,3,1,3,0,3,0,0,412]},{"id":"202010081928","values":[258,116,33,3,0,0,0,0,0,0,66,253,45,4,0,0,0,0,0,0,405]},{"id":"202010081929","values":[258,190,17,0,0,0,0,0,0,0,59,214,24,4,0,0,0,0,0,0,438]},{"id":"202010081930","values":[278,197,11,4,0,0,0,0,0,0,70,254,29,0,0,0,0,0,0,0,399]},{"id":"202010081931","values":[277,184,14,0,0,0,0,0,0,0,58,253,29,3,0,0,3,1,3,0,410]},{"id":"202010081932","values":[254,169,5,0,0,0,0,0,0,0,65,217,45,10,0,0,0,5,0,0,405]},{"id":"202010081933","values":[270,152,15,1,0,0,0,0,0,0,65,284,25,0,0,0,0,0,0,0,407]},{"id":"202010081934","values":[271,188,15,0,0,0,0,0,0,0,74,308,8,9,0,0,0,0,0,0,363]},{"id":"202010081935","values":[283,174,39,7,0,0,0,0,0,0,63,254,38,2,0,0,0,0,0,0,385]},{"id":"202010081936","values":[259,150,18,3,0,0,0,0,0,0,85,260,28,0,0,0,0,0,0,0,399]},{"id":"202010081937","values":[264,191,21,1,0,0,0,1,0,0,67,226,15,1,0,0,1,3,1,3,417]},{"id":"202010081938","values":[265,175,13,0,0,0,0,0,0,0,53,259,29,3,0,0,0,0,0,0,392]},{"id":"202010081939","values":[272,191,13,0,0,0,0,0,0,0,67,267,19,3,0,0,0,0,0,0,394]},{"id":"202010081940","values":[254,136,23,0,0,0,0,0,0,0,67,274,20,2,0,0,0,0,0,0,398]},{"id":"202010081941","values":[216,141,3,0,0,0,0,0,1,0,47,205,14,4,0,0,0,0,3,1,260]}],"buckets":[{"min":"0","max":"100"},{"min":"100","max":"200"},{"min":"200","max":"300"},{"min":"300","max":"400"},{"min":"400","max":"500"},{"min":"500","max":"600"},{"min":"600","max":"700"},{"min":"700","max":"800"},{"min":"800","max":"900"},{"min":"900","max":"1000"},{"min":"1000","max":"1100"},{"min":"1100","max":"1200"},{"min":"1200","max":"1300"},{"min":"1300","max":"1400"},{"min":"1400","max":"1500"},{"min":"1500","max":"1600"},{"min":"1600","max":"1700"},{"min":"1700","max":"1800"},{"min":"1800","max":"1900"},{"min":"1900","max":"2000"},{"min":"2000","max":"infinite+"}]}}
+```
+
+</details>
+
+<details>
+
<summary>Display the spans of a trace</summary>
```shell
@@ -599,6 +610,16 @@
<details>
+<summary>Display the global dashboard</summary>
+
+```shell
+$ ./bin/swctl --display graph db g
+```
+
+</details>
+
+<details>
+
<summary>Automatically convert to server side timezone</summary>
if your backend nodes are deployed in docker and the timezone is UTC, you may not want to convert your timezone to UTC every time you type a command, `--timezone` comes to your rescue.
