Read-only Console

The installation of Gloo Edge Federation includes a read-only console, providing a wealth of information about the Gloo Edge instances being managed by Gloo Edge Federation available at a glance. This guide will take you through the process of accessing the console and show you some of the features of the interface.

Prerequisites

To successfully follow this guide, you will need the following software available and configured on your system.

In this guide we are going to use the Gloo Edge Federation environment available from the glooctl demo federation command. You can follow the directions in the Getting Started guide to set up the demonstration environment. Otherwise, you will need at least one Kubernetes cluster running Gloo Edge Enterprise and Gloo Edge Federation.

For the purposes of this example, we have two clusters local and remote. The local cluster is also running Gloo Edge Federation in addition to Gloo Edge Enterprise. The kubectl context for the local cluster is kind-local and the remote cluster is kind-remote.

Configure access to the console

The Gloo Edge Federation console is exposed by the gloo-fed-console service running in the gloo-fed namespace. The console is available on port 8090. In a production scenario, you could choose to create a new service exposing the console on an IP address available outside the cluster. For our example, we are going to port-forward the service to the local IP address of the machine running the demonstration environment.

# Launch the port-forward for port 8090
kubectl port-forward svc/gloo-fed-console -n gloo-fed 8090:8090


You should now be able to access the read-only console from the machine’s local ip address.

Exploring the console

Overview and Gloo Edge instances

When the console initially loads, you will see an overview page providing you with the overall status of your Gloo Edge instances, clusters, Virtual Services, and Upstreams.

Console Overview

You can get more information about your Gloo Edge instances by clicking on the Gloo Instances item in the navigation bar.

Gloo Edge Instances Nav Bar

The Gloo Edge Instances page will show you the status of each Gloo Edge instance, including the cluster, namespace, and version of the Gloo Edge instance.

Gloo Edge Instances Overview

The Gloo Edge instance view also provides you with a snapshot of the Virtual Services and Upstreams available on the Gloo Edge instance. You can drill down for more information by clicking on View Gloo Details. The details view provides more information about each resource broken up across tabs.

Gloo Edge Instances Details

If you would like to see further details about a particular resource, you can click on the resource name in the list. For instance, here are the details on the fed-upstream resource.

Gloo Edge Upstream Details

From this page you can download the yaml for the resource configuration, or view the configuration in the browser.

Admin settings for a Gloo Edge instance

From the Gloo Instances menu item, you will see a list of each Gloo Edge Instance managed by Gloo Edge Federation.

Gloo Edge Instances Nav Bar

You can click on View Now in the Admin Settings section of each instance to see more about Gateways, Proxies, and Gloo Edge settings.

Gloo Edge Instances Admin Settings

The Admin Settings view will show the status of each Gateway and Proxy configuration associated with the Gloo Edge instance. You can also view the general Gloo Edge instance settings from this view.

Gloo Edge Instances Admin Settings

You can drill down into each resource type by clicking on the link at the bottom of each setting. The View Gateways link, will take you to a view of the configured gateways on the Gloo Edge instance and show the raw yaml configuration for each gateway.

Gloo Edge Instances Gateway Settings

From here, you can use the buttons on the side to view the Proxy configurations or the general settings for the Gloo Edge instances.

Gloo Edge Instances Admin Settings

Exploring Virtual Services and Upstreams

There are two more menu items in the navigation bar, Virtual Services and Upstreams.

Gloo Edge Console Nav Bar

Clicking on the Virtual Services menu item will show us a unified view of all Virtual Services running across all managed Gloo Edge instances:

Gloo Edge Virtual Services

You can search for a particular Virtual Service or filter on properties like Accepted, Rejected, or Pending.

Clicking on the Upstreams menu item will show us a unified view of all Upstreams running across all managed Gloo Edge instances:

Gloo Edge Upstreams

Similar to the Virtual Services view, you can search for a particular Upstream or filter on properties like Accepted, Rejected, or Pending.

Next steps

The read-only console provides a powerful view into the status of all your managed Gloo Edge instances. If you’d like to see how to make changes that will be reflected in the console, we recommend following the Federated Configuration or Service Failover guides.