[Summary view] [Print] [Text view]

   1  @title Using DarkConsole
   2  @group developer
   3  
   4  Enabling and using the built-in debugging console.
   5  
   6  = Overview =
   7  
   8  DarkConsole is a debugging console built into Phabricator which exposes
   9  configuration, performance and error information. It can help you detect,
  10  understand and resolve bugs and performance problems in Phabricator
  11  applications.
  12  
  13  DarkConsole was originally implemented as part of the Facebook Lite site; its
  14  name is a bit of play on that (and a reference to the dark color palette its
  15  design uses).
  16  
  17  = Warning =
  18  
  19  Because DarkConsole exposes some configuration and debugging information, it is
  20  disabled by default (and **you should not enable it in production**). It has
  21  some simple safeguards to prevent leaking credential information, but enabling
  22  it in production may compromise the integrity of an install.
  23  
  24  = Enabling DarkConsole =
  25  
  26  You enable DarkConsole in your configuration, by setting `darkconsole.enabled`
  27  to `true`, and then turning it on in `Settings` -> `Developer Settings`. Once
  28  DarkConsole is enabled, you can show or hide it by pressing ##`## on your
  29  keyboard.
  30  
  31  Since the setting is not available to logged-out users, you can also set
  32  `darkconsole.always-on` if you need to access DarkConsole on logged-out pages.
  33  
  34  DarkConsole has a number of tabs, each of which is powered by a "plugin". You
  35  can use them to access different debugging and performance features.
  36  
  37  = Plugin: Error Log =
  38  
  39  The "Error Log" plugin shows errors that occurred while generating the page,
  40  similar to the httpd ##error.log##. You can send information to the error log
  41  explicitly with the @{function@libphutil:phlog} function.
  42  
  43  If errors occurred, a red dot will appear on the plugin tab.
  44  
  45  = Plugin: Request =
  46  
  47  The "Request" plugin shows information about the HTTP request the server
  48  received, and the server itself.
  49  
  50  = Plugin: Services =
  51  
  52  The "Services" plugin lists calls a page made to external services, like
  53  MySQL and the command line.
  54  
  55  = Plugin: XHProf =
  56  
  57  The "XHProf" plugin gives you access to the XHProf profiler. To use it, you need
  58  to install the corresponding PHP plugin -- see instructions in the
  59  @{article:Installation Guide}. Once it is installed, you can use XHProf to
  60  profile the runtime performance of a page.