root/src/modules/resmon_part.xml

Revision b0e455c7afe4f98214b30df656b76b2c28d67328, 3.4 kB (checked in by Theo Schlossnagle <jesus@omniti.com>, 6 years ago)

resmon and resmon_part docs

  • Property mode set to 100644
Line 
1 <module>
2   <name>resmon_part</name>
3   <description><para>The resmon_part module performs services checks against a specific Resmon module/service check.</para>
4   <para><ulink url="https://labs.omniti.com/trac/resmon"><citetitle>Resmon</citetitle></ulink> is a light-weight resource monitor that exposes health of services over HTTP in XML.</para>
5   <para>This module rides on the http module and provides a secondary phase of XML parsing on the contents that extracts a specific module and service from the Resmon XML report.</para>
6   </description>
7   <loader>C</loader>
8   <image>http.so</image>
9   <moduleconfig>
10     <parameter name="url"
11                required="optional"
12                allowed="http://target:81/">The default URL to be used by checks that do not specify an explicit URL.</parameter>
13     <parameter name="ca_chain"
14                required="optional"
15                allowed=".+">A path to a file containing all the certificate authorities that should be loaded to validate the remote certificate (for SSL checks).  This is used for SSL checks if this paramter is not set explicitly in the check config.</parameter>
16     <parameter name="certificate_file"
17                required="optional"
18                allowed=".+">A path to a file containing all the client certificate that will be presented to the remote server (for SSL checks).  This is used for SSL checks if this paramter is not set explicitly in the check config.</parameter>
19   </moduleconfig>
20   <checkconfig>
21     <parameter name="url"
22                required="required"
23                allowed=".+">The URL including schema and hostname (as you would type into a browser's location bar).</parameter>
24     <parameter name="ca_chain"
25                required="optional"
26                allowed=".+">A path to a file containing all the certificate authorities that should be loaded to validate the remote certificate (for SSL checks).</parameter>
27     <parameter name="certificate_file"
28                required="optional"
29                allowed=".+">A path to a file containing all the client certificate that will be presented to the remote server (for SSL checks).</parameter>
30     <parameter name="resmon_module"
31                required="required"
32                allowed=".+">The resmon module to check.</parameter>
33     <parameter name="resmon_service"
34                required="required"
35                allowed=".+">The resmon service to check.</parameter>
36   </checkconfig>
37   <examples>
38     <example>
39       <title>Checking for two specific resmon services on OmniTI Labs.</title>
40       <para>This example checks for hardware faults and the utilization of the root filesystem via the Resmon service on OmniTI Labs.</para>
41       <programlisting><![CDATA[
42       <noit>
43         <modules>
44           <module image="http" name="resmon_part" />
45         </modules>
46         <checks>
47           <labs target="8.8.38.5" module="resmon_part">
48             <check uuid="413a488c-796b-11dd-b98a-53f0f4b89ac3">
49               <config>
50                 <resmon_module>FAULTS</resmon_module>
51                 <resmon_service>hardware</resmon_service>
52               </config>
53             </check>
54             <check uuid="4c33303c-796b-11dd-bfa1-6f55841e1fca">
55               <config>
56                 <resmon_module>DISK</resmon_module>
57                 <resmon_service>/</resmon_service>
58               </config>
59             </check>
60           </labs>
61         </checks>
62       </noit>
63     ]]></programlisting>
64     </example>
65   </examples>
66 </module>
Note: See TracBrowser for help on using the browser.