Web Interface

Slack Docker Pulls

Alluxio has a user-friendly web interface to allow users to monitor and manage the system. Each master and worker serve their own web UI. The default port for the web interface is 19999 for the master and 30000 for the workers.

Alluxio Master Web UI

The Alluxio master serves a web interface to help manage the system. The default port for the Alluxio master web interface is 19999, so the web interface can be viewed by visiting http://<MASTER IP>:19999. For instance, if you started Alluxio locally, the master web interface can be viewed by visiting localhost:19999.

The Alluxio master web interface contains several different pages, described below.

Home

The Alluxio master home page looks something like below:

Alluxio Master Home Page

The home page gives an overview of the system status. It includes the following sections:

  • Alluxio Summary Alluxio system level information

  • Cluster Usage Summary Alluxio storage information as well as under storage information. Alluxio storage utilization can be near 100%, but under storage utilization should not approach 100%.

  • License Summary Alluxio license information

  • Storage Usage Summary Alluxio tiered storage information which gives a break down of amount of space used per tier across the Alluxio cluster.

Browse

You can browse the Alluxio file system through the UI. When selecting the “Browse” tab in the navigation bar, you will see something like this:

browse

Files in the current folder are listed, with the file name, file size, size for each block, the percentage of in-Alluxio data, creation time, and the modification time. To view the content of a file, click on that file.

viewFile

Configuration

To check the current configuration information, click “Configuration” in the navigation bar on the top of the screen.

configurations

The configuration page has two sections:

  • Alluxio Configuration A map of all the Alluxio configuration properties and their set values.

  • Whitelist Contains all the Alluxio path prefixes eligible to be stored in Alluxio. A request may still be made to a file not prefixed by a path in the whitelist. Only whitelisted files will be stored in Alluxio.

Workers

The master also shows all known Alluxio workers in the system and shows them in the “Workers” tab.

workers

The workers page gives an overview of all Alluxio worker nodes divided into two sections:

  • Live Workers A list of all the workers currently serving Alluxio requests. Clicking on the worker name will redirect to the worker’s web UI.

  • Lost Workers A list of all workers proclaimed as dead by the master, usually due to a long timeout waiting for the worker heartbeat. Possible causes include system restart or network failures.

In-Alluxio Data

To browse all files in Alluxio, click on the “In-Alluxio Data” tab in the navigation bar.

inMemFiles

Files currently in Alluxio are listed, with the file name, file size, size for each block, whether the file is pinned or not, the file creation time, and the file modification time.

Logs

To browse the master node’s logs directory, click “Logs” in the navigation bar on the top of the screen.

workers

Metrics

To access master metrics section, click on the “Metrics” tab in the navigation bar.

masterMetrics

This section shows all master metrics. It includes the following sections:

  • Master Gauges Overall measures of the master.

  • Logical Operation Number of operations performed.

  • RPC Invocation Number of RPC invocations per operation.

Enable/Disable Auto-Refresh

To toggle the browser to automatically refresh information, click the “Enable Auto-Refresh” button. Click it again to disable.

Alluxio Worker Web UI

Each Alluxio worker serves a web interface to show worker information. The default port for the worker web interface is 30000, so the web interface can be viewed by visiting http://<WORKER IP>:30000. For instance, if you started Alluxio locally, the worker web interface can be viewed by visiting localhost:30000.

Home page

The home page for the Alluxio worker web interface is similar to the home page for the Alluxio master, but shows information specific to a single worker. Therefore, it has similar sections: Worker Summary, Storage Usage Summary, Tiered Storage Details.

Alluxio Worker Home Page

BlockInfo

In the “BlockInfo” page, you can see the files on the worker, and other information such as the file size and which tiers the files is stored on. Also, if you click on a file, you can view all the blocks of that file.

Logs

To browse the worker node’s logs directory, click “Logs” in the navigation bar on the top of the screen.

logs

Metrics

To access worker metrics section, click on the “Metrics” tab in the navigation bar.

workerMetrics

This section shows all worker metrics. It includes the following sections:

  • Worker Gauges Overall measures of the worker.

  • Logical Operation Number of operations performed.

Enable/Disable Auto-Refresh

To toggle the browser to automatically refresh information, click the “Enable Auto-Refresh” button. Click it again to disable.

Return to Master

Provides a link to the Master node’s web UI.

Security

Authentication

A pair of username and password can be set to restrict access to the web UI, set the following properties in alluxio-site.properties to enable login authentication for the web UI:

alluxio.web.login.enabled=true
alluxio.web.login.username=xxx
alluxio.web.login.password=xxx

SSL

To enable HTTPS for the web UI, set the following properties in alluxio-site.properties:

alluxio.web.ssl.enabled=true
alluxio.web.ssl.keystore.path=<path to the keystore containing the SSL key pairs and certificate>
alluxio.web.ssl.keystore.password=<keystore password>
alluxio.web.ssl.key.password=<SSL key's password in the keystore>
alluxio.web.ssl.key.alias=<SSL key's alias in the keystore>