You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sirona.apache.org by rm...@apache.org on 2015/11/03 20:28:06 UTC
svn commit: r11010 [2/9] - in /dev/incubator/sirona/0.3-incubating: ./ css/
images/ images/gui/ images/logos/ images/profiles/ img/ involved/ js/
releases/
Added: dev/incubator/sirona/0.3-incubating/concepts.html
==============================================================================
--- dev/incubator/sirona/0.3-incubating/concepts.html (added)
+++ dev/incubator/sirona/0.3-incubating/concepts.html Tue Nov 3 19:28:06 2015
@@ -0,0 +1,393 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.3.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20151103" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Apache Sirona - Repository</title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
+
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-3211522-14']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container" style="width: auto;"><div class="nav-collapse">
+
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="quick-start.html" title="Quick start">Quick start</a>
+</li>
+
+ <li> <a href="concepts.html" title="Concepts">Concepts</a>
+</li>
+
+ <li> <a href="basis.html" title="Basis">Basis</a>
+</li>
+
+ <li> <a href="configuration.html" title="Configuration">Configuration</a>
+</li>
+
+ <li> <a href="instrumentation.html" title="Instrumentation">Instrumentation</a>
+</li>
+
+ <li> <a href="reporting.html" title="Reporting">Reporting</a>
+</li>
+
+ <li> <a href="plugins.html" title="Plugins">Plugins</a>
+</li>
+
+ <li> <a href="jta.html" title="JTA">JTA</a>
+</li>
+
+ <li> <a href="jpa.html" title="JPA">JPA</a>
+</li>
+
+ <li> <a href="jdbc.html" title="JDBC">JDBC</a>
+</li>
+
+ <li> <a href="web.html" title="Web">Web</a>
+</li>
+
+ <li> <a href="graphite.html" title="Graphite">Graphite</a>
+</li>
+
+ <li> <a href="cube.html" title="Cube">Cube</a>
+</li>
+
+ <li> <a href="collector.html" title="Collector">Collector</a>
+</li>
+
+ <li> <a href="cassandra.html" title="Cassandra">Cassandra</a>
+</li>
+
+ <li> <a href="websocket.html" title="WebSocket">WebSocket</a>
+</li>
+
+ <li> <a href="alerts.html" title="Alerts">Alerts</a>
+</li>
+
+ <li> <a href="download.cgi" title="Download">Download</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Reports <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="docs/0.3-incubating" title="Last Release Docs 0.3-incubating">Last Release Docs 0.3-incubating</a>
+</li>
+
+ <li> <a href="releases/release-notes-0.3-incubating.html" title="Last Release 0.3-incubating Changelog">Last Release 0.3-incubating Changelog</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT" title="Dev Docs 0.4-incubating-SNAPSHOT">Dev Docs 0.4-incubating-SNAPSHOT</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT/jira-report.html" title="Dev Changelog 0.4-incubating-SNAPSHOT">Dev Changelog 0.4-incubating-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="irc.html" title="IRC">IRC</a>
+</li>
+
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="issue-tracking.html" title="Issues">Issues</a>
+</li>
+
+ <li> <a href="team-list.html" title="Team">Team</a>
+</li>
+
+ <li> <a href="source-repository.html" title="Sources">Sources</a>
+</li>
+
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+
+ <li> <a href="involved/building.html" title="Building Guide">Building Guide</a>
+</li>
+
+ <li> <a href="involved/releasing.html" title="Release Guide">Release Guide</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+
+
+
+
+
+ <ul class="nav pull-right"><li>
+
+ <a href="https://twitter.com/ApacheSirona" class="twitter-follow-button" data-show-count="true" data-align="right" data-size="large" data-show-screen-name="true" data-lang="en">Follow ApacheSirona</a>
+ <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+
+ </li></ul>
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="index.html" id="bannerLeft" title="Apache Sirona logo">
+ <h2>Apache Sirona</h2>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight">
+ <img src="http://incubator.apache.org/images/egg-logo.png" />
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Repository</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 03 Nov 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <!-- -
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License. --><h1>Repository</h1>
+<p>The repository is a singleton for the JVM. It is the entry point to get access to counters and gauges.</p>
+
+<div>
+<pre class="prettyprint linenums">
+public interface Repository extends Iterable<Counter> {
+ Counter getCounter(Counter.Key key);
+ void clear();
+ StopWatch start(Counter counter);
+
+ Map<Long, Double> getGaugeValues(long start, long end, Role role);
+ void stopGauge(Role role);
+}
+</pre></div>
+<h1>Counter</h1>
+<p>A counter is a statistic and concurrency holder. It aggregates the information provided computing the average, min, max, sum of logs, ….</p>
+
+<div>
+<pre class="prettyprint linenums">
+public interface Counter {
+ Key getKey();
+ void reset();
+
+ void add(double delta);
+
+ AtomicInteger currentConcurrency();
+ int getMaxConcurrency();
+
+ double getMax();
+ double getMin();
+ long getHits();
+ double getSum();
+ double getStandardDeviation();
+ double getVariance();
+ double getMean();
+ double getSecondMoment();
+}
+</pre></div>
+<h1>Gauge</h1>
+<p>A gauge is a way to get a measure. It is intended to get a history of a metric.</p>
+
+<div>
+<pre class="prettyprint linenums">
+public interface Gauge {
+ Role role();
+ double value();
+}
+</pre></div>
+<h1>StopWatch</h1>
+<p>A StopWatch is just a handler for a measure with a counter.</p>
+
+<div>
+<pre class="prettyprint linenums">
+public interface StopWatch {
+ long getElapsedTime();
+
+ StopWatch stop();
+}
+</pre></div>
+<h1>Node status</h1>
+<p>Node statuses can be reported using <tt>org.apache.sirona.status.Validation</tt>. <tt>Validation</tt> and <tt>ValidationFactory</tt> (just a list of validation) can be registered using <tt>SPI</tt> mecanism (<tt>META-INF/services/org.apache.sirona.status.Validation</tt> and <tt>META-INF/services/org.apache.sirona.status.ValidationFactory</tt> by default).</p>
+<p><tt>Validation</tt> API is the following one:</p>
+
+<div>
+<pre class="prettyprint linenums">
+public interface Validation {
+ ValidationResult validate();
+}
+</pre></div>
+<p>A <tt>ValidationResult</tt> is just a message, a validation name and a status. It is aggregated by node to compute the node status keeping the lowest of all statuses of validation results.</p>
+<h1>DataStore</h1>
+<p>Counters, Gauges and status are saved and queried (in memory by default) through a DataStore. it allows you to plug behind it any kind of persistence you would like. There are generally two kind of stores: local or remote.</p>
+<p>Here are the entry points if you want more details:</p>
+
+<ul>
+
+<li><tt>org.apache.sirona.store.counter.CounterDataStore</tt></li>
+
+<li><tt>org.apache.sirona.store.gauge.GaugeDataStore</tt></li>
+
+<li><tt>org.apache.sirona.store.status.NodeStatusDataStore</tt></li>
+
+<li><tt>org.apache.sirona.store.counter.CollectorCounterStore</tt></li>
+
+<li><tt>org.apache.sirona.store.gauge.CollectorGaugeDataStore</tt></li>
+</ul>
+<h1>AlertListener</h1>
+<p>Most of <tt>NodeStatusDataStore</tt> are able to maintain an <tt>AlertListener</tt> list. This allows to be called when a <tt>NodeStatus</tt> is <tt>DEGRADED</tt> or <tt>KO</tt> - nothing when it is <tt>OK</tt>.</p>
+<p>It will typically be used to send a mail or trigger an alert using a custom system.</p>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+ <p >Copyright © 2008–2015
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All rights reserved.
+
+ </p>
+ </div>
+
+
+<div class="row span16">
+ <div>Apache Sirona, Apache, the Apache feather logo, and the Apache Sirona project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ <a href="http://sirona.incubator.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="http://www.ohloh.net/p/sirona/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
Added: dev/incubator/sirona/0.3-incubating/configuration.html
==============================================================================
--- dev/incubator/sirona/0.3-incubating/configuration.html (added)
+++ dev/incubator/sirona/0.3-incubating/configuration.html Tue Nov 3 19:28:06 2015
@@ -0,0 +1,460 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.3.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20151103" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Apache Sirona - Configuration features</title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
+
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-3211522-14']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container" style="width: auto;"><div class="nav-collapse">
+
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="quick-start.html" title="Quick start">Quick start</a>
+</li>
+
+ <li> <a href="concepts.html" title="Concepts">Concepts</a>
+</li>
+
+ <li> <a href="basis.html" title="Basis">Basis</a>
+</li>
+
+ <li> <a href="configuration.html" title="Configuration">Configuration</a>
+</li>
+
+ <li> <a href="instrumentation.html" title="Instrumentation">Instrumentation</a>
+</li>
+
+ <li> <a href="reporting.html" title="Reporting">Reporting</a>
+</li>
+
+ <li> <a href="plugins.html" title="Plugins">Plugins</a>
+</li>
+
+ <li> <a href="jta.html" title="JTA">JTA</a>
+</li>
+
+ <li> <a href="jpa.html" title="JPA">JPA</a>
+</li>
+
+ <li> <a href="jdbc.html" title="JDBC">JDBC</a>
+</li>
+
+ <li> <a href="web.html" title="Web">Web</a>
+</li>
+
+ <li> <a href="graphite.html" title="Graphite">Graphite</a>
+</li>
+
+ <li> <a href="cube.html" title="Cube">Cube</a>
+</li>
+
+ <li> <a href="collector.html" title="Collector">Collector</a>
+</li>
+
+ <li> <a href="cassandra.html" title="Cassandra">Cassandra</a>
+</li>
+
+ <li> <a href="websocket.html" title="WebSocket">WebSocket</a>
+</li>
+
+ <li> <a href="alerts.html" title="Alerts">Alerts</a>
+</li>
+
+ <li> <a href="download.cgi" title="Download">Download</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Reports <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="docs/0.3-incubating" title="Last Release Docs 0.3-incubating">Last Release Docs 0.3-incubating</a>
+</li>
+
+ <li> <a href="releases/release-notes-0.3-incubating.html" title="Last Release 0.3-incubating Changelog">Last Release 0.3-incubating Changelog</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT" title="Dev Docs 0.4-incubating-SNAPSHOT">Dev Docs 0.4-incubating-SNAPSHOT</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT/jira-report.html" title="Dev Changelog 0.4-incubating-SNAPSHOT">Dev Changelog 0.4-incubating-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="irc.html" title="IRC">IRC</a>
+</li>
+
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="issue-tracking.html" title="Issues">Issues</a>
+</li>
+
+ <li> <a href="team-list.html" title="Team">Team</a>
+</li>
+
+ <li> <a href="source-repository.html" title="Sources">Sources</a>
+</li>
+
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+
+ <li> <a href="involved/building.html" title="Building Guide">Building Guide</a>
+</li>
+
+ <li> <a href="involved/releasing.html" title="Release Guide">Release Guide</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+
+
+
+
+
+ <ul class="nav pull-right"><li>
+
+ <a href="https://twitter.com/ApacheSirona" class="twitter-follow-button" data-show-count="true" data-align="right" data-size="large" data-show-screen-name="true" data-lang="en">Follow ApacheSirona</a>
+ <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+
+ </li></ul>
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="index.html" id="bannerLeft" title="Apache Sirona logo">
+ <h2>Apache Sirona</h2>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight">
+ <img src="http://incubator.apache.org/images/egg-logo.png" />
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Configuration features</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 03 Nov 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <!-- -
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License. --><div class="section">
+<h2>Configuration features<a name="Configuration_features"></a></h2>
+<div class="section">
+<h3>Location<a name="Location"></a></h3>
+<p>Configuration relies on <tt>sirona.properties</tt> file which should be found in the sirona-core classloader.</p>
+<p>Note: you can change the file name using <tt>org.apache.sirona.configuration</tt> system property.</p></div>
+<div class="section">
+<h3>Advanced configuration<a name="Advanced_configuration"></a></h3>
+<p>Configuration relies in fact on a SPI: <tt>org.apache.sirona.configuration.ConfigurationProvider</tt>.</p>
+<p>This interface providers two method:</p>
+
+<ul>
+
+<li><tt>ordinal</tt>: use to sort providers. The lowest is the first.</li>
+
+<li><tt>configuration</tt>: returns the properties to add in the global configuration</li>
+</ul>
+<p>Note: by default a provider for <tt>sirona.properties</tt> (ordinal = 50) and one for system properties (ordinal = 100) are added.</p></div>
+<div class="section">
+<h3>Utilities<a name="Utilities"></a></h3>
+<p><tt>org.apache.sirona.configuration.Configuration</tt> has several utility methods to get int, boolean… from the properties file. You can reuse it in your sirona extensions if you want.</p>
+<p>It will be commonly used with <tt>org.apache.sirona.configuration.ioc.IoCs</tt> class. This last allows a basic lifecycle handling of your objects. Using <tt>org.apache.sirona.configuration.ioc.IoCs.newInstance</tt> method you can decorate your class methods with <tt>org.apache.sirona.configuration.Configuration.Created</tt> and <tt>org.apache.sirona.configuration.ioc.Destroying</tt> to get lifecycle hooks.</p>
+<p><tt>Destroying</tt> is called when the monitoring is stopped. Generally since sirona-core is deployed in the container or JVM classloader it is with the JVM but sometimes you can deploy it in your application. In this case you’ll need to either configure the <tt>javax.servlet.ServletContextListener</tt> <tt>org.apache.sirona.web.lifecycle.SironaLifecycle</tt> from reporting module or to call manually <tt>Configuration.shutdown()</tt> method.</p>
+<p>You can also use <tt>org.apache.sirona.configuration.ioc.AutoSet</tt> to init field of an instance using sirona configuration.</p></div>
+<div class="section">
+<h3>Main configuration keys (by module)<a name="Main_configuration_keys_by_module"></a></h3>
+<div class="section">
+<h4>Core<a name="Core"></a></h4>
+
+<ul>
+
+<li>org.apache.sirona.configuration: the configuration file path if not using the default</li>
+
+<li>org.apache.sirona.shutdown.hook: boolean, true by default. Should be set to false when deploying sirona-core in an application (see Utilities part).</li>
+
+<li>org.apache.sirona.gauge.max-size: int, 100 by default. Number of gauge measures to keep in memory when not persistent.</li>
+
+<li>org.apache.sirona.gauge.memory.period: int, 4000 (ms) by default. Period for memory gauge.</li>
+
+<li>org.apache.sirona.gauge.cpu.period: int, 4000 (ms) by default. Period for CPU gauge.</li>
+
+<li>org.apache.sirona.store.DataStoreFactory: qualified class name, default <tt>org.apache.sirona.store.DefaultDataStoreFactory</tt>. DataStoreFactory to use.</li>
+
+<li>org.apache.sirona.repositories.Repository: qualified class name, default <tt>org.apache.sirona.repositories.DefaultRepository</tt>. Repository to use.</li>
+
+<li>org.apache.sirona.core.gauge.activated: a boolean to deactivate cpu/memory gauges</li>
+
+<li>org.apache.sirona.<name>.period: the period to use to flush counters for a batch data store (like graphite one)</li>
+
+<li>org.apache.sirona.periodic.status.period: the period to use for status reporting. Note: when using another reporter (cube typically) you’ll need to replace <tt>periodic</tt> by the specific name of the reporter (<tt>cube</tt>). Note too that <tt>period</tt> is optional to allow to share the same period between all stores.</li>
+
+<li>org.apache.sirona.<name>.gauge.period: the default period defining when gauge snapshots are taken (default name = <tt>inmemory</tt>)</li>
+
+<li>org.apache.sirona.<name>.aggregated.gauge.period: the default period defining when gauge snapshots are persisted/pushed (ex: graphite)</li>
+
+<li>org.apache.sirona.counter.with-gauge: a boolean to ask to register for each counter a gauge for the max/sum/hists metrics of the counter. Only works with in memory counter stores (agent ones in general).</li>
+
+<li>org.apache.sirona.counter.with-jmx: a boolean to ask to register a MBean for each counter. Only works with in memory counter stores.</li>
+
+<li>org.apache.sirona.<name>.counter.clearOnCollect: boolean to clear counter after each push/pull</li>
+</ul></div>
+<div class="section">
+<h4>Reporting<a name="Reporting"></a></h4>
+
+<ul>
+
+<li>org.apache.commons.proxy.ProxyFactory: qualified class name. ProxyFactory to use for client aop.</li>
+
+<li>[plugin name].activated: boolean, true by default. Should the plugin referenced by [plugin.name] be used.</li>
+
+<li>org.apache.sirona.jmx.method.allowed: boolean, true by default. Are JMX method invocation allowed.</li>
+
+<li>org.apache.sirona.gauge.csv.separator: char, ‘;’ by default. CSV separator for CSV report.</li>
+
+<li>org.apache.sirona.gauge.jta.period: jta gauge period</li>
+
+<li>org.apache.sirona.gauge.memory.period: memory gauge period</li>
+
+<li>org.apache.sirona.gauge.cpu.period: cpu gauge period</li>
+
+<li>org.apache.sirona.reporting.activated: if auto deployment of reporting module is activated</li>
+
+<li>org.apache.sirona.reporting.mapping: the mapping of monitoring GUI</li>
+</ul></div>
+<div class="section">
+<h4>Web<a name="Web"></a></h4>
+
+<ul>
+
+<li>org.apache.sirona.web.activated: if auto deployment of web module is activated</li>
+
+<li>org.apache.sirona.web.monitored-urls: the mapping of monitored urls</li>
+
+<li>org.apache.sirona.web.gauge.sessions.period: the gauge period for sessions number monitoring</li>
+
+<li>org.apache.sirona.web.gauge.status.period: when status monitoring is activated the period for status gauges</li>
+
+<li>org.apache.sirona.web.monitored-statuses: the comma separated list of monitored statuses (if not a default list is used)</li>
+</ul></div>
+<div class="section">
+<h4>CDI<a name="CDI"></a></h4>
+
+<ul>
+
+<li>org.apache.sirona.cdi.enabled: a boolean to activate/deactivate CDI interceptors config</li>
+
+<li>org.apache.sirona.cdi.performance: list of intercepted beans for performances (prefix:org.superbiz, regex:.*Service…)</li>
+
+<li>org.apache.sirona.cdi.jta: list of intercepted beans for JTA</li>
+</ul>
+<h1>TomEE</h1>
+
+<ul>
+
+<li>org.apache.sirona.tomee.gauges.activated: a boolean to deactivate tomee guages (stateless pool stat)</li>
+
+<li>org.apache.sirona.tomee.validations.activated: a boolean to deactivate tomee validations (datasource validation by validation query)</li>
+</ul>
+<h1>Pull</h1>
+
+<ul>
+
+<li>org.apache.sirona.agent.pull.mapping: the servlet mapping, default to <tt>/sirona/pull</tt></li>
+</ul>
+<h1>Collector</h1>
+
+<ul>
+
+<li><tt>org.apache.sirona.collector.collection.period</tt>: the timer period (in ms) when used in pull mode</li>
+
+<li><tt>org.apache.sirona.collector.collection.agent-urls</tt>: comma separated value of agent urls when auto registering is not used by agents</li>
+
+<li><tt>org.apache.sirona.collector.server.api.SecurityProvider</tt>: the basic information provider requests on agents</li>
+
+<li><tt>org.apache.sirona.collector.server.api.SSLSocketFactoryProvider</tt>: the ssl socket factory provider when contacting agents over ssl</li>
+</ul>
+<h1>cassandra</h1>
+
+<ul>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.hosts</tt>: comma separated list of hosts (IP:port)</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.cluster</tt>: sirona cluster name</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.keyspace</tt>: sirona keyspace name</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.counterColumnFamily</tt>: sirona counter column family name</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.gaugeValuesColumnFamily</tt>: sirona gauge column family name to store data</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.statusColumnFamily</tt>: sirona statuses column family name</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.markerGaugesColumFamily</tt>: sirona gauge by marker (= instance) column family name</li>
+
+<li><tt>org.apache.sirona.cassandra.CassandraBuilder.replicationFactor</tt>: replication factory for cassandra client instance</li>
+</ul></div></div></div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+ <p >Copyright © 2008–2015
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All rights reserved.
+
+ </p>
+ </div>
+
+
+<div class="row span16">
+ <div>Apache Sirona, Apache, the Apache feather logo, and the Apache Sirona project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ <a href="http://sirona.incubator.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="http://www.ohloh.net/p/sirona/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
Added: dev/incubator/sirona/0.3-incubating/css/apache-maven-fluido-1.3.1.min.css
==============================================================================
--- dev/incubator/sirona/0.3-incubating/css/apache-maven-fluido-1.3.1.min.css (added)
+++ dev/incubator/sirona/0.3-incubating/css/apache-maven-fluido-1.3.1.min.css Tue Nov 3 19:28:06 2015
@@ -0,0 +1,9 @@
+/*!
+ * Bootstrap v2.2.2
+ *
+ * Copyright 2012 Twitter, Inc
+ * Licensed under the Apache License v2.0
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Designed and built with all the love in the world @twitter by @mdo and @fat.
[... 3 lines stripped ...]
Added: dev/incubator/sirona/0.3-incubating/css/print.css
==============================================================================
--- dev/incubator/sirona/0.3-incubating/css/print.css (added)
+++ dev/incubator/sirona/0.3-incubating/css/print.css Tue Nov 3 19:28:06 2015
@@ -0,0 +1,23 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/* $Id: print.css 1201871 2011-11-14 20:18:24Z simonetripodi $ */
+
+#banner, #footer, #leftcol, #breadcrumbs, .docs #toc, .docs .courtesylinks, #leftColumn, #navColumn {display: none !important;}
+#bodyColumn, body.docs div.docs {margin: 0 !important;border: none !important}
Added: dev/incubator/sirona/0.3-incubating/css/site.css
==============================================================================
--- dev/incubator/sirona/0.3-incubating/css/site.css (added)
+++ dev/incubator/sirona/0.3-incubating/css/site.css Tue Nov 3 19:28:06 2015
@@ -0,0 +1 @@
+/* You can override this file with your own styles */
\ No newline at end of file
Added: dev/incubator/sirona/0.3-incubating/cube.html
==============================================================================
--- dev/incubator/sirona/0.3-incubating/cube.html (added)
+++ dev/incubator/sirona/0.3-incubating/cube.html Tue Nov 3 19:28:06 2015
@@ -0,0 +1,335 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.3.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20151103" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Apache Sirona - Cube</title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
+
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-3211522-14']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container" style="width: auto;"><div class="nav-collapse">
+
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="quick-start.html" title="Quick start">Quick start</a>
+</li>
+
+ <li> <a href="concepts.html" title="Concepts">Concepts</a>
+</li>
+
+ <li> <a href="basis.html" title="Basis">Basis</a>
+</li>
+
+ <li> <a href="configuration.html" title="Configuration">Configuration</a>
+</li>
+
+ <li> <a href="instrumentation.html" title="Instrumentation">Instrumentation</a>
+</li>
+
+ <li> <a href="reporting.html" title="Reporting">Reporting</a>
+</li>
+
+ <li> <a href="plugins.html" title="Plugins">Plugins</a>
+</li>
+
+ <li> <a href="jta.html" title="JTA">JTA</a>
+</li>
+
+ <li> <a href="jpa.html" title="JPA">JPA</a>
+</li>
+
+ <li> <a href="jdbc.html" title="JDBC">JDBC</a>
+</li>
+
+ <li> <a href="web.html" title="Web">Web</a>
+</li>
+
+ <li> <a href="graphite.html" title="Graphite">Graphite</a>
+</li>
+
+ <li> <a href="cube.html" title="Cube">Cube</a>
+</li>
+
+ <li> <a href="collector.html" title="Collector">Collector</a>
+</li>
+
+ <li> <a href="cassandra.html" title="Cassandra">Cassandra</a>
+</li>
+
+ <li> <a href="websocket.html" title="WebSocket">WebSocket</a>
+</li>
+
+ <li> <a href="alerts.html" title="Alerts">Alerts</a>
+</li>
+
+ <li> <a href="download.cgi" title="Download">Download</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Reports <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="docs/0.3-incubating" title="Last Release Docs 0.3-incubating">Last Release Docs 0.3-incubating</a>
+</li>
+
+ <li> <a href="releases/release-notes-0.3-incubating.html" title="Last Release 0.3-incubating Changelog">Last Release 0.3-incubating Changelog</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT" title="Dev Docs 0.4-incubating-SNAPSHOT">Dev Docs 0.4-incubating-SNAPSHOT</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT/jira-report.html" title="Dev Changelog 0.4-incubating-SNAPSHOT">Dev Changelog 0.4-incubating-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="irc.html" title="IRC">IRC</a>
+</li>
+
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="issue-tracking.html" title="Issues">Issues</a>
+</li>
+
+ <li> <a href="team-list.html" title="Team">Team</a>
+</li>
+
+ <li> <a href="source-repository.html" title="Sources">Sources</a>
+</li>
+
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+
+ <li> <a href="involved/building.html" title="Building Guide">Building Guide</a>
+</li>
+
+ <li> <a href="involved/releasing.html" title="Release Guide">Release Guide</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+
+
+
+
+
+ <ul class="nav pull-right"><li>
+
+ <a href="https://twitter.com/ApacheSirona" class="twitter-follow-button" data-show-count="true" data-align="right" data-size="large" data-show-screen-name="true" data-lang="en">Follow ApacheSirona</a>
+ <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+
+ </li></ul>
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="index.html" id="bannerLeft" title="Apache Sirona logo">
+ <h2>Apache Sirona</h2>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight">
+ <img src="http://incubator.apache.org/images/egg-logo.png" />
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Cube</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 03 Nov 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <!-- -
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License. --><h1>Cube</h1>
+<p>Cube module allows to push counters and gauges to a Square Cube instance (see <a class="externalLink" href="https://github.com/square/cube/wiki">Cube github wiki</a>).</p>
+<div class="section">
+<h2>Configuration<a name="Configuration"></a></h2>
+<p>org.apache.sirona.store.DataStore = org.apache.sirona.cube.CubeDataStore org.apache.sirona.cube.period = 100 org.apache.sirona.cube.CubeBuilder.collector = <a class="externalLink" href="http://localhost:1234/collector/1.0/event/put">http://localhost:1234/collector/1.0/event/put</a> * <tt>org.apache.sirona.cube.CubeBuilder.collector</tt>: the cube event collector address (<tt>http://xxx:1234/collector/1.0/event/put</tt> for instance) * <tt>org.apache.sirona.cube.CubeBuilder.proxyHost</tt>: optionally a proxy host * <tt>org.apache.sirona.cube.CubeBuilder.proxyPort</tt>: optionally a proxy port</p>
+<p>For instance your <tt>sirona.properties</tt> can look like:</p>
+
+<div>
+<pre class="prettyprint linenums">
+org.apache.sirona.cube.CubeBuilder.collector = http://localhost:1234/collector/1.0/event/put
+</pre></div></div>
+<div class="section">
+<h2>DataStore<a name="DataStore"></a></h2>
+<p>To push metrics (Gauges + Counters) to Cube you can use the dedicated <tt>DataStore</tt>: <tt>org.apache.sirona.cube.CubeDataStore</tt>.</p>
+<p>Simply add to <tt>sirona.properties</tt> the line:</p>
+
+<div>
+<pre class="prettyprint linenums">
+org.apache.sirona.store.DataStore = org.apache.sirona.cube.CubeDataStore
+</pre></div>
+<div class="section">
+<h3>Counters<a name="Counters"></a></h3>
+<p>You can also configure the period used to flush counters values:</p>
+
+<ul>
+
+<li><tt>org.apache.sirona.cube.period</tt>: which period to use to push counters data to Cube (default to 1mn).</li>
+</ul></div></div>
+<div class="section">
+<h2>Limitations (ATM)<a name="Limitations_ATM"></a></h2>
+<p>When using CubeDataStore you cannot retrieve locally gauges values (you are expected to use Cube for it).</p></div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+ <p >Copyright © 2008–2015
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All rights reserved.
+
+ </p>
+ </div>
+
+
+<div class="row span16">
+ <div>Apache Sirona, Apache, the Apache feather logo, and the Apache Sirona project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ <a href="http://sirona.incubator.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="http://www.ohloh.net/p/sirona/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
Added: dev/incubator/sirona/0.3-incubating/deployments.html
==============================================================================
--- dev/incubator/sirona/0.3-incubating/deployments.html (added)
+++ dev/incubator/sirona/0.3-incubating/deployments.html Tue Nov 3 19:28:06 2015
@@ -0,0 +1,388 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia
+ | Rendered using Apache Maven Fluido Skin 1.3.1
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20151103" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Apache Sirona - Solutions</title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="./js/apache-maven-fluido-1.3.1.min.js"></script>
+
+
+ <!-- Google Analytics -->
+ <script type="text/javascript">
+
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-3211522-14']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+
+ </script>
+ </head>
+ <body class="topBarEnabled">
+
+
+
+
+
+ <div id="topbar" class="navbar navbar-fixed-top ">
+ <div class="navbar-inner">
+ <div class="container" style="width: auto;"><div class="nav-collapse">
+
+
+
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">User Guide <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="quick-start.html" title="Quick start">Quick start</a>
+</li>
+
+ <li> <a href="concepts.html" title="Concepts">Concepts</a>
+</li>
+
+ <li> <a href="basis.html" title="Basis">Basis</a>
+</li>
+
+ <li> <a href="configuration.html" title="Configuration">Configuration</a>
+</li>
+
+ <li> <a href="instrumentation.html" title="Instrumentation">Instrumentation</a>
+</li>
+
+ <li> <a href="reporting.html" title="Reporting">Reporting</a>
+</li>
+
+ <li> <a href="plugins.html" title="Plugins">Plugins</a>
+</li>
+
+ <li> <a href="jta.html" title="JTA">JTA</a>
+</li>
+
+ <li> <a href="jpa.html" title="JPA">JPA</a>
+</li>
+
+ <li> <a href="jdbc.html" title="JDBC">JDBC</a>
+</li>
+
+ <li> <a href="web.html" title="Web">Web</a>
+</li>
+
+ <li> <a href="graphite.html" title="Graphite">Graphite</a>
+</li>
+
+ <li> <a href="cube.html" title="Cube">Cube</a>
+</li>
+
+ <li> <a href="collector.html" title="Collector">Collector</a>
+</li>
+
+ <li> <a href="cassandra.html" title="Cassandra">Cassandra</a>
+</li>
+
+ <li> <a href="websocket.html" title="WebSocket">WebSocket</a>
+</li>
+
+ <li> <a href="alerts.html" title="Alerts">Alerts</a>
+</li>
+
+ <li> <a href="download.cgi" title="Download">Download</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Reports <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="docs/0.3-incubating" title="Last Release Docs 0.3-incubating">Last Release Docs 0.3-incubating</a>
+</li>
+
+ <li> <a href="releases/release-notes-0.3-incubating.html" title="Last Release 0.3-incubating Changelog">Last Release 0.3-incubating Changelog</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT" title="Dev Docs 0.4-incubating-SNAPSHOT">Dev Docs 0.4-incubating-SNAPSHOT</a>
+</li>
+
+ <li> <a href="docs/0.4-incubating-SNAPSHOT/jira-report.html" title="Dev Changelog 0.4-incubating-SNAPSHOT">Dev Changelog 0.4-incubating-SNAPSHOT</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="irc.html" title="IRC">IRC</a>
+</li>
+
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+
+ <li> <a href="issue-tracking.html" title="Issues">Issues</a>
+</li>
+
+ <li> <a href="team-list.html" title="Team">Team</a>
+</li>
+
+ <li> <a href="source-repository.html" title="Sources">Sources</a>
+</li>
+
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+
+ <li> <a href="involved/building.html" title="Building Guide">Building Guide</a>
+</li>
+
+ <li> <a href="involved/releasing.html" title="Release Guide">Release Guide</a>
+</li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li class="dropdown-submenu">
+ <a href="project-info.html" title="Project Information">Project Information</a>
+ <ul class="dropdown-menu">
+ <li> <a href="integration.html" title="Continuous Integration">Continuous Integration</a>
+</li>
+ <li> <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+</li>
+ <li> <a href="issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+</li>
+ <li> <a href="license.html" title="Project License">Project License</a>
+</li>
+ <li> <a href="team-list.html" title="Project Team">Project Team</a>
+</li>
+ <li> <a href="source-repository.html" title="Source Repository">Source Repository</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+
+ <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsoring Apache">Sponsoring Apache</a>
+</li>
+
+ <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+
+
+
+
+
+ <ul class="nav pull-right"><li>
+
+ <a href="https://twitter.com/ApacheSirona" class="twitter-follow-button" data-show-count="true" data-align="right" data-size="large" data-show-screen-name="true" data-lang="en">Follow ApacheSirona</a>
+ <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+
+ </li></ul>
+
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div id="banner">
+ <div class="pull-left">
+ <a href="index.html" id="bannerLeft" title="Apache Sirona logo">
+ <h2>Apache Sirona</h2>
+ </a>
+ </div>
+ <div class="pull-right"> <a href="http://incubator.apache.org/" id="bannerRight">
+ <img src="http://incubator.apache.org/images/egg-logo.png" />
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ <span class="divider">/</span>
+ </li>
+ <li class="active ">Solutions</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 03 Nov 2015</li>
+
+ </ul>
+ </div>
+
+
+
+ <div id="bodyColumn" >
+
+ <!-- -
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License. --><h1>Solutions</h1>
+<p>Apache Sirona supports several deployments. Basically you can:</p>
+
+<ul>
+
+<li>deploy everything locally (agent, reporting)</li>
+
+<li>deploy agent in “client” JVMs and a remote collector (“server”)</li>
+
+<li>(not yet available - needs a custom persistent store) deploy client JVMs and twi servers: one for the collection and one for the reporting (GUI)</li>
+
+<li>in agent/collector mode you can either use agent push mecanism or collector pulling</li>
+</ul>
+<div class="section">
+<h2>Everything locally<a name="Everything_locally"></a></h2>
+<p>TBD</p>
+
+<div>
+<pre class="prettyprint linenums">
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-core</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-jdbc</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-jpa</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-cdi</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-jta</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-web</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-cube</artifactId>
+ <version>${sirona.version}</version>
+</dependency>
+<dependency>
+ <groupId>org.apache.sirona</groupId>
+ <artifactId>sirona-reporting</artifactId>
+ <version>${sirona.version}</version>
+ <classifier>classes</classifier>
+</dependency>
+...
+</pre></div></div>
+<div class="section">
+<h2>Agent/Collector<a name="AgentCollector"></a></h2>
+<p>This part doesn’t deal with collector/reporting part, see cassandra doc page for more details on how to split reporting webapp and collector webapp using cassandra persistence if you need it.</p>
+<div class="section">
+<h3>Push mode<a name="Push_mode"></a></h3>
+<p>Simply use on agent/client side the cube datastore factory: <tt>org.apache.sirona.cube.CubeDataStoreFactory</tt>.</p></div>
+<div class="section">
+<h3>Pull mode<a name="Pull_mode"></a></h3>
+<p>First add the pull module and configure the pull datastore factory: <tt>org.apache.sirona.agent.webapp.pull.store.PullDataStoreFactory</tt>.</p>
+<p>Note: this mode needs the servlet <tt>org.apache.sirona.agent.webapp.pull.servlet.PullServlet</tt> to be deployed. On servlet 3.x servers it should be done automatically on <tt>/sirona/pull</tt>.</p>
+<div class="section">
+<h4>Registration of agents on collectors<a name="Registration_of_agents_on_collectors"></a></h4>
+<div class="section">
+<h5>Automatic registration<a name="Automatic_registration"></a></h5>
+<p>In this mode the agent does a request on the collector to register itself. This needs the servlet to be deployed manually (through web.xml) with the init parameter <tt>org.apache.sirona.pull.url</tt> initialized to the collector url. It internally relies on <tt>org.apache.sirona.cube.CubeBuilder</tt> config (see cube config).</p></div>
+<div class="section">
+<h5>Collector agent aware<a name="Collector_agent_aware"></a></h5>
+<p>You can force the collector to know the agents statically setting either on the collector init parameter (if registered manually) or collector sirona configuration (properties) the following property:</p>
+
+<div class="source">
+<pre>org.apache.sirona.collector.collection.agent-urls = http://agent1,http://agent2....
+</pre></div></div></div></div></div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container">
+ <div class="row">
+ <p >Copyright © 2008–2015
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All rights reserved.
+
+ </p>
+ </div>
+
+
+<div class="row span16">
+ <div>Apache Sirona, Apache, the Apache feather logo, and the Apache Sirona project logos are trademarks of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
+ <a href="http://sirona.incubator.apache.org/privacy-policy.html">Privacy Policy</a>
+</div>
+
+ <p id="poweredBy" class="pull-right">
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+ </p>
+
+
+
+
+
+ <div id="ohloh" class="pull-right">
+ <script type="text/javascript" src="http://www.ohloh.net/p/sirona/widgets/project_basic_stats.js"></script>
+ </div>
+ </div>
+ </footer>
+ </body>
+</html>
Added: dev/incubator/sirona/0.3-incubating/download.cgi
==============================================================================
--- dev/incubator/sirona/0.3-incubating/download.cgi (added)
+++ dev/incubator/sirona/0.3-incubating/download.cgi Tue Nov 3 19:28:06 2015
@@ -0,0 +1,4 @@
+#!/bin/sh
+# Just call the standard mirrors.cgi script. It will use download.html
+# as the input template.
+exec /www/www.apache.org/dyn/mirrors/mirrors.cgi $*
\ No newline at end of file