root / man / ganeti-mond.rst @ 0500f6fd
History | View | Annotate | Download (2.4 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 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. |
56 |
|
57 |
`Status reporting collectors` will provide their output in non-verbose format. |
58 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
59 |
request. |
60 |
|
61 |
``/1/report/[category]/[collector_name]`` |
62 |
+++++++++++++++++++++++++++++++++++++++++ |
63 |
Returns the report of the collector ``[collector_name]`` that belongs to the |
64 |
specified ``[category]``. |
65 |
|
66 |
If a collector does not belong to any category, ``collector`` will be used as |
67 |
the value for ``[category]``. |
68 |
|
69 |
`Status reporting collectors` will provide their output in non-verbose format. |
70 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
71 |
request. |
72 |
|
73 |
Further information can be found in the Ganeti Monitoring Agent |
74 |
design document. |
75 |
|
76 |
.. vim: set textwidth=72 : |
77 |
.. Local Variables: |
78 |
.. mode: rst |
79 |
.. fill-column: 72 |
80 |
.. End: |