Author: buildbot
Date: Mon Feb 2 16:29:30 2015
New Revision: 938676
Log:
Staging update by buildbot for slider
Modified:
websites/staging/slider/trunk/content/ (props changed)
websites/staging/slider/trunk/content/docs/api/slider_REST_api_v2.html
Propchange: websites/staging/slider/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Feb 2 16:29:30 2015
@@ -1 +1 @@
-1655817
+1656511
Modified: websites/staging/slider/trunk/content/docs/api/slider_REST_api_v2.html
==============================================================================
--- websites/staging/slider/trunk/content/docs/api/slider_REST_api_v2.html
(original)
+++ websites/staging/slider/trunk/content/docs/api/slider_REST_api_v2.html Mon
Feb 2 16:29:30 2015
@@ -629,20 +629,20 @@ DELETE node_id will decommission all con
<td>list of components and summary data</td>
</tr>
<tr>
- <td>live/components/{name}</td>
+ <td>live/components/{component}</td>
<td>Info on a specific component, including list of containers</td>
</tr>
<tr>
- <td>live/components/{name}/instances/{index}</td>
+ <td>live/components/{component}/instances/{index}</td>
<td>Index of containers; map to contents of container ID.</td>
</tr>
<tr>
- <td>live/components/{name}/containers/</td>
- <td>List of container IDs</td>
+ <td>live/components/{component}/containers/</td>
+ <td>List of container IDs for a named component type</td>
</tr>
<tr>
- <td>live/components/{name}/containers/{container_id}
-</td>
+ <td>live/components/{component}/containers/{container_id}
+ </td>
<td>ContainerInfo</td>
</tr>
<tr>
@@ -651,15 +651,26 @@ DELETE node_id will decommission all con
</tr>
<tr>
<td>live/nodes/${nodeid}</td>
- <td>Node info on a node (e.g containers)</td>
+ <td>Node info on a node (e.g history containers)</td>
</tr>
<tr>
+ <td>live/liveness</td>
+ <td>aggregate liveness information</td>
+ </tr>
+ <tr>
+ <td>live/liveness/{component}</td>
+ <td>Liveness information for a named component type</td>
+ </tr>
+
+ <tr>
<td>live/statistics</td>
<td>General statistics</td>
</tr>
</table>
-<p>All live values will be cached and refreshed regularly; the caching ensures
that a heavy load of GET operations does not overload the application
master.</p>
+<p>All live values will be cached and refreshed regularly; the caching ensures
that a heavy load of GET operations does not overload the application master.
+It does mean that there may be a delay of under a second
+before an updated value is visible.</p>
<h1 id="actions">Actions</h1>
<p>Actions are POST operations.</p>
<table>
@@ -720,6 +731,28 @@ DELETE node_id will decommission all con
<span class="p">}</span>
</pre></div>
+
+
+<h2 id="liveliveness"><code>live/liveness</code></h2>
+<p>The liveness URL returns a JSON structure on the liveness of the
+application as perceived by Slider itself.</p>
+<p>See
<code>org.apache.slider.api.types.ApplicationLivenessInformation</code></p>
+<div class="codehilite"><pre><span class="p">{</span>
+ "<span class="n">allRequestsSatisfied</span>"<span
class="p">:</span> <span class="n">true</span><span class="p">,</span>
+ "<span class="n">requestsOutstanding</span>"<span
class="p">:</span> 0
+<span class="p">}</span>
+</pre></div>
+
+
+<p>Its initial/basic form counts the number of outstanding container
requests.</p>
+<p>This could be extended in future with more criteria, such as the minimum
number/
+percentage of desired containers of each component type have been allocated
+âor even how many were actually running.</p>
+<p>Any new liveness probes will supplement rather than replace the current
values.</p>
+<h2 id="to-be-defined-livestatisticts">To be defined:
<code>live/statisticts</code></h2>
+<p>The statistics will cover the collected statistics on a component type, as
well
+as aggregate statistics on an application instance.</p>
+<p>When an Application Master is restarted, all statistics will be lost.</p>
</div>
<div id="footer">
