Revision 2fa8f963 man/ganeti-mond.rst
b/man/ganeti-mond.rst | ||
---|---|---|
6 | 6 |
|
7 | 7 |
ganeti-mond - Ganeti monitoring daemon |
8 | 8 |
|
9 |
Synopsis |
|
10 |
-------- |
|
11 |
|
|
12 |
**ganeti-mond** [-d] [-f] [--no-user-checks] [-p PORT] |
|
13 |
|
|
14 |
DESCRIPTION |
|
15 |
----------- |
|
16 |
|
|
17 |
**ganeti-mond** is the daemon providing the Ganeti monitoring |
|
18 |
functionality. It is responsible for running the data collectors and to |
|
19 |
provide the collected information through a HTTP interface. |
|
20 |
|
|
21 |
For testing purposes, you can give the ``-f`` option and the |
|
22 |
program won't detach from the running terminal. |
|
23 |
|
|
24 |
Debug-level message can be activated by giving the ``-d`` option. |
|
25 |
|
|
26 |
The **ganeti-mond** daemon listens to port 1815 TCP, on all interfaces, |
|
27 |
by default. The port can be overridden by an entry the services database |
|
28 |
by passing the ``-p`` option. |
|
29 |
The daemon will refuse to start if the user and group do not match the |
|
30 |
one defined at build time; this behaviour can be overridden by the |
|
31 |
``--no-user-checks`` option. |
|
32 |
|
|
33 |
COMMUNICATION PROTOCOL |
|
34 |
~~~~~~~~~~~~~~~~~~~~~~ |
|
35 |
|
|
36 |
The queries to the monitoring agent will be HTTP GET requests on port 1815. |
|
37 |
The answer will be encoded in JSON format and will depend on the specific |
|
38 |
accessed resource. |
|
39 |
|
|
40 |
If a request is sent to a non-existing resource, a 404 error will be returned by |
|
41 |
the HTTP server. |
|
42 |
|
|
43 |
``/`` |
|
44 |
+++++ |
|
45 |
The root resource. It will return the list of the supported protocol version |
|
46 |
numbers. |
|
47 |
|
|
48 |
``/1/list/collectors`` |
|
49 |
++++++++++++++++++++++ |
|
50 |
Returns a list of tuples (kind, category, name) showing all the collectors |
|
51 |
available in the system. |
|
52 |
|
|
53 |
``/1/report/all`` |
|
54 |
+++++++++++++++++ |
|
55 |
A list of the reports of all the data collectors, as described in the section |
|
56 |
`Format of the report`_. |
|
57 |
|
|
58 |
`Status reporting collectors`_ will provide their output in non-verbose format. |
|
59 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
|
60 |
request. |
|
61 |
|
|
62 |
``/1/report/[category]/[collector_name]`` |
|
63 |
+++++++++++++++++++++++++++++++++++++++++ |
|
64 |
Returns the report of the collector ``[collector_name]`` that belongs to the |
|
65 |
specified ``[category]``. |
|
66 |
|
|
67 |
If a collector does not belong to any category, ``collector`` will be used as |
|
68 |
the value for ``[category]``. |
|
69 |
|
|
70 |
`Status reporting collectors`_ will provide their output in non-verbose format. |
|
71 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
|
72 |
request. |
|
73 |
|
|
74 |
Further information can be found in the Ganeti Monitoring Agent |
|
75 |
design document. |
|
76 |
|
|
9 | 77 |
.. vim: set textwidth=72 : |
10 | 78 |
.. Local Variables: |
11 | 79 |
.. mode: rst |
Also available in: Unified diff