SES 7 | Administration and Operations Guide | Dashboard's Web user interface

2.1 Logging in #

To log in to the Ceph Dashboard, point your browser to its URL including the port number. Run the following command to find the address:

cephuser@adm > ceph mgr services | grep dashboard
"dashboard": "https://host:port/",

The command returns the URL where the Ceph Dashboard is located. If you are having issues with this command, see Section 10.1, “Locating the Ceph Dashboard”.

Figure 2.1: Ceph Dashboard login screen #

Log in by using the credentials that you created during cluster deployment (see Section 7.2.9, “Configuring the Ceph Dashboard login credentials”).

Tip: Custom user account

If you do not want to use the default admin account to access the Ceph Dashboard, create a custom user account with administrator privileges. Refer to Chapter 11, Manage users and roles on the command line for more details.

The dashboard user interface is graphically divided into several blocks: the utility menu in the top right-hand side of the screen, the main menu on the left-hand side, and the main content pane.

Figure 2.2: Ceph Dashboard home page #

2.2 Utility menu #

The top right-hand side of the screen contains a utility menu. It includes general tasks related more to the dashboard than to the Ceph cluster. By clicking the options, you can access the following topics:

Change the dashboard's language interface to: Czech, German, English, Spanish, French, Indonesian, Italian, Japanese, Korean, Polish, Portuguese (Brazilian), and Chinese.
Tasks and notifications
View the documentation, information about the REST API, or further information about the dashboard.
User management and telemetry configuration.
Note
For more detailed command line descriptions for user roles, see Chapter 11, Manage users and roles on the command line.
Log in configuration; change the password or sign out.

2.3 Main menu #

The dashboard's main menu occupies the left-hand side of the screen. It covers the following topics:

Dashboard: Return to Ceph Dashboard's home page.
Cluster: View detailed information about hosts, inventory, Ceph Monitors, services, Ceph OSDs, cluster configuration, CRUSH Map, Ceph Manager modules, logs, and monitoring.
Pools: View and manage cluster pools.
Block: View detailed information and manage RADOS Block Device images, mirroring, and iSCSI.
NFS: View and manage NFS Ganesha deployments.
Note
If NFS Ganesha is not deployed, an information notice appears. See Section 11.6, “Configuring NFS Ganesha in the Ceph Dashboard”.
Filesystems: View and manage CephFSs.
Object Gateway: View and manage Object Gateway's daemons, users, and buckets.
Note
If Object Gateway is not deployed, an informative notice appears. See Section 10.4, “Enabling the Object Gateway management front-end”.

2.4 Content pane #

The content pane occupies the main part of the dashboard's screen. The dashboard home page shows plenty of helpful widgets to inform you briefly about the current status of the cluster, capacity, and performance information.

2.5 Common Web UI features #

In Ceph Dashboard, you often work with lists—for example, lists of pools, OSD nodes, or RBD devices. All lists will automatically refresh themselves by default every five seconds. The following common widgets help you manage or adjust these list:

Click to trigger a manual refresh of the list.

Click to display or hide individual table columns.

Click and enter (or select) how many rows to display on a single page.

Click inside and filter the rows by typing the string to search for.

Use to change the currently displayed page if the list spans across multiple pages.

2.6 Dashboard widgets #

Each dashboard widget shows specific status information related to a specific aspect of a running Ceph cluster. Some widgets are active links and after clicking them, they will redirect you to a related detailed page of the topic they represent.

Tip: More details on mouse over

Some graphical widgets show you more detail when you move the mouse over them.

2.6.1 Status widgets #

Status widgets give you a brief overview about the cluster's current status.

Figure 2.3: Status widgets #

Cluster Status: Presents basic information about the cluster's health.
Hosts: Shows the total number of cluster nodes.
Monitors: Shows the number of running monitors and their quorum.
OSDs: Shows the total number of OSDs, as well as the number of up and in OSDs.
Managers: Shows the number of active and standby Ceph Manager daemons.
Object Gateways: Shows the number of running Object Gateways.
Metadata Servers: Shows the number of Metadata Servers.
iSCSI Gateways: Shows the number of configured iSCSI gateways.

2.6.2 Capacity widgets #

Capacity widgets show brief information about the storage capacity.

Figure 2.4: Capacity widgets #

Raw Capacity: Shows the ratio of used and available raw storage capacity.
Objects: Shows the number of data objects stored in the cluster.
PG Status: Displays a chart of the placement groups according to their status.
Pools: Shows the number of pools in the cluster.
PGs per OSD: Shows the average number of placement groups per OSD.

2.6.3 Performance widgets #

Performance widgets refer to basic performance data of Ceph clients.

Figure 2.5: performance widgets #

Client Read/Write: The amount of clients' read and write operations per second.
Client Throughput: The amount of data transferred to and from Ceph clients in bytes per second.
Recovery Throughput: The throughput of data recovered per second.
Scrubbing: Shows the scrubbing (see Section 17.4.9, “Scrubbing a placement group”) status. It is either inactive, enabled, or active.