Overview

Get to know the features of Infra App

The Interface

Once you've downloaded and started Infra App, you'll be presented with the main user interface. Below is a quick guide to help you navigate the app.

Workloads

  1. The Cluster Switcher. The cluster switcher is where you can switch between your configured Kubernetes Clusters. By default Infra App detects your local Kubernetes Configuration file (Kubeconfig) and can be extended by adding your own configuration file by selecting Add Configuration in the dropdown or via the hotkey ⌘+O.

  2. The Sidebar. Switch between the Workloads and Cluster views.

  3. The Namespaces Filter. The Namespaces filter on the left-hand side helps you filter quickly by the namespaces you have access to. All the workloads on the selected namespace will be shown on the right.

  4. The Workloads Search Bar. In the search bar, you will be able to search for particular workloads by its name. In the future, the search feature will be expanded to use other metadata.

  5. System Workloads Button. By selecting the System workloads button, all the workloads that belong to kube-system will be included in the workloads page.

  6. Workloads Overview. In the main Workloads view, you will see a list of all your workloads along with information on its utilization (CPU and memory usage) and its status. At any point in time, you can click on a particular workload to see its details including streaming logs, events and its YAML file. If you do not see utilization metrics it means that Infra App cannot connect to metrics-server on the cluster to gather the data.

Workload Details

  1. Workload Status. Workload status shows the current status of the workload as reported by Kubernetes.

  2. Activity Tabs. You can use the activity tabs to switch between Overview, Logs, Events, and YAML for the particular workload.

    1. Logs tab. Infra App will automatically aggregate all the logs for this workload from different pods and containers in real-time. By default the log streamer will auto-refresh when the scroll bar is scrolled to the bottom. The log stream will stop auto-scrolling when you move the scroll bar away from the bottom.

    2. Events tab. In the events tab, Infra App automatically fetches all the related events pertaining to this workload -- such as volumes, endpoints, controllers, and more.

    3. YAML tab. YAML tab will show you the YAML file used to set-up the workload.

  3. Overview. Here you will find the kind of the workload, the namespace it's associated with, its creation date, the labels attached to the workload, and the image(s) the workload is currently using.

  4. Utilization. For CPU / Memory utilization, Infra App automatically detects whether you have metrics-server installed by looking at the Kubernetes metrics endpoint.

  5. Pods. In the pods section, you will be able to see a list of all related pods and its current status.

  6. Pod Actions. In the actions dropdown via the "..." button, you will be able to perform actions on individual pods such as open shell to a particular container, view logs from a pod, and ability to delete a pod.

  7. Related Resources

    1. Services. In the services section, you will be able to see the type of the service(s) and its endpoints. Infra App makes the endpoints hyperlinked so you can click on it to see the result in a web browser if supported.

    2. Ingresses. If your cluster is using an IngressController and you are routing traffic to this workload, the ingress rules will show up here.

    3. ConfigMaps. For workloads with a configmap, you'll be able to view it direction in this section.

Cluster

  1. Overview. High-level details about the cluster, including it's total pod usage & capacity.

  2. Utilization. CPU & Memory utilization percentages of the cluster, broken down by usage, requests & limits. This tells you how full your cluster is in terms of actual usage but also in terms of resources requested by workloads.

  3. Nodes. The nodes connected to this cluster and their statuses. Click on a node to view mode tails, or click on the table headers to sort nodes. For example, you can sort by Memory to view which nodes are closest to being over capacity.

  4. Utilization switcher. View node utilization in terms of usage, requests and limits.

Node Details

  1. Node Status. Tells you if this node is running and accepting workloads.

  2. Overview. High-level details about the node, including it's total pod usage & capacity and IP addresses.

  3. Utilization. Similar to cluster utilization, this section tells you the CPU & Memory utilization percentages of the node, broken down by usage, requests & limits.

  4. Pods. Shows you which pods are running on this node. Pods are sorted by status by default but you can sort them by CPU & Memory to see which are using the most resources on this node.

  5. Metadata (below - not shown). View labels & annotations for this node. This is handy to view metadata provided by the cloud provider.