summaryrefslogtreecommitdiffstats
path: root/doc/mgr/dashboard_plugins/debug.inc.rst
blob: 883419cbf57c87458c95c3e91ee0cbb00232ffcd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
.. _dashboard-debug:

Debug
^^^^^

This plugin allows to customize the behaviour of the dashboard according to the
debug mode. It can be enabled, disabled or checked with the following command:

.. prompt:: bash $

   ceph dashboard debug status

::

  Debug: 'disabled'

.. prompt:: bash $

   ceph dashboard debug enable

::

  Debug: 'enabled'

.. prompt:: bash $

   ceph dashboard debug disable

::

  Debug: 'disabled'

By default, it's disabled. This is the recommended setting for production
deployments. If required, debug mode can be enabled without need of restarting.
Currently, disabled debug mode equals to CherryPy ``production`` environment,
while when enabled, it uses ``test_suite`` defaults (please refer to
`CherryPy Environments
<https://docs.cherrypy.org/en/latest/config.html#environments>`_ for more
details).

It also adds request uuid (``unique_id``) to Cherrypy on versions that don't
support this. It additionally prints the ``unique_id`` to error responses and
log messages.