Explore the UI

The UI offers a view-only experience. Users cannot modify resources.

Home

View the health and performance of your Gloo Mesh Enterprise components and Istio workloads, and view recommendations to harden your setup by using the Dashboard and Insights pages.

Dashboard

The Dashboard page presents an at-a-glance look at the health of workspaces and clusters that make up your Gloo setup.

In the Workspaces and Clusters panes, you can review a count of the healthy resources, sort by, or search by name for your resources. You can review top-level details about each resource in the resource cards. For more information about workspaces and registered clusters, see the Setup docs.

From the default collapsed view, you can see the number of clusters, namespaces, and gateways in a card for each workspace.

Actions you can take:

  • Click the expand icon () to expand the card. You see more information about the imported and exported resources, destinations, and policies.
  • Click MORE DETAILS ∨ to jump to the workspace details page for that workspace.

About the counts:

  • The details are taken from the Workspace custom resource status, which you can check in the CLI by running kubectl get workspace -n gloo-mesh -o yaml.
  • Resource counts include imported resources. For example, the total count of destinations includes Kubernetes services in your workspace, plus all Kubernetes services that your workspace imports.
  • To check imported resources, you might use labels. Labels are used to import and export resources. Your platform admin can tell you if a particular label is used, such as exported: true. Then, you can check all resources for this label, such as in the terminal by running kubectl get services -A -l exported=true.

From the default collapsed view, you can see the region, Kubernetes version, and, if you use the Cilium CNI, the Cilium version in a card for each cluster. Each cluster must be registered with Gloo Platform via the KubernetesCluster custom resource.

Click the expand icon () to expand the card. You see more information about the Kubernetes resource configuration and compute hardware of the cluster.

Overview UI screenshot

Traffic

Review the configuration of ingress and egress gateways in your Gloo Platform environment.

Gateways

Gloo Gateway license only: Virtual gateways consistently configure traffic into and across your environment. Click a gateway to view its details. The details are organized into the following areas. For more information, see Configure gateway listeners in the Gloo Gateway docs.

Portals

Gloo Gateway license only: In Gloo Gateway, you can expose your APIs in user-facing developer portals. This way, your end users can browse through your API products, see the usage plans you offer per product, review the OpenAPI docs, and even generate API keys to securely access your APIs. For more information, see the Portal in the Gloo Gateway docs.

To view more details, click a portal.

API Registry

Gloo Gateway license only: From the API Registry page, you can review route tables that are backed by the following types of APIs:

To review the details of the APIs in your route table, click the route table. Then, you can review the OpenAPI schema and paths, as well as other information such as the portals and gateways that the APIs are exposed on or the backing destinations.

Resources

Find an overview of resources that are deployed in your cluster and use the filter options in the Gloo UI to find the resource that you need.

Solo

View the Gloo resources in your Gloo Mesh Enterprise environment, such as policies, workspaces, and route tables. Use the Filter by options to filter the list by resource type. To view the YAML configuration for a resource, click View YAML.

Figure: Solo resources page

Istio

View the Istio resources in your Gloo Mesh Enterprise environment, such as virtual services, gateways, or Istio operators. Use the Filter by options to filter the list by Istio resource type. To view the YAML configuration for a resource, click View YAML.

Figure: Istio resources page

Cilium

If you use the Cilium CNI in your clusters, you can view the Cilium network policies that you applied to your workloads. For more info, see About Cilium in Gloo Mesh and the Solo distribution of Cilium CNI installation guide.

Gateway API

View all Kubernetes Gateway API resources in your environment. For more information, see the Kubernetes Gateway API guide in the Istio documentation.

Kubernetes

View all Kubernetes resources in your cluster, such as services, service accounts, secrets, or cluster roles. Use the Filter by options to filter the list by Kubernetes resource type. To view the YAML configuration for a resource, click View YAML.

Figure: Resources page

Observability

The Gloo UI consumes telemetry data from Prometheus and Jaeger and visualizes this data in the Observability section.

Graph

