#  Infrastructure for Kubernetes: Pods

## What are Pods?

Pods are the smallest deployable units in Kubernetes. Each pod runs one or more containers and shares network and storage resources. Kloudfuse shows the pod lifecycle, health, and usage.

## Access the pod screen

Go to **Infrastructure** \> **Kubernetes** \> **Pods**.

Pod Navigation

## Pod Table Columns

Pod Columns

Each column in the table displays key pod attributes:

1. **Cluster** – Cluster where the pod is running

2. **Namespace** – Kubernetes namespace of the pod

3. **Pod** – Unique pod name

4. **Status** – Current pod lifecycle phase:

- `Running`: Pod is active and running
   - `Pending`: Pod is scheduled but not yet running
   - `Succeeded`: Pod completed successfully
   - `CrashLoopBackOff`: Pod crashes repeatedly and Kubernetes backs off before restarting it again
   - `Failed`: Pod terminated with an error
   - `Unknown`: Pod state cannot be determined

5. **Containers**
   - **Restarts** – Number of times containers in the pod have restarted
   - **Ready** – Number of containers that passed their readiness checks
   - **Total** – Total number of containers defined in the pod
   - **% Ready** 
   - Percentage of containers that are currently ready

6. **Usage**:
   - **CPU** \- Real-time CPU usage percentage
   - **Memory** \- Real-time memory usage percentage

## Filters

Pod Filters

Use filters in the sidebar or directly in the search bar to narrow down pods by cluster, namespace, status, or labels.

- [Kubernetes Filter](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-filters/#resources)
- [Facets Filter](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-filters/#facets)
- [Additional Filter](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-filters/#additional)

## Search, group, and sort

Use the following options to refine your search view:

### 1\. Search

Use the **Search** bar to filter resources such as pods, nodes, clusters, and namespaces using key-value pairs—just like filtering logs in Kloudfuse.

- Auto-suggestions simplify input with live facet and value suggestions.

- Example:

1. Type `cluster` — autocomplete lists matching field names.
    2. Select `cluster` — a new dropdown appears with current cluster names.
    3. Choose one or more cluster names to apply the filter.

This scoped search helps you quickly locate relevant pods by matching attributes such as:

- `cluster`
   - `namespace`
   - `status`
   - `node`
   - `deployment`
   - and more.

- The search interface dynamically updates based on selected filters and maintains high responsiveness for large clusters.

Filter Behavior

- **AND logic** is applied automatically when combining filters with different keys.
- For example:

```text
kube_namespace=datadog status=Running
```

textCopied!

- Returns pods matching both conditions.

|     |     |
| --- | --- |
|  | **AND** is **implicit**. It doesn’t appear in the search bar. |

- **OR logic** appears when selecting multiple values for the same key:
- For example:

```text
kube_namespace=fluentd OR kube_namespace=datadog
```

textCopied!

- Returns pods from either `fluentd` or `datadog` namespaces.

|     |     |
| --- | --- |
|  | Selecting filters in the sidebar updates the search bar automatically.<br>Typing directly in the search bar updates the sidebar filters.<br>This two-way sync keeps your filter view consistent. |

### 2\. Group By

Group resources—such as Pods, Clusters, Namespaces, or Nodes—by shared attributes to simplify analysis and troubleshooting. Use the  icon to toggle between grouped and ungrouped views.

Common groupings include:

- **Cluster** – See how resources are distributed across clusters.
- **Namespace** – Organize by logical boundaries within the cluster.
- **Node** – Identify which node is hosting the resource.
- **Status** – Group by lifecycle status (Running, Pending, etc.)

Grouping improves visibility into resource alignment, health, and usage patterns.

### 3\. Sort

Use the  icon to sort the list by any column in ascending or descending order.

Click the column header to toggle sort direction. Use sorting to identify highest resource usage, longest-running pods, or newest deployments.

Click any row to open the pod detail pane.

Pods Detail pane

You can filter directly from visible fields in the pane, including:

- **Cluster**, **Namespace**, and **Node**
- Linked **Deployment**, **Replica Set**, and **Service**
- Pod **IP address** and **QoS Class**
- **Restart count** and **Container readiness**

All fields are clickable and filterable.

Kloudfuse includes all attached Kubernetes metadata and any custom tags. Click on any labels and tags to filter the view.

Custom tags

- `kfuse:true`
- `kube_condition_containersready:true`

Kubernetes labels

- `app_kubernetes_io_name`
- `pod_template_hash`
- `kube_app_instance`
- `kube_cluster_name`

Each pod view includes multiple tabs for deeper observability. The pod detail pane contains four tabs. These include:

- [**YAML**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-pods/#yaml)
- [**Logs**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-pods/#logs)
- [**Metrics**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-pods/#metrics)
- [**Events**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-pods/#events)

## YAML

Use the **YAML** tab to inspect the live configuration of your Kubernetes resource.

YAML Display pane

- View full manifest details for pods, deployments, nodes, etc.
- Quickly detect misconfigurations or missing annotations.
- Copy YAML for debugging or backup purposes.

## Logs

Use the **Logs** tab to inspect real-time application and system logs for a selected Kubernetes resource.

Logs Display pane

- Select specific containers to view logs at a granular level.

Log search supports full-text match, tag selection, and time-range filters.

## Metrics

The **Metrics** tab displays real-time CPU, memory, network, and disk usage for the selected resource.

Metrics Display pane

- Visualize container-level metrics and trends.
- Correlate spikes or anomalies with logs or events.
- Use chart time selectors to view metrics at different intervals (e.g., last 5m, 1h, 24h).

## Events

Use the **Events** tab to view scheduled updates, restarts, warnings, or failed operations for a Kubernetes resource.

Events Display pane

- Events include timestamps and source controllers.
- Use this tab to diagnose readiness failures, scaling issues, or resource evictions.
- Combine with Logs and Metric for faster RCA.