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