Author:   Lars Michelsen <[email protected]>
Date:     Sun Dec 16 11:14:33 2012 +0100
Committer:   Lars Michelsen <[email protected]>
Commit-Date: Sun Dec 16 11:14:33 2012 +0100

Added std_lq.php to the docs

---

 docs/en_US/map_config_format_description.html |   43 ++++++++++++++++++++++++-
 1 files changed, 42 insertions(+), 1 deletions(-)

diff --git a/docs/en_US/map_config_format_description.html 
b/docs/en_US/map_config_format_description.html
index 9f6b982..b81dafa 100644
--- a/docs/en_US/map_config_format_description.html
+++ b/docs/en_US/map_config_format_description.html
@@ -1322,7 +1322,48 @@
         </tr>
         </table>
 
-        <a name="types"><a><h2>Variable Types</h2>
+        <a name="container"></a><h4>Script: std_lq.php (<font 
color="#ff0000">New in 1.7.1</font>)</h4>
+        <p>This script is delivered with NagVis. It can be used to list data 
fetched via livestatus on
+        your maps to e.g. display lists of items or just raw numbers.</p>
+
+        <p><i>Please note:</i> By default all querys get the current username 
added with the <code>AuthUser</code>
+        livestatus filer. Resulting of this, a user can only see the hosts and 
services he is a contact of.
+        To change this behavior you can customize (copy) the std_lq.php and 
change the <code>setAuthUser</code>
+        to the following defenition:</p>
+        <pre>$setAuthUser = true;</pre>
+
+        <p>To add the script to your maps you need to add 
<code>std_lq.php</code> with additional parameters
+        to the <code>url</code> parameter in a container object. The 
parameters are given as URL parameters.
+
+        <p>You have to call this script with at least two parameters:</p>
+        <table>
+            <tr>
+                <td>backend_id</td><td>The id of the backend to use as 
configured in NagVis</td>
+            </tr><tr>
+                <td>query</td><td>The livestatus query to execute (newlines 
must be given as \\n)</td>
+            </tr>
+        </table>
+        <p>Optional parameters:</p>
+        <table>
+            <tr>
+                <td>type</td><td>Customize the way the resulting data is 
displayed</td>
+            </tr>
+        </table>
+        <p>Example calls to this script:</p>
+        
+        Query a single cell as simple string:
+        <pre>std_lq.php?backend_id=live_1&query=GET hosts\\nLimit: 
1\\nColumns: host_name\\n&type=cell</pre>
+        
+        Query several columns from a single dataset. Resulting values are 
displayed separated by ", ":
+        <pre>std_lq.php?backend_id=live_1&query=GET hosts\\nLimit: 
1\\nColumns: host_name address state\\n&type=row</pre>
+        
+        Query one column from several datasets. Each found cell is displayed 
in a separate line:
+        <pre>std_lq.php?backend_id=live_1&query=GET hosts\\nLimit: 
2\\nColumns: host_name\\n&type=column</pre>
+        
+        Query several columns from several datasets and display them as table:
+        <pre>std_lq.php?backend_id=live_1&query=GET hosts\\nLimit: 
2\\nColumns: host_name state address\\n&type=list</pre>
+
+        <a name="types"></a><h2>Variable Types</h2>
         <p>This chapter explains the different variable types used in the map 
configuration file.</p>
 
         <a name="coordinate"></a><h3>Coordinates</h3>


------------------------------------------------------------------------------
LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial
Remotely access PCs and mobile devices and provide instant support
Improve your efficiency, and focus on delivering more value-add services
Discover what IT Professionals Know. Rescue delivers
http://p.sf.net/sfu/logmein_12329d2d
_______________________________________________
Nagvis-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/nagvis-checkins

Reply via email to