Using the Admin Dashboard
When you install Gloo Mesh Enterprise, it includes the Admin Dashboard service by default. The service provides a visual dashboard into the health and configuration of Gloo Mesh and registered clusters.
In this guide, you will learn how to connect to the Admin Dashboard and the basic layout of the portal’s contents.
About the Admin Dashboard
The Admin Dashboard runs on a pod in the Gloo Mesh Enterprise deployment and is exposed as a service. It does not have any authentication applied, so anyone with access to the Admin Dashboard can view the configuration and resources managed by the Gloo Mesh. That bears repeating:
Access to the Admin Dashboard should be restricted to only those who need to administer the Gloo Mesh. The
gloo-mesh-console service is of the type ClusterIP, so it is not exposed outside of the cluster.
Connecting to the Admin Dashboard
The Admin Dashboard is served from the gloo-mesh-console service on port 8090. You can connect using the
meshctl dashboard command or by using the port-forward feature of kubectl. For this guide we will use port-forwarding. The following command assumes that you have deployed the Gloo Mesh to the namespace gloo-mesh. From a command prompt, run the following to set up port-forwarding for the gloo-mesh-console service.
kubectl port-forward -n gloo-mesh svc/gloo-mesh-console 8090:8090
Once the port-forwarding starts, you can open your browser and connect to http://localhost:8090. You will be taken to a webpage that looks similar to this:
Now that you’re connected, let’s explore the UI.
Exploring the Admin Dashboard
The main page of the dashboard starts with an Overview of the resources under management of Gloo Mesh, such as Clusters, Workloads, and Traffic Targets.
Across the top of the page is a navigation bar with five options.
- Overview: Provides a high-level overview of Gloo Mesh
- Meshes: Displays service meshes being managed by Gloo Mesh
- Policies: Displays defined traffic and access policies for Gloo Mesh
- Wasm: Displays WASM deployments being managed by Gloo Mesh
- Debug: Displays full configurations for service meshes.
There is also a small gear to the right of the navigation elements, which will take you to the Admin area.
From there you are able to view clusters and Role-based access configurations.
The purpose of the Admin Dashboard is to view the status of Gloo Mesh and managed resources. It is not possible to make changes to resources or the configuration. Clicking on the Register a Cluster button simply provides you with directions on using meshctl to register a cluster.
The Meshes area provides a view of virtual meshes and each service mesh that is not part of a virtual mesh. You can view the health of each mesh, as well as information about traffic targets, workloads, failovers, and more.
Clicking on a details link will provide in-depth information about each category associated with the mesh, and allows you to further drill down and view the configuration and associated resources for each element.
By clicking on one of the traffic targets in the list, we can see more information about the target's configuration, policies, and any associated workloads.
The Policies area allows us to explore the configured policy rules that have been created, and quickly assess what workloads, traffic targets, and meshes they are associated with.
We can view additional detail about a policy rule by clicking on it.
The Debug section allows you to view and download the full configuration of any virtual meshes, as well as view details of each service mesh Gloo Mesh is aware of.
You can use this view to quickly ascertain information about a particular mesh or to capture the current configuration of a virtual mesh.
If your Admin Dashboard is looking a bit sparse, now might be a good time to walk through the Istio installation or traffic policy guides.