Revision 431ff2c1 doc/design-monitoring-agent.rst
b/doc/design-monitoring-agent.rst | ||
---|---|---|
556 | 556 |
Format of the query |
557 | 557 |
------------------- |
558 | 558 |
|
559 |
The queries to the monitoring agent will be HTTP GET requests on port 1815. |
|
560 |
The answer will be encoded in JSON format and will depend on the specific |
|
561 |
accessed resource. |
|
562 |
|
|
563 |
If a request is sent to a non-existing resource, a 404 error will be returned by |
|
564 |
the HTTP server. |
|
565 |
|
|
566 |
The following paragraphs will present the existing resources supported by the |
|
567 |
current protocol version, that is version 1. |
|
568 |
|
|
569 |
``/`` |
|
570 |
+++++ |
|
571 |
The root resource. It will return the list of the supported protocol version |
|
572 |
numbers. |
|
573 |
|
|
574 |
Currently, this will include only version 1. |
|
575 |
|
|
576 |
``/1`` |
|
577 |
++++++ |
|
578 |
Not an actual resource per-se, it is the root of all the resources of protocol |
|
579 |
version 1. |
|
580 |
|
|
581 |
If requested through GET, the null JSON value will be returned. |
|
582 |
|
|
583 |
``/1/list/collectors`` |
|
584 |
++++++++++++++++++++++ |
|
585 |
Returns a list of tuples (kind, category, name) showing all the collectors |
|
586 |
available in the system. |
|
587 |
|
|
588 |
``/1/report/all`` |
|
589 |
+++++++++++++++++ |
|
590 |
A list of the reports of all the data collectors, as described in the section |
|
591 |
`Format of the report`_. |
|
592 |
|
|
593 |
`Status reporting collectors`_ will provide their output in non-verbose format. |
|
594 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
|
595 |
request. |
|
596 |
|
|
597 |
``/1/report/[category]/[collector_name]`` |
|
598 |
+++++++++++++++++++++++++++++++++++++++++ |
|
599 |
Returns the report of the collector ``[collector_name]`` that belongs to the |
|
600 |
specified ``[category]``. |
|
601 |
|
|
602 |
The ``category`` has to be written in lowercase. |
|
603 |
|
|
604 |
If a collector does not belong to any category, ``default`` will have to be |
|
605 |
used as the value for ``[category]``. |
|
606 |
|
|
607 |
`Status reporting collectors`_ will provide their output in non-verbose format. |
|
608 |
The verbose format can be requested by adding the parameter ``verbose=1`` to the |
|
609 |
request. |
|
559 |
.. include:: monitoring-query-format.rst |
|
610 | 560 |
|
611 | 561 |
Instance disk status propagation |
612 | 562 |
-------------------------------- |
Also available in: Unified diff