#  Infrastructure for Kubernetes: Nodes

## What are Nodes?

Nodes are the worker machines in a Kubernetes cluster. Each node runs container workloads and includes components like the container runtime, kubelet, and kube-proxy.

In Kloudfuse, the **Nodes** screen helps you monitor the health, capacity, and performance of all Kubernetes nodes. Use it to check CPU and memory usage, scheduling status, roles, and node-level failures.

## Access the nodes screen

Go to **Infrastructure** > **Kubernetes** > **Nodes**.

## Node Table Columns

Each column in the table displays key node attributes:

1. **Cluster** – Cluster where the node is deployed
2. **Node** – Unique name of the node
3. **Status** – Node condition indicators:
    - `Ready`: Node is healthy and accepting workloads
    - `NotReady`: Node is unreachable or unhealthy
    - `Unknown`: Node state cannot be determined
4. **Schedulable** – Indicates whether the node is currently accepting new pods (cordoned or not)
5. **Age** – Time since the node joined the cluster
6. **Kubelet Version** – Version of the kubelet process running on the node
7. **Roles** – Node roles such as `control-plane`, `worker`, or `infra`
8. **CPU**
    - **Total** – Total number of CPU cores on the node
    - **Allocable** – CPU capacity available for scheduling pods
    - **Used** – Real-time CPU usage by active workloads
9. **Memory**
    - **Total** – Total memory capacity on the node (GiB)
    - **Allocable** – Memory available to pods after system reservations
    - **Used** – Real-time memory consumption by pods and system processes

## Filters

Kloudfuse provides three categories of filters to scope your results precisely.

- [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
    ```

- 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
    ```

- 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 node detail pane.

Node 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 node view includes multiple tabs for deeper observability. The node detail pane contains four tabs. These include:
- [**YAML**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-nodes/#cluster-yaml)
- [**Logs**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-nodes/#cluster-logs)
- [**Metrics**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-nodes/#cluster-metrics)
- [**Events**](https://docs.kloudfuse.com/platform/3.4.0.p1/infrastructure-kubernetes-nodes/#cluster-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 Metrics for faster RCA.