ceph/doc/mgr/dashboard.rst

   1 dashboard plugin
   2 ================
   3
   4 Dashboard plugin visualizes the statistics of the cluster using a web server
   5 hosted by ``ceph-mgr``.
   6
   7 Enabling
   8 --------
   9
  10 The *dashboard* module is enabled with::
  11
  12   ceph mgr module enable dashboard
  13
  14 Configuration
  15 -------------
  16
  17 Like most web applications, dashboard binds to a host name and port.
  18 By default, the ``ceph-mgr`` daemon hosting the dashboard (i.e., the
  19 currently active manager) will bind to port 7000 and any available
  20 IPv4 or IPv6 address on the host.
  21
  22 Since each ``ceph-mgr`` hosts its own instance of dashboard, it may
  23 also be necessary to configure them separately. The hostname and port
  24 can be changed via the configuration key facility::
  25
  26   ceph config-key put mgr/dashboard/$name/server_addr $IP
  27   ceph config-key put mgr/dashboard/$name/server_port $PORT
  28
  29 where ``$name`` is the ID of the ceph-mgr who is hosting this
  30 dashboard web app.
  31
  32 These settings can also be configured cluster-wide and not manager
  33 specific.  For example,::
  34
  35   ceph config-key put mgr/dashboard/server_addr $IP
  36   ceph config-key put mgr/dashboard/server_port $PORT
  37
  38 If the port is not configured, the web app will bind to port ``7000``.
  39 If the address it not configured, the web app will bind to ``::``,
  40 which corresponds to all available IPv4 and IPv6 addresses.
  41
  42 Load balancer
  43 -------------
  44
  45 Please note that the dashboard will *only* start on the manager which
  46 is active at that moment. Query the Ceph cluster status to see which
  47 manager is active (e.g., ``ceph mgr dump``).  In order to make the
  48 dashboard available via a consistent URL regardless of which manager
  49 daemon is currently active, you may want to set up a load balancer
  50 front-end to direct traffic to whichever manager endpoint is
  51 available.