Overview

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.

Main View

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. Activity Tabs. The application tab allows you to view main Kubernetes workloads including CronJob/Job, DaemonSet Deployment, Pods, and StatefulSet. The all resources tab allows you to view all the resources in the cluster or per namespace if a namespace is selected on the left-hand bar.

3. Search Bar. In the search bar, you will be able to search for different Kubernetes resources by its name or namespace.

4. Browse. In this view, Infra App will display everything in the Kubernetes cluster based on Applications (workloads) or All Resources. To filter for particular namespaces, please select a namespace from the left hand bar.

5. Utilization. The utilization page displays the health of the cluster including a summary of CPU / Memory usage/requests/limits for the whole cluster and individual nodes.

6. Resource View. This section displays a summary of the Kubernetes resources based on the filters selected.

Resource Detail

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

   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 resource -- such as volumes, endpoints, controllers, and more.

   3. YAML tab. YAML tab will show you the YAML file used to set-up the resource with the ability to edit.

2. Resource Status. Resource status shows the current status of the resource as reported by Kubernetes.

3. Overview. Here you will find the kind of the resource, the namespace it's associated with, its age, the labels attached to the workload, and the image(s) the resource 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 or via right-click, 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 resource, the ingress rules will show up here.

   3. Config Maps. For resources with a configuration map, you'll be able to view it in this section.

   4. Persistent Volume Claims. Infra App will show any related Persistent volume claims.

Utilization

1. Overview. High-level details about the cluster, including the total number of node and pods with its 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 its detail, 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 or limits.

Node Detail

1. Activity Tab. You can use the activity tabs to switch between Overview, Events, and YAML for the particular node.

2. Node Status. Tells you if this node is running and accepting resources.

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

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

5. 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.

6. Detail. View labels & annotations for this node. This is handy to view metadata provided by the cloud provider.