.. _restful:

Restful
=======

You can export statistics to a ``Restful`` JSON server. All the available stats
will be exported in one big (~15 KB) POST request to the Restful endpoint.

The Restful endpoint should be defined in the Glances configuration file as
following:

.. code-block:: ini

    [restful]
    # Configuration for the --export-restful option
    # Example, export to http://localhost:6789/
    host=localhost
    port=6789
    protocol=http
    path=/

URL Syntax:

.. code-block:: ini

    http://localhost:6789/
    |      |         |   |
    |      |         |   path
    |      |         port
    |      host
    protocol

and run Glances with:

.. code-block:: console

    $ glances --export-restful

Glances will generate stats as a big JSON dictionary (see example `here`_).


.. _here: https://pastebin.com/7U3vXqvF