open-nomad/website/source/intro/getting-started/ui.html.md

2.3 KiB

layout page_title sidebar_current description
intro Web UI getting-started-ui Visit the Nomad Web UI to inspect jobs, allocations, and more.

Web UI

At this point we have a fully functioning cluster with a job running in it. We have learned how to inspect a job using nomad status, next we'll learn how to inspect a job in the web client.

Opening the Web UI

As long as Nomad is running, the Nomad UI is also running. It is hosted at the same address and port as the Nomad HTTP API under the /ui namespace.

With Nomad running, visit http://localhost:4646 to open the Nomad UI.

Nomad UI Jobs List

If you can't connect it's possible that Vagrant was unable to properly map the port from your host to the VM. Your vagrant up output will contain the new port mapping:

==> default: Fixed port collision for 4646 => 4646. Now on port 2200.

In the case above you would connect to http://localhost:2200 instead.

Inspecting a Job

You should be automatically redirected to /ui/jobs upon visiting the UI in your browser. This pages lists all jobs known to Nomad, regardless of status. Click the example job to inspect it.

Nomad UI Job Detail

The job detail page shows pertinent information about the job, including overall status as well as allocation statuses broken down by task group. It is similar to the nomad status CLI command.

Click on the cache task group to drill into the task group detail page. This page lists each allocation for the task group.

Nomad UI Task Group Detail

Click on the allocation in the allocations table. This page lists all tasks for an allocation as well as the recent events for each task. It is similar to the nomad alloc status command.

Nomad UI Alloc Status

The Nomad UI offers a friendly and visual alternative experience to the CLI.

Next Steps

We've now concluded the getting started guide, however there are a number of next steps to get started with Nomad.