root / man / ganeti-mond.rst @ c82166a2
History | View | Annotate | Download (2.5 kB)
1 |
ganeti-mond(8) Ganeti | Version @GANETI_VERSION@ |
---|---|
2 |
================================================= |
3 |
|
4 |
Name |
5 |
---- |
6 |
|
7 |
ganeti-mond - Ganeti monitoring daemon |
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 ``-b`` option can be used to specify the address to bind to |
30 |
(defaults to ``0.0.0.0``). |
31 |
The daemon will refuse to start if the user and group do not match the |
32 |
one defined at build time; this behaviour can be overridden by the |
33 |
``--no-user-checks`` option. |
34 |
|
35 |
COMMUNICATION PROTOCOL |
36 |
~~~~~~~~~~~~~~~~~~~~~~ |
37 |
|
38 |
The queries to the monitoring agent will be HTTP GET requests on port 1815. |
39 |
The answer will be encoded in JSON format and will depend on the specific |
40 |
accessed resource. |
41 |
|
42 |
If a request is sent to a non-existing resource, a 404 error will be returned by |
43 |
the HTTP server. |
44 |
|
45 |
``/`` |
46 |
+++++ |
47 |
The root resource. It will return the list of the supported protocol version |
48 |
numbers. |
49 |
|
50 |
``/1/list/collectors`` |
51 |
++++++++++++++++++++++ |
52 |
Returns a list of tuples (kind, category, name) showing all the collectors |
53 |
available in the system. |
54 |
|
55 |
``/1/report/all`` |
56 |
+++++++++++++++++ |
57 |
A list of the reports of all the data collectors. |
58 |
|
59 |
`Status reporting collectors` will provide their output in non-verbose format. |
60 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
61 |
request. |
62 |
|
63 |
``/1/report/[category]/[collector_name]`` |
64 |
+++++++++++++++++++++++++++++++++++++++++ |
65 |
Returns the report of the collector ``[collector_name]`` that belongs to the |
66 |
specified ``[category]``. |
67 |
|
68 |
If a collector does not belong to any category, ``collector`` will be used as |
69 |
the value for ``[category]``. |
70 |
|
71 |
`Status reporting collectors` will provide their output in non-verbose format. |
72 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
73 |
request. |
74 |
|
75 |
Further information can be found in the Ganeti Monitoring Agent |
76 |
design document. |
77 |
|
78 |
.. vim: set textwidth=72 : |
79 |
.. Local Variables: |
80 |
.. mode: rst |
81 |
.. fill-column: 72 |
82 |
.. End: |