The Gloo UI includes a Graph page to visualize the network traffic that reaches your service mesh. The graph is based on Prometheus metrics that are collected with the Gloo telemetry pipeline.

To populate the Gloo UI graph with data, you must set the telemetryCollector.enabled Helm setting to true in each cluster in your environment. If you installed Gloo Mesh at version 2.5 or later, this setting is enabled by default. If you installed Gloo Mesh in a multicluster environment at version 2.4 or earlier, be sure you enable this setting in the Helm values for your management cluster.

Review the following sections to learn more about the Graph layout.

Layout settings

From the footer toolbar, click Layout Settings. Toggle on or off the following settings.

  • Animations: Change the paths between nodes from a directional animation to a solid line.
  • Group By: In view 1, toggle the architectural layout between CLUSTER and WORKSPACE.
    • CLUSTER: Review the clusters and Kubernetes namespaces that your app nodes are organized in. For example, you might want to focus on reviewing multicluster traffic failover by toggling this view.
    • WORKSPACE: Review the Gloo workspaces that your app nodes are organized in. For example, you might want to focus reviewing traffic across each of your team's workspaces.
  • Mutual TLS: If you use Gloo Mesh Enterprise, toggle the lock icons along paths between nodes. For example, if all your workspaces enable service isolation, then all traffic is secured via mTLS. Thus, you might not want to see the lock icons.
  • TCP: Review TCP traffic.
  • Cilium: If you use the Cilium CNI, toggle on or off the network graph for connections enabled by the Cilium CNI.
Nodes represent the application “nodes” of the graph. (Note that nodes represent your apps, not Kubernetes compute nodes.) You can toggle on and off views for the following nodes:

  • Kubernetes services
  • External services
  • Gateways
Toggle on or off idle nodes, which are nodes that do not receive traffic.

Graph UI layout settings

Header, filter, and footer toolbars for navigation

In the Search bar, filter the services that you want to see in the graph. You can choose to include or hide those services.

From the Traffic dropdown, select the range of time that you want the graph to show, such as traffic from the last 15 minutes.

From the Refresh dropdown, select how often you want the graph to refresh the data, such as every 5 seconds. You can also refresh on demand by clicking REFRESH.

Graph UI header toolbar

After the header toolbar, you can filter what the graph shows by workspace, namespace, and cluster. Filters work like the logical operator AND, so results must meet all the criteria. For example, if you filter by bookinfo workspace, bookinfo namespace, and cluster1, then the graph shows services that meet all these criteria.

Toggle Errors Only to see services that experienced traffic errors during the traffic time range you selected from the header toolbar.

Graph UI filter toolbar

Within the graph views, you can navigate by clicking and dragging whitespace within the main canvas, or by using the navigation arrow buttons, as shown in the following figure.

Graph UI navigation pane

After the header toolbar, filter, and main canvas, you can choose more viewing options in the footer toolbar.

Graph UI footer toolbar

# Icon name Description
1 Fullscreen Click to expand your browser to fullscreen. Click again or enter ESC to return to the normal screen size.
2 Zoom in and out Zoom in or out on the main view's canvas. Depending on your mouse settings, you can also scroll to zoom in and out.
3 Fit to canvas Click to center and fit the content of the current view to the canvas size. This action might be helpful if you rearranged the nodes and zoomed in.
4 Networking graph views Click one of the networking graph views to change how the nodes are displayed in the main canvas. For more information, see Networking views.
5 View legend Open the graph legend. For more information, see Legend.
6 Layout settings Open the graph layout settings. For more information, see Layout settings.

Legend

From the footer toolbar, click Show Legend.

Node Types describes the icons that are used for the application “nodes” of the graph. For example, a node might be a Kubernetes service, Istio gateway, external service, or an attached virtual machine (VM). (Note that nodes represent your apps, not Kubernetes compute nodes.)

Node States and Edges show whether a service's traffic behaves normally or not, as indicated by a color or icon.

Color or icon State Description
Blue Normal The node sends and responds to traffic as expected.
Red Danger The node has some sort of failure. For example, a policy might be applied to a route that blocks traffic to a service.
Yellow Warn The node has some sort of degraded traffic. For example, a policy might be applied to a route that rate limits traffic to a service. Most of the requests are successful, but some are not.
Gray Idle The node does not yet accept or send traffic. For example, the deployment might be pending.
Dashed, black line L7 The traffic between nodes is sent over Layer 7 (application). For this traffic, you can apply L7 HTTP/HTTPS Gloo Mesh and Gloo Gateway policies.
Solid, navy line L4 The traffic between nodes is sent over Layer 4 (transport). You cannot apply Gloo Mesh Enterprise or Gloo Mesh Gateway policies to Layer 4 traffic as these products operate on Layer 7. To protect Layer 4 routes, you must install Gloo Mesh Enterprise with Cilium and use access policies that are translated into Layer 3/4 network policies, or install Gloo Network for Cilium and create Cilium network policies.
Colorful triangles Failure, Healthy, Degraded, or Idle The connection is in a state of failure, healthy, degraded, or idle, depending on the color. Try describing the resources in your cluster to troubleshoot further.
Blue lock icon mTLS applied Service isolation is enabled for the traffic, with communication secured via mTLS. You can change service isolation settings via an access policy for a specific destination, or for the entire workspace via the workspace settings.
Cilium icon Enforced by Cilium The traffic connection is enforced by Cilium, which indicates that you use Gloo Mesh Enterprise or Gloo Network for Cilium.
Istio icon Enforced by Istio The traffic connection is enforced by Istio, which indicates that you use Gloo Mesh, or Gloo Gateway for gateway-only connections.

Graph UI legend

Networking views

Show an architectural view of your app nodes in the main canvas area of the graph. This view organizes the app nodes by the Gloo workspace, Kubernetes namespace, and cluster that you filter for.

To rearrange nodes, click and drag. In this view, your changes are cached so that the canvas setup stays similar when you return to the page. For information on the edge paths, node states, locks, and more, see the Legend tab.

Graph UI view 1

Show a simple view of the app nodes in your environment. Nodes are grouped together in close proximity. This view does not show workspace, namespace, or cluster boundaries. However, those boundaries are still used to show or hide out nodes based on your filters.

To rearrange nodes, click and drag. Note that in this view, your changes are NOT cached. For information on the edge paths, node states, locks, and more, see the Legend tab.

Graph UI view 2

Show a simple view of the app nodes in your environment. Nodes are organized into a vertical chain layout. This view does not show workspace, namespace, or cluster boundaries. However, those boundaries are still used to show or hide out nodes based on your filters.

To rearrange nodes, click and drag. Note that in this view, your changes are NOT cached. For information on the edge paths, node states, locks, and more, see the Legend tab.

Graph UI view 3

Tracing

Gloo Mesh Enterprise integrates with Jaeger as the tracing platform. Jaeger is an open source tool that helps you follow the path of a request as it is forwarded between microservices. The chain of events and interactions are then captured by the Gloo telemetry pipeline and visualized in the Jaeger UI that is embedded on the Tracing page of the Gloo UI. You can use this data to troubleshoot issues in your microservices and identify bottlenecks.

To access the Jaeger UI through the Gloo UI, you must enable tracing in the Gloo telemetry pipeline and instrument your apps to collect traces. If you have an existing Jaeger instance that you want to use to visualize traces, you can configure the Gloo UI to embed the UI of your Jaeger instance. For more information, see Add Istio request traces.

Tracing UI

Logs

You can use the Gloo UI log viewer to see the logs of Gloo Platform components, such as the Gloo management server, the Gloo telemetry collector agent, or the Gloo UI. These logs can help you monitor the health of your Gloo Platform components and troubleshoot issues.

To view logs, use the log viewer filter options to select the cluster, Gloo Platform component, pod name, and, if applicable, the container that you want to check the logs for. You can also use the search capability to find logs that match a specific search term, or download the logs so that you can share them with your team.

Logs UI