Statistics
| Branch: | Tag: | Revision:

root / man / ganeti-mond.rst @ 2fa8f963

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, 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

    
77
.. vim: set textwidth=72 :
78
.. Local Variables:
79
.. mode: rst
80
.. fill-column: 72
81
.. End: