<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Sep 1, 2017 at 1:27 AM, Amar Tumballi <span dir="ltr">&lt;<a href="mailto:atumball@redhat.com" target="_blank">atumball@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Disclaimer: This email is long, and did take significant time to write. Do take time and read, review and give feedback, so we can have some metrics related tasks done by Gluster 4.0<div><br></div><div>---</div><div><b>* History:</b></div><div><br></div><div>To understand what is happening inside GlusterFS process, over the years, we have opened many bugs and also coded few things with regard to statedump, and did put some effort into io-stats translator to improve the gluster&#39;s monitoring capabilities.</div><div><br></div><div>But surely there is more required! And some glimpse of it is captured in [1], [2], [3] &amp; [4]. Also, I did send an email to this group [5] about possibilities of capturing this information.</div><div><br></div><div><b>* Current problem:</b></div><div><br></div><div>When we talk about metrics or monitoring, we have to consider giving out these data to a tool which can preserve the readings in a periodic time, without a time graph, no metrics will make sense! So, the first challenge itself is how to get them out? Should getting the metrics out from each process need &#39;glusterd&#39; interacting? or should we use signals? Which leads us to <b>&#39;challenge #1&#39;.</b></div><div><br></div><div>Next is, should we depend on io-stats to do the reporting? If yes, how to get information from between any two layers? Should we provide io-stats in between all the nodes of translator graph? or should we utilize STACK_WIND/UNWIND framework to get the details? This is our <b>&#39;challenge #2&#39;</b></div><div><br></div><div>Once the above decision will be taken, then the question is, &quot;what about &#39;metrics&#39; from other translators? Who gives it out (ie, dumps it?)? Why do we need something similar to statedump, and can&#39;t we read info from statedump itself?&quot;. But when we say &#39;metrics&#39;, we should have a key and a number associated with it, statedump has lot more, and no format. If its different from statedump, then what is our answer for translator code to give out metrics? This is our <b>&#39;challenge #3</b>&#39;</div><div><br></div><div>If we get a solution to above challenges, then I guess we are in a decent shape for further development. Lets go through them one by one, in detail.</div><div><br></div><div><b>* Problems and proposed solutions:</b></div><div><br></div><div><b>a) how to dump metrics data ?</b></div><div><br></div><div>Currently, I propose signal handler way, as it will give control for us to choose what are the processes we need to capture information on, and will be much faster than communicating through another tool. Also considering we need to have these metrics taken every 10sec or so, there will be a need for efficient way to get this out.</div><div><br></div><div>But even there, we have challenges, because we have already chosen both USR1 and USR2 signal handlers, one for statedump, another for toggling latency monitoring respectively. It makes sense to continue to have statedump use USR1, but toggling options should be technically (for correctness too) be handled by glusterd volume set options, and there should be a way to handle it in a better way by our &#39;reconfigure()&#39; framework in graph-switch. Proposal sent in github issue #303 [6]. </div><div><br></div><div>If we are good with above proposal, then we can make use of USR2 for metrics dump. Next issue will be about the format of the file itself, which we will discuss at the end of the email.</div><div><br></div><div>NOTE: Above approach is already implemented in &#39;experimental&#39; branch, excluding handling of [6].</div></div></blockquote><div><br></div><div><br></div><div>I&#39;m going to pile on with the others discouraging the use of signals and put a vote in favor of using a network socket.</div><div>In a previous project [10], we used a listening TCP socket to provide metrics to graphite. This has the ability to support multiple receivers by just sending a copy to each currently open connection, and if there is a concern about overwhelming receivers and/or slowing down the gluster sending side, these could be non-blocking sockets that simply drop data if there is no room in the outbound buffer. The data format we used was exactly the Graphite text format [11], which includes a timestamp directly with each metric. The downside is extra data, but it removes transmission/processing/queuing latency concerns. In practice, we calculated the timestamp once and used it for all metrics sent in the interval to minimize the overhead imposed by repeated gettimeofday().</div><div>Another reason I like the socket approach is that in containerized environments, I can easily run a sidecar that grabs the metrics and forwards or processes them and it doesn&#39;t have to share anything more than a network port.</div><div><br></div><div>The biggest drawback to the socket approach is it&#39;s passive nature. The receiver is stuck with whatever stat frequency gluster chooses, though this could be configured either globally or per connection.</div><div><br></div><div>[10] <a href="https://github.com/NTAP/chronicle/">https://github.com/NTAP/chronicle/</a></div><div>[11] <a href="https://graphite.readthedocs.io/en/latest/feeding-carbon.html#the-plaintext-protocol">https://graphite.readthedocs.io/en/latest/feeding-carbon.html#the-plaintext-protocol</a></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><br></div><div><b>b) where to measure the latency and fops counts?</b></div><div><br></div><div>One of the possible way is to load io-stats in between all the nodes, but it has its own limitations. Mainly, how to configure options in each of this translator, will having too many translators slow down operation ? (ie, create one extra &#39;frame&#39; for every fop, and in a graph of 20 xlator, it will be 20 extra frame creates for a single fop).</div><div><br></div><div>I propose we handle this in &#39;STACK_WIND/UNWIND&#39; macros itself, and provide a placeholder to store all this data in translator structure itself. This will be more cleaner, and no changes are required in code base, other than in &#39;stack.h (and some in xlator.h)&#39;.</div><div><br></div><div>Also, we can provide &#39;option monitoring enable&#39; (or disable) option as a default option for every translator, and can handle it at xlator_init() time itself. (This is not a blocker for 4.0, but good to have). Idea proposed @ github #304 [7]. </div><div><br></div><div></div></div></blockquote><div><br></div><div>I really don&#39;t like disabling the monitoring. If we design the infrastructure correctly, the overhead is minimal, and it&#39;s always easily available to users. If there is a question of whether the monitoring is fast and/or robust enough for continuous use in production use, we&#39;ve missed the mark.</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>NOTE: this approach is working pretty good already at &#39;experimental&#39; branch, excluding [7]. Depending on feedback, we can improve it further.</div><div><br></div><div><b>c) framework for xlators to provide private metrics</b></div><div><br></div><div>One possible solution is to use statedump functions. But to cause least disruption to an existing code, I propose 2 new methods. &#39;dump_metrics()&#39;, and &#39;reset_metrics()&#39; to xlator methods, which can be dl_open()&#39;d to xlator structure.</div><div><br></div><div>&#39;dump_metrics()&#39; dumps the private metrics in the expected format, and will be called from the global dump-metrics framework, and &#39;reset_metrics()&#39; would be called from a CLI command when someone wants to restart metrics from 0 to check / validate few things in a running cluster. Helps debug-ability.</div></div></blockquote><div><br></div><div>Having a &quot;reset&quot; function complicates the data processing and analysis because it implies that there is a single consumer of the metrics data. Ok for debugging, I guess, but no legitimate consumer should ever use it.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><br></div><div>Further feedback welcome.</div><div><br></div><div>NOTE: a sample code is already implemented in &#39;experimental&#39; branch, and protocol/server xlator uses this framework to dump metrics from rpc layer, and client connections.</div><div><br></div><div><b>d) format of the &#39;metrics&#39; file.</b></div><div><br></div><div>If you want any plot-able data on a graph, you need key (should be string), and value (should be a number), collected over time. So, this file should output data for the monitoring systems and not exactly for the debug-ability. We have &#39;statedump&#39; for debug-ability.</div><div><br></div><div>So, I propose a plain text file, where data would be dumped like below.</div><div><br></div><div>```</div><div># anything starting from # would be treated as comment.</div><div>&lt;key&gt;&lt;space&gt;&lt;value&gt;</div><div># anything after the value would be ignored.</div><div>```</div><div>Any better solutions are welcome. Ideally, we should keep this friendly for external projects to consume, like tendrl [8] or graphite, prometheus etc. Also note that, once we agree to the format, it would be very hard to change it as external projects would use it.</div><div><br></div><div>I would like to hear the feedback from people who are experienced with monitoring systems here.</div><div><br></div><div>NOTE: the above format works fine with &#39;glustermetrics&#39; project [9] and is working decently on &#39;experimental&#39; branch. </div><div><br></div></div></blockquote><div><br></div><div>As mentioned above, I&#39;ve previously used the Graphite plain text format: &lt;metric_name&gt;&lt;space&gt;&lt;value&gt;&lt;space&gt;&lt;timestamp&gt;. The common thing to do here is to have the metric name form a hierarchy to add structure to the metrics: &quot;system.cpu.user.2&quot; would be user-mode time from cpu core 2, for example. Prometheus seems to be slightly different in that it adds labels to the metrics [12].</div><div><br></div><div>[12] <a href="https://prometheus.io/docs/concepts/data_model/">https://prometheus.io/docs/concepts/data_model/</a></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div></div><div>------</div><div><br></div><div><b>* Discussions:</b></div><div><br></div><div>Let me know how you all want to take the discussion forward? </div><div><br></div><div>Should we get to github, and discuss on each issue? or should I rebase and send the current patches from experimental to &#39;master&#39; branch and discuss in our review system?  Or should we continue on the email here!</div><div><br></div><div>Regards,</div><div>Amar</div><div><br></div><div>References:</div><div><br></div><div>[1] - <a href="https://github.com/gluster/glusterfs/issues/137" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/137</a></div><div>[2] - <a href="https://github.com/gluster/glusterfs/issues/141" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/141</a></div><div>[3] - <a href="https://github.com/gluster/glusterfs/issues/275" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/275</a></div><div>[4] - <a href="https://github.com/gluster/glusterfs/issues/168" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/168</a></div><div>[5] - <a href="http://lists.gluster.org/pipermail/maintainers/2017-August/002954.html" target="_blank">http://lists.gluster.org/<wbr>pipermail/maintainers/2017-<wbr>August/002954.html</a> (last email of the thread).</div><div>[6] - <a href="https://github.com/gluster/glusterfs/issues/303" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/303</a></div><div>[7] - <a href="https://github.com/gluster/glusterfs/issues/304" target="_blank">https://github.com/gluster/<wbr>glusterfs/issues/304</a><br clear="all"><div>[8] - <a href="https://github.com/Tendrl" target="_blank">https://github.com/Tendrl</a></div><div>[9] - <a href="https://github.com/amarts/glustermetrics" target="_blank">https://github.com/amarts/<wbr>glustermetrics</a></div><span class="gmail-HOEnZb"><font color="#888888"><div><br></div>-- <br><div class="gmail-m_1869162630638246779gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Amar Tumballi (amarts)<br></div></div></div></div></div>
</font></span></div></div>
<br>______________________________<wbr>_________________<br>
Gluster-devel mailing list<br>
<a href="mailto:Gluster-devel@gluster.org">Gluster-devel@gluster.org</a><br>
<a href="http://lists.gluster.org/mailman/listinfo/gluster-devel" rel="noreferrer" target="_blank">http://lists.gluster.org/<wbr>mailman/listinfo/gluster-devel</a><br></blockquote></div><br></div></div>