blob: 3b87cbdbebeb55490b9373b9f3738a2b54b41e1a [file] [log] [blame]
<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">6.4.&#160;Prometheus Metrics</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Management-Channel-REST-API.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;6.&#160;Management Channels</th><td align="right" width="20%">&#160;<a accesskey="n" href="Java-Broker-Management-Channel-AMQP-Intrinstic.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Java-Broker-Management-Metrics"></a>6.4.&#160;Prometheus Metrics</h2></div></div></div><p>This section describes the metrics endpoints exposing broker statistics in
<a class="link" href="https://prometheus.io/" target="_top">Prometheus format</a>.
The metrics endpoint is intended for scraping by Prometheus server to collect the Broker telemetry.</p><p>The Prometheus metric endpoints are mapped under /metrics path and /metrics/*.
The latter allows to get the Virtual Host statistics by specify the path to the virtual host as
/metrics/&lt;virtual host node name&gt;/&lt; virtual host name&gt;.
The former allow to get all Broker statistics or Virtual Host statistics when called with HOST header
set to the Virtual Host name</p><p>
The metrics endpoints allow anonymous access by default. If required, an authentication can be enabled for the
metrics endpoints by setting http management context variable
<code class="literal">qpid.httpManagement.enableMetricContentAuthentication</code> to <code class="literal">true</code>.
</p><p>The Broker JVM statistics are disabled by default. The metrics endpoints can be called with parameter
<code class="literal">includeDisabled</code> set to <code class="literal">true</code> to include JVM broker metrics into endpoint
output. If required, the JVM metrics could be enabled by setting context variable
<code class="literal">qpid.metrics.includeDisabled</code> to <code class="literal">true</code>.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>For more information about Prometheus, check out the
<a class="link" href="https://prometheus.io/docs/introduction/overview/" target="_top">prometheus documentation</a>.
</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Management-Channel-REST-API.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="Java-Broker-Management-Channel.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="Java-Broker-Management-Channel-AMQP-Intrinstic.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">6.3.&#160;REST API&#160;</td><td align="center" width="20%"><a accesskey="h" href="Apache-Qpid-Broker-J-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;6.5.&#160;AMQP Intrinstic Management</td></tr></table></div></div>