You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2020/10/25 00:04:49 UTC
svn commit: r1067100 - in /websites/production/cxf/content:
cache/docs.pageCache docs/metrics.html docs/micrometer.html
Author: buildbot
Date: Sun Oct 25 00:04:49 2020
New Revision: 1067100
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/metrics.html
websites/production/cxf/content/docs/micrometer.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/metrics.html
==============================================================================
--- websites/production/cxf/content/docs/metrics.html (original)
+++ websites/production/cxf/content/docs/metrics.html Sun Oct 25 00:04:49 2020
@@ -107,7 +107,7 @@ Apache CXF -- Metrics
<td height="100%">
<!-- Content -->
<div class="wiki-content">
-<div id="ConfluenceContent"><p>The services built on top of Apache CXF are used in production systems and as such, have to provide all the necessary telemetry / business / application / operational metrics in order to be closely monitored. There are two metric libraries which  Apache CXF integrates with.</p><p><a shape="rect" href="dropwizard-metrics.html">Dropwizard Metrics</a> (since <strong>3.1.0</strong>)</p><p><a shape="rect" href="micrometer.html">Micrometer</a> (since <strong>3.4.1</strong>)</p></div>
+<div id="ConfluenceContent"><p>The services built on top of Apache CXF are used in production systems and as such, have to provide all the necessary telemetry / business / application / operational metrics in order to be closely monitored. There are two metric libraries which  Apache CXF integrates with.</p><p><a shape="rect" href="dropwizard-metrics.html">Dropwizard Metrics</a> (since <strong>3.1.0</strong>)</p><p><a shape="rect" href="micrometer.html">Micrometer</a> (since <strong>3.4.1 / 3.3.8</strong>)</p></div>
</div>
<!-- Content -->
</td>
Modified: websites/production/cxf/content/docs/micrometer.html
==============================================================================
--- websites/production/cxf/content/docs/micrometer.html (original)
+++ websites/production/cxf/content/docs/micrometer.html Sun Oct 25 00:04:49 2020
@@ -118,13 +118,13 @@ Apache CXF -- Micrometer
<!-- Content -->
<div class="wiki-content">
<div id="ConfluenceContent"><p><style type="text/css">/*<![CDATA[*/
-div.rbtoc1603569390228 {padding: 0px;}
-div.rbtoc1603569390228 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1603569390228 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1603584072654 {padding: 0px;}
+div.rbtoc1603584072654 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1603584072654 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1603569390228">
-<ul class="toc-indentation"><li><a shape="rect" href="#Micrometer-MetricsProvider">Metrics Provider</a></li><li><a shape="rect" href="#Micrometer-Configuration">Configuration</a></li><li><a shape="rect" href="#Micrometer-IntegrationwithJAX-WS">Integration with JAX-WS</a></li><li><a shape="rect" href="#Micrometer-IntegrationwithJAX-RS">Integration with JAX-RS</a></li></ul>
-</div><h2 id="Micrometer-MetricsProvider">Metrics Provider</h2><p>The <a shape="rect" class="external-link" href="https://micrometer.io/" rel="nofollow">Micrometer</a> integration is provided by <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/MicrometerMetricsProvider.java" rel="nofollow">MicrometerMetricsProvider</a>.</p><h2 id="Micrometer-Configuration">Configuration</h2><p>There <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/MicrometerMetricsProvider.java" rel="nofollow">MicrometerMetricsProvider</a> supports the following properties (encapsulated inside <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/MicrometerMetricsProperties.java" rel="nofollow">MicrometerMetrics
Properties</a>).</p><div class="table-wrap"><table class="wrapped confluenceTable"><colgroup span="1"><col span="1"><col span="1"><col span="1"></colgroup><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Property</th><th colspan="1" rowspan="1" class="confluenceTh">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Default</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><strong>autoTimeRequests</strong></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Whether requests handled by CXF should be automatically timed.  If the number of time series emitted grows <br clear="none">too large on account of request mapping timings, set it to "false" and use <a shape="rect" class="external-link" href="https://github.com/micrometer-metrics/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/Timed.java" rel="nofollow">@Timed</a> or <a shape="rect" class="external-link" href="https://github.com/micrometer-metric
s/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/TimedSet.java" rel="nofollow">@TimeSet</a> on a per <br clear="none">invocation basis as needed.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><strong>requestsMetricName</strong></td><td colspan="1" rowspan="1" class="confluenceTd">Name of the metric for received requests</td><td colspan="1" rowspan="1" class="confluenceTd"><strong>cxf.server.requests</strong></td></tr></tbody></table></div><h2 id="Micrometer-IntegrationwithJAX-WS">Integration with JAX-WS</h2><p>The typical way to plug <a shape="rect" class="external-link" href="https://micrometer.io/" rel="nofollow">Micrometer</a> integration is by using <a shape="rect" class="external-link" href="https://docs.oracle.com/javase/7/docs/api/javax/xml/ws/WebServiceFeature.html" rel="nofollow">WebServiceFeature</a> mechanism, for which there is a dedicated <a
shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/MetricsFeature.java" rel="nofollow">MetricsFeature</a> implementation. The snipped below illustrated the basic initialization sequence and set of the dependencies involved.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+/*]]>*/</style></p><div class="toc-macro rbtoc1603584072654">
+<ul class="toc-indentation"><li><a shape="rect" href="#Micrometer-Introduction">Introduction</a></li><li><a shape="rect" href="#Micrometer-MetricsProvider">Metrics Provider</a></li><li><a shape="rect" href="#Micrometer-Configuration">Configuration</a></li><li><a shape="rect" href="#Micrometer-IntegrationwithJAX-WS">Integration with JAX-WS</a></li><li><a shape="rect" href="#Micrometer-IntegrationwithJAX-RS">Integration with JAX-RS</a></li></ul>
+</div><h2 id="Micrometer-Introduction">Introduction</h2><p>The <a shape="rect" class="external-link" href="https://micrometer.io/" rel="nofollow">Micrometer</a> metrics library become a de factor instrumentation choice for JVM application. It has been supported by Apache CXF starting from <strong>3.4.1</strong> / <strong>3.3.8 </strong>and above.</p><h2 id="Micrometer-MetricsProvider">Metrics Provider</h2><p>The <a shape="rect" class="external-link" href="https://micrometer.io/" rel="nofollow">Micrometer</a> integration is provided by <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/MicrometerMetricsProvider.java" rel="nofollow">MicrometerMetricsProvider</a>.</p><h2 id="Micrometer-Configuration">Configuration</h2><p>There <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/Microm
eterMetricsProvider.java" rel="nofollow">MicrometerMetricsProvider</a> supports the following properties (encapsulated inside <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/micrometer/MicrometerMetricsProperties.java" rel="nofollow">MicrometerMetricsProperties</a>).</p><div class="table-wrap"><table class="wrapped confluenceTable"><colgroup span="1"><col span="1"><col span="1"><col span="1"></colgroup><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Property</th><th colspan="1" rowspan="1" class="confluenceTh">Description</th><th colspan="1" rowspan="1" class="confluenceTh">Default</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><strong>autoTimeRequests</strong></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Whether requests handled by CXF should be automatically timed.  If the number of time series emitted grows <br clear="none">too large on account
of request mapping timings, set it to "false" and use <a shape="rect" class="external-link" href="https://github.com/micrometer-metrics/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/Timed.java" rel="nofollow">@Timed</a> or <a shape="rect" class="external-link" href="https://github.com/micrometer-metrics/micrometer/blob/master/micrometer-core/src/main/java/io/micrometer/core/annotation/TimedSet.java" rel="nofollow">@TimeSet</a> on a per <br clear="none">invocation basis as needed.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><strong>true</strong></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><strong>requestsMetricName</strong></td><td colspan="1" rowspan="1" class="confluenceTd">Name of the metric for received requests</td><td colspan="1" rowspan="1" class="confluenceTd"><strong>cxf.server.requests</strong></td></tr></tbody></table></div><h2 id="Micrometer-IntegrationwithJAX-WS">Integration with JAX-WS</h2><p>The
typical way to plug <a shape="rect" class="external-link" href="https://micrometer.io/" rel="nofollow">Micrometer</a> integration is by using <a shape="rect" class="external-link" href="https://docs.oracle.com/javase/7/docs/api/javax/xml/ws/WebServiceFeature.html" rel="nofollow">WebServiceFeature</a> mechanism, for which there is a dedicated <a shape="rect" class="external-link" href="https://github.com/apache/cxf/blob/master/rt/features/metrics/src/main/java/org/apache/cxf/metrics/MetricsFeature.java" rel="nofollow">MetricsFeature</a> implementation. The snipped below illustrated the basic initialization sequence and set of the dependencies involved.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default">final MeterRegistry registry = ...; /* Micrometer MeterRegistry instance */
final JaxwsTags jaxwsTags = new JaxwsTags();