This is the documentation for CDH 4.7.0.
Documentation for other versions is available at Cloudera Documentation.

Administering Hue

The following sections contain details about managing and operating a Hue installation.

Anonymous Usage Data Collection

Hue tracks anonymised pages and application versions in order to gather information to help compare each application's usage levels. The data collected does not include any hostnames or IDs. For example, the data is of the form: /2.3.0/pig, /2.5.0/beeswax/execute.

For Hue 2.5.0 (and later), you can restrict this data collection by setting the collect_usage property to false under the [desktop] section in the Hue configuration file, hue.ini.

[desktop]
...
# Help improve Hue with anonymous usage analytics.
# Use Google Analytics to see how many times an application or specific section of an application is used, nothing more.   
## collect_usage=false

If you are using an earlier version of Hue, disable data collection by navigating to Step 3 of Hue's Quick Start Wizard. Under Anonymous usage analytics, uncheck the Check to enable usage analytics checkbox.

Processes

A script called supervisor manages all Hue processes. The supervisor is a watchdog process; its only purpose is to spawn and monitor other processes. A standard Hue installation starts and monitors the following processes:

  • runcpserver – a web server that provides the core web functionality of Hue
  • beeswax server – a daemon that manages concurrent Hive queries

If you have installed other applications into your Hue instance, you may see other daemons running under the supervisor as well.

You can see the supervised processes running in the output of ps -f -u hue.

Note that the supervisor automatically restarts these processes if they fail for any reason. If the processes fail repeatedly within a short time, the supervisor itself shuts down.

Logs

You can view the Hue logs in the /var/log/hue directory, where you can find:

  • An access.log file, which contains a log for all requests against the Hue Server.
  • A supervisor.log file, which contains log information for the supervisor process.
  • A supervisor.out file, which contains the stdout and stderr for the supervisor process.
  • A .log file for each supervised process described above, which contains the logs for that process.
  • A .out file for each supervised process described above, which contains the stdout and stderr for that process.

If users on your cluster have problems running Hue, you can often find error messages in these log files.

Viewing Recent Log Messages

In addition to logging INFO level messages to the logs directory, the Hue Server keeps a small buffer of log messages at all levels in memory. The DEBUG level messages can sometimes be helpful in troubleshooting issues.

In the Hue UI you can view these messages by selecting the Server Logs tab in the About application. You can also view these logs by visiting http://myserver:port/logs.