<div dir="ltr"><p>Hello Everybody,</p><p></p><p>I am happy to announce release 0.15.0 of Hawkular Metrics. This is one of the largest ever Hawkular Metrics releases with a lot of new features and changes.</p><p><br></p>

<p>Here is a list of major changes:</p>

<ol><li>
<p><strong>Cassandra 3.5</strong></p>

<ul><li>Cassandra 3.5 is now the supported version of Cassandra</li><li>Cassandra 2.2.x support is deprecated</li></ul>
</li><li>
<p><strong>Schema Management Tools</strong></p>

<ul><li>First release with tooling for schema change management</li><li>Only upgrades are supported; incremental schema changes are installed when Hawkular Metrics starts</li><li>Going forward new versions of Hawkular Metrics can be installed 
without the need to start with a fresh database or manually update 
existing database even if the schema has been modified in the new 
version</li><li> For more details: <a href="https://issues.jboss.org/browse/HWKMETRICS-361">HWKMETRICS-361</a>, <a href="https://github.com/jsanda/cassalog">Cassalog</a>
</li></ul>
</li><li>
<p><strong><code>*/stats</code> &amp; <code>*/raw</code> Replace <code>*/data</code></strong></p>

<ul><li>
<code>*/data</code> has been *<em>deprecated</em> and functionality 
split into two single purpose endpoints, this is applicable for all 
metric types (gauge, counter, availability, and string)</li><li>
<code>*/stats</code> endpoints return bucketed, statistical or query-time aggregated data</li><li>
<code>*/raw</code> endpoints accept and return raw data for a metric</li><li>
<code>*/data</code> is being deprecated, will not receive any updates 
going forward, and will be removed in future releases. There is no clear
 timeline for the removal since a lot of clients use it; it will be 
around at least for another two releases. </li><li>Please update your code to use the new endpoints and follow the release notes for more details regarding removal.</li><li>For more details: <a href="https://issues.jboss.org/browse/HWKMETRICS-24">HWKMETRICS-24</a>, <a href="https://issues.jboss.org/browse/HWKMETRICS-57">HWKMETRICS-57</a>
</li></ul>
</li><li>
<p><strong>Data Point Tags</strong></p>

<ul><li>An optional set of tags can be supplied with each data point when 
inserting data. Unlike metric definition tags, data point tags cannot be
 modified. <a href="https://issues.jboss.org/browse/HWKMETRICS-368">HWKMETRICS-368</a>, <a href="https://issues.jboss.org/browse/HWKMETRICS-54">HWKMETRICS-54</a>
</li><li>Tag based bucketing for data points is supported for counters and gauges <a href="https://issues.jboss.org/browse/HWKMETRICS-377">HWKMETRICS-377</a>, <a href="https://issues.jboss.org/browse/HWKMETRICS-373">HWKMETRICS-373</a>
</li><li>New endpoints for filtering and grouping data by tags:

<ul><li>
<code>GET /hawkular/metrics/gauges/{id}/stats/tags/{tags}</code> </li><li><code>GET /hawkular/metrics/counters/{id}/stats/tags/{tags}</code></li></ul>
</li></ul>
</li><li>
<p><strong>Tags</strong></p>

<ul><li>Deleting tags only requires the tag keys and not the values, this 
simplifies the process for tag deletion. For backwards compatibility, 
the API will still accept name value pairs but will not take the value 
into account <a href="https://issues.jboss.org/browse/HWKMETRICS-385">HWKMETRICS-385</a>
</li><li>A new endpoint was added to query for the available values contained in a tag <a href="https://issues.jboss.org/browse/HWKMETRICS-197">HWKMETRICS-197</a>

<ul><li>Endpoint: <code>GET hawkular/metrics/gauge/tags/{tags}</code>
</li><li>Example: <code>GET hawkular/metrics/gauge/tags/hostname:*01*</code> returns <code>hostname: [&quot;web01prod&quot;, &quot;web01qa&quot;, &quot;backend01prod&quot;, &quot;backend01qa&quot; ]</code>
</li></ul>
</li></ul>
</li><li>
<p><strong>String Metric Type (Experimental)</strong></p>

<ul><li>Hawkular Metrics now provides a string metric type. This release 
introduces new endpoints for reading and writing string data points <a href="https://issues.jboss.org/browse/HWKMETRICS-384">HWKMETRICS-384</a>
</li><li>There is a 2 KB size limit for each data point. That limit may be configurable in future releases. </li><li>New endpoints under <code>/strings</code> are experimental, so 
changes which break backwards compatibility could be introduced in 
future releases. The experimental tag allows time for feedback to better
 determine what the API should be.</li></ul>
</li><li>
<p><strong>Asynchronous authentication for Openshift Metrics</strong></p>

<ul><li>Important performance improvement: the authentication code now uses a
 non blocking HTTP Client (Undertow Client) to validate authentication 
tokens calling Kubernetes&#39; master</li><li>Performance improvements details: <a href="https://github.com/hawkular/hawkular-metrics/pull/481#issue-148320027" class="">#481 (comment)</a>, <a href="https://github.com/hawkular/hawkular-metrics/pull/481#issuecomment-209876952" class="">#481 (comment)</a>
</li><li>For more details: <a href="https://issues.jboss.org/browse/HWKMETRICS-330">HWKMETRICS-330</a>
</li></ul>
</li><li>
<p><strong>API Updates</strong></p>

<ul><li>Stats are excluded from empty bucket data points rather than returning the string NaN and zero for the samples property <a href="https://issues.jboss.org/browse/HWKMETRICS-396">HWKMETRICS-396</a>
</li><li>Endpoints that use the order param also accept lower case values <a href="https://issues.jboss.org/browse/HWKMETRICS-389">HWKMETRICS-389</a>
</li><li>Sum is included in bucket output for gauges and counters <a href="https://issues.jboss.org/browse/HWKMETRICS-370">HWKMETRICS-370</a>
</li><li>The status page can now be loaded over HTTPS without errors <a href="https://issues.jboss.org/browse/HWKMETRICS-388">HWKMETRICS-388</a>
</li><li>Added overwrite param to tenant and metric creation. This will only 
overwrite the configuration (such as retention settings or tags) of the 
metric or tenant and not the actual data stored. Also overwrite the 
retention will only affect new data points added and not existing data 
already stored <a href="https://issues.jboss.org/browse/HWKMETRICS-148">HWKMETRICS-148</a>
</li></ul>
</li></ol><p><strong><br></strong></p><p><strong>Updated Documentation</strong></p>

<p>The entire <a href="http://www.hawkular.org/docs/components/metrics/index.html">Hawkular Metrics User Guide</a> has been rewritten and it is now accessible from the top menu of <a href="https://hawkular.org">Hawkular.org</a>.
 The new guide has extensive documentation about metric types, query and
 tagging capabilities along lots of examples. Thank you <a href="https://github.com/jsanda" class="">@jsanda</a> for this amazing update!</p>

<p><strong><br></strong></p><p><strong>Java Client (Experimental)</strong></p>

<p>Thanks to an effort started by the <a href="https://github.com/hawkular-qe">Hawkular QE</a> organization, Hawkular Metrics now has an official <a href="https://github.com/hawkular/hawkular-client-java">Java client</a>.
 The repository has been fully transferred to Hawkular community where 
will be maintained going forward. The client is now at an experimental 
alpha stage and we expect to polish the API and internals in the coming 
months. </p>

<p>A big thank you goes to <a href="https://github.com/jkandasa" class="">@jkandasa</a>  and <a href="https://github.com/vnugent" class="">@vnugent</a> for creating and the maintaining the project until now. <a href="https://github.com/jkandasa" class="">@jkandasa</a> will continue to serve as an active contributor and core member.</p>

<p><strong><br></strong></p><p><strong>Blog Posts &amp; Articles</strong></p>

<p>Here are some recently published Metrics related blog posts and articles from around the Hawkular community:</p><a href="http://www.hawkular.org/blog/2016/04/19/jmxtrans-to-hawkular-metrics.html">Monitoring JVM applications with jmxtrans</a> by <a href="https://github.com/tsegismont" class="">@tsegismont</a><br><br><a href="http://www.hawkular.org/blog/2016/04/22/collecting-metrics-from-prometheus-endpoints.html">Collecting Metrics from Prometheus Endpoints</a> by <a href="https://github.com/jmazzitelli">@jmazzitelli</a><br><br><a href="http://www.hawkular.org/blog/2016/04/21/datamining-first-release.html">Hawkular Data Mining 0.1.0.Final Released</a> by <a href="https://github.com/pavolloffay" class="">@pavolloffay</a>
<br><br><br><br><div>Github Release:</div><div><a href="https://github.com/hawkular/hawkular-metrics/releases/tag/0.15.0" target="_blank">https://github.com/hawkular/hawkular-metrics/releases/tag/0.15.0</a></div><div><br></div><div>JBoss Nexus Maven artifacts:</div><div><a href="http://origin-repository.jboss.org/nexus/content/repositories/public/org/hawkular/metrics/" target="_blank">http://origin-repository.jboss.org/nexus/content/repositories/public/org/hawkular/metrics/</a></div><div><br></div><div>Jira release tracker:</div><div><a href="https://issues.jboss.org/browse/HWKMETRICS/fixforversion/12329846" target="_blank">https://issues.jboss.org/browse/HWKMETRICS/fixforversion/12329846</a></div><div><br></div><div><br></div><div>Hawkular Metrics Clients</div><div>  * Ruby: <a href="https://github.com/hawkular/hawkular-client-ruby" target="_blank">https://github.com/hawkular/hawkular-client-ruby</a></div><div>  * Python: <a href="https://github.com/hawkular/hawkular-client-python" target="_blank">https://github.com/hawkular/hawkular-client-python</a></div><div>  * Go: <a href="https://github.com/hawkular/hawkular-client-go" target="_blank">https://github.com/hawkular/hawkular-client-go</a><br>  * Java: <a href="https://github.com/hawkular/hawkular-client-java" target="_blank">https://github.com/hawkular/hawkular-client-java</a><br></div><div><br></div><div><br></div><div>A
 big &quot;Thank you&quot; goes to John Sanda, Thomas Segismont, Matt Wringe, Mike
 Thompson, Michael Burman, and Heiko Rupp for their project 
contributions.</div><div><br></div><br><br clear="all"><div><div class="gmail_signature"><div dir="ltr">Thank you,<br>Stefan Negrea<br><br>Software Engineer<br></div></div></div>
</div>