| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/><meta http-equiv="X-UA-Compatible" content="IE=9"/><meta name="generator" content="Doxygen 1.8.17"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Prometheus Client Library for Modern C++: /home/runner/work/prometheus-cpp/prometheus-cpp/core/include/prometheus/registry.h Source File</title><link href="tabs.css" rel="stylesheet" type="text/css"/><script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="dynsections.js"></script><link href="search/search.css" rel="stylesheet" type="text/css"/><script type="text/javascript" src="search/searchdata.js"></script><script type="text/javascript" src="search/search.js"></script><link href="doxygen.css" rel="stylesheet" type="text/css" /></head><body><div id="top"><!-- do not remove this div, it is closed by doxygen! --><div id="titlearea"><table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;">  <td id="projectalign" style="padding-left: 0.5em;">   <div id="projectname">Prometheus Client Library for Modern C++   </div>  </td> </tr> </tbody></table></div><!-- end header part --><!-- Generated by Doxygen 1.8.17 --><script type="text/javascript">/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */var searchBox = new SearchBox("searchBox", "search",false,'Search');/* @license-end */</script><script type="text/javascript" src="menudata.js"></script><script type="text/javascript" src="menu.js"></script><script type="text/javascript">/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */$(function() {  initMenu('',true,false,'search.php','Search');  $(document).ready(function() { init_search(); });});/* @license-end */</script><div id="main-nav"></div><!-- window showing the filter options --><div id="MSearchSelectWindow"     onmouseover="return searchBox.OnSearchSelectShow()"     onmouseout="return searchBox.OnSearchSelectHide()"     onkeydown="return searchBox.OnSearchSelectKey(event)"></div><!-- iframe showing the search results (closed by default) --><div id="MSearchResultsWindow"><iframe src="javascript:void(0)" frameborder="0"         name="MSearchResults" id="MSearchResults"></iframe></div><div id="nav-path" class="navpath">  <ul><li class="navelem"><a class="el" href="dir_4270bfced15e0e73154b13468c7c9ad9.html">core</a></li><li class="navelem"><a class="el" href="dir_24d671cfcbc5d5238a6bd565a49d198f.html">include</a></li><li class="navelem"><a class="el" href="dir_295ae2ed1145107b149842d99fe0c63c.html">prometheus</a></li>  </ul></div></div><!-- top --><div class="header">  <div class="headertitle"><div class="title">registry.h</div>  </div></div><!--header--><div class="contents"><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span> <span class="preprocessor">#pragma once</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>  </div><div class="line"><a name="l00003"></a><span class="lineno">    3</span> <span class="preprocessor">#include <map></span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span> <span class="preprocessor">#include <memory></span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span> <span class="preprocessor">#include <mutex></span></div><div class="line"><a name="l00006"></a><span class="lineno">    6</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span> <span class="preprocessor">#include <vector></span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>  </div><div class="line"><a name="l00009"></a><span class="lineno">    9</span> <span class="preprocessor">#include "prometheus/collectable.h"</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span> <span class="preprocessor">#include "prometheus/detail/core_export.h"</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span> <span class="preprocessor">#include "prometheus/family.h"</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span> <span class="preprocessor">#include "prometheus/metric_family.h"</span></div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>  </div><div class="line"><a name="l00014"></a><span class="lineno">   14</span> <span class="keyword">namespace </span>prometheus {</div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>  </div><div class="line"><a name="l00016"></a><span class="lineno">   16</span> <span class="keyword">class </span>Counter;</div><div class="line"><a name="l00017"></a><span class="lineno">   17</span> <span class="keyword">class </span>Gauge;</div><div class="line"><a name="l00018"></a><span class="lineno">   18</span> <span class="keyword">class </span>Histogram;</div><div class="line"><a name="l00019"></a><span class="lineno">   19</span> <span class="keyword">class </span>Summary;</div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>  </div><div class="line"><a name="l00021"></a><span class="lineno">   21</span> <span class="keyword">namespace </span>detail {</div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>  </div><div class="line"><a name="l00023"></a><span class="lineno">   23</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00024"></a><span class="lineno">   24</span> <span class="keyword">class </span>Builder;  <span class="comment">// IWYU pragma: keep</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>  </div><div class="line"><a name="l00026"></a><span class="lineno">   26</span> }</div><div class="line"><a name="l00040"></a><span class="lineno"><a class="line" href="classprometheus_1_1Registry.html">   40</a></span> <span class="keyword">class </span>PROMETHEUS_CPP_CORE_EXPORT <a class="code" href="classprometheus_1_1Registry.html">Registry</a> : <span class="keyword">public</span> <a class="code" href="classprometheus_1_1Collectable.html">Collectable</a> {</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>  <span class="keyword">public</span>:</div><div class="line"><a name="l00046"></a><span class="lineno"><a class="line" href="classprometheus_1_1Registry.html#ae8018ea1ad010207ee4c0045e18d1a40">   46</a></span>   <span class="keyword">enum class</span> <a class="code" href="classprometheus_1_1Registry.html#ae8018ea1ad010207ee4c0045e18d1a40">InsertBehavior</a> {</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>     Merge,</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>     Throw,</div><div class="line"><a name="l00056"></a><span class="lineno">   56</span>     NonStandardAppend,</div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>   };</div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>  </div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>   <span class="keyword">explicit</span> <a class="code" href="classprometheus_1_1Registry.html">Registry</a>(InsertBehavior insert_behavior = InsertBehavior::Merge);</div><div class="line"><a name="l00063"></a><span class="lineno">   63</span>  </div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>   ~<a class="code" href="classprometheus_1_1Registry.html">Registry</a>();</div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>  </div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>   std::vector<MetricFamily> Collect() <span class="keyword">const override</span>;</div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>  </div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>  <span class="keyword">private</span>:</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>   <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>   <span class="keyword">friend</span> <span class="keyword">class </span>detail::Builder;</div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>  </div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>   <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>   std::vector<std::unique_ptr<Family<T>>>& GetFamilies();</div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>  </div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>   <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>   <span class="keywordtype">bool</span> NameExistsInOtherType(<span class="keyword">const</span> std::string& name) <span class="keyword">const</span>;</div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>  </div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>   <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>   <a class="code" href="classprometheus_1_1Family.html">Family<T></a>& Add(<span class="keyword">const</span> std::string& name, <span class="keyword">const</span> std::string& help,</div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>                  <span class="keyword">const</span> std::map<std::string, std::string>& labels);</div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>  </div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>   <span class="keyword">const</span> InsertBehavior insert_behavior_;</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>   std::vector<std::unique_ptr<Family<Counter>>> counters_;</div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>   std::vector<std::unique_ptr<Family<Gauge>>> gauges_;</div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>   std::vector<std::unique_ptr<Family<Histogram>>> histograms_;</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>   std::vector<std::unique_ptr<Family<Summary>>> summaries_;</div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>   <span class="keyword">mutable</span> std::mutex mutex_;</div><div class="line"><a name="l00095"></a><span class="lineno">   95</span> };</div><div class="line"><a name="l00096"></a><span class="lineno">   96</span>  </div><div class="line"><a name="l00097"></a><span class="lineno">   97</span> }  <span class="comment">// namespace prometheus</span></div></div><!-- fragment --></div><!-- contents --><div class="ttc" id="aclassprometheus_1_1Collectable_html"><div class="ttname"><a href="classprometheus_1_1Collectable.html">prometheus::Collectable</a></div><div class="ttdoc">Interface implemented by anything that can be used by Prometheus to collect metrics.</div><div class="ttdef"><b>Definition:</b> collectable.h:17</div></div><div class="ttc" id="aclassprometheus_1_1Family_html"><div class="ttname"><a href="classprometheus_1_1Family.html">prometheus::Family</a></div><div class="ttdoc">A metric of type T with a set of labeled dimensions.</div><div class="ttdef"><b>Definition:</b> family.h:61</div></div><div class="ttc" id="aclassprometheus_1_1Registry_html_ae8018ea1ad010207ee4c0045e18d1a40"><div class="ttname"><a href="classprometheus_1_1Registry.html#ae8018ea1ad010207ee4c0045e18d1a40">prometheus::Registry::InsertBehavior</a></div><div class="ttdeci">InsertBehavior</div><div class="ttdoc">How to deal with repeatedly added family names for a type.</div><div class="ttdef"><b>Definition:</b> registry.h:46</div></div><div class="ttc" id="aclassprometheus_1_1Registry_html"><div class="ttname"><a href="classprometheus_1_1Registry.html">prometheus::Registry</a></div><div class="ttdoc">Manages the collection of a number of metrics.</div><div class="ttdef"><b>Definition:</b> registry.h:40</div></div><!-- start footer part --><hr class="footer"/><address class="footer"><small>Generated by  <a href="http://www.doxygen.org/index.html"><img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.17</small></address></body></html>
 |