> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rubixkube.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Infrastructure Topology

> Visualise and navigate your infrastructure with interactive topology views across Kubernetes, AWS, GCP, and VMs.

# Using Infrastructure Topology

The Infrastructure page provides an interactive, end-to-end map of your Kubernetes cluster. Use it to understand relationships between resources, assess health, and drill into details using multiple view modes.

<Frame>
  <img src="https://mintcdn.com/rubixkube/vcrcLHnsfAfdbq9A/images/platform/infrastructure-topology.png?fit=max&auto=format&n=vcrcLHnsfAfdbq9A&q=85&s=f1e3f9e2a6b2bcce68c52a611a6b12d9" alt="Infrastructure Topology with 301 resources across 13 namespaces in a force-directed graph. View toggles for Graph, Flow, Table, Tree, Dashboard, Namespace, and Dependencies." width="3600" height="2260" data-path="images/platform/infrastructure-topology.png" />

  <Caption>Infrastructure Topology. Counters for total resources, namespaces, and healthy resources, then an interactive graph you can switch between Graph, Flow, Table, Tree, Dashboard, Namespace, and Dependencies views.</Caption>
</Frame>

***

## Header and Global Controls

<Frame>
  <img src="https://mintcdn.com/rubixkube/F9pW3PHsl5PJIko8/images/using/using-infrastructure-01-header.png?fit=max&auto=format&n=F9pW3PHsl5PJIko8&q=85&s=ac4b0b3513e812a23643dac62cf403a1" alt="Infrastructure header with title and refresh" width="2756" height="170" data-path="images/using/using-infrastructure-01-header.png" />

  <Caption>Header with title, description, and Refresh action</Caption>
</Frame>

* **Title and description**: Confirms you are in Infrastructure Topology.
* **Refresh**: Re-fetches topology and metrics. Use after deployments or scaling events.

***

## Metrics Summary

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-04-metrics.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=22775267804753282816f5035b184db5" alt="Summary metrics: total resources, namespaces, healthy" width="1570" height="20" data-path="images/using/using-infrastructure-04-metrics.png" />

  <Caption>Summary metrics sourced live from the cluster</Caption>
</Frame>

* **Total Resources**: Count of all resources indexed in the current cluster view.
* **Namespaces**: Distinct namespaces represented in the current data set.
* **Healthy Resources**: Resources reporting healthy state.

***

## Controls: Search, Views, Layout

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-02-controls.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=a6f739c2d8e56a57e2efd1ff964c34ca" alt="Search, view mode buttons, and layout selector" width="2756" height="106" data-path="images/using/using-infrastructure-02-controls.png" />

  <Caption>Controls: search, view mode selector, and graph layout selector</Caption>
</Frame>

* **Search resources...**: Type names, kinds, or namespaces to filter results instantly.
* **View modes**: Graph, Flow, Table, Tree, Dashboard, Namespace, Dependencies.
* **Layout selector** (Graph view): Hierarchical, Force, Circular, Tree, Grid.
* **Clear all**: Removes active filters and resets controls.

Active filters reflect your selections in real time:

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-03-active-filters.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=fd20dc3d29e492ffe054fa833e37cc66" alt="Active filters chips" width="2756" height="42" data-path="images/using/using-infrastructure-03-active-filters.png" />

  <Caption>Active filters chips showing current selections</Caption>
</Frame>

***

## Graph View

Graph view renders resources as nodes with relationships as edges. Use it to reason about dependencies and blast radius.

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-03-graph-view.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=3b87d7d9254dcd11932eded11e834b64" alt="Graph view - hierarchical layout" width="2848" height="1706" data-path="images/using/using-infrastructure-03-graph-view.png" />

  <Caption>Graph view using the Hierarchical layout</Caption>
</Frame>

### Graph Settings

Open Graph settings to tune readability and performance for large graphs.

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-06-graph-settings.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=4c8d3b5d7127ad25c5d1ff36c0248f01" alt="Graph settings dialog" width="420" height="310" data-path="images/using/using-infrastructure-06-graph-settings.png" />

  <Caption>Graph View Settings: elasticity, labels, health status, and layout strengths</Caption>
</Frame>

### Layouts

Switch layouts to highlight different structural perspectives.

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-07-graph-force.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=4de8dd4eeeedfc420630e25309dd42cb" alt="Graph view - force layout" width="1920" height="853" data-path="images/using/using-infrastructure-07-graph-force.png" />

  <Caption>Graph view using the Force layout</Caption>
</Frame>

***

## Table View

Table view provides a sortable, scannable inventory with per-row actions.

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-05-table.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=20748bf1376a51da2a6a2520e221aca3" alt="Resource table with 26 resources" width="1553" height="1120" data-path="images/using/using-infrastructure-05-table.png" />

  <Caption>Resource Table with Name, Type, Namespace, Status, and Actions</Caption>
</Frame>

### Searching and Filtering

Use the search input to narrow to a namespace, type, or resource name.

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-08-search-kube-system.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=7b53730704c87a819207822f7f47b754" alt="Search filtered to kube-system" width="1920" height="853" data-path="images/using/using-infrastructure-08-search-kube-system.png" />

  <Caption>Search narrowed to the kube-system namespace</Caption>
</Frame>

<Frame>
  <img src="https://mintcdn.com/rubixkube/iyf5V_X1flgZnCXp/images/using/using-infrastructure-09-table-filtered-kube-system.png?fit=max&auto=format&n=iyf5V_X1flgZnCXp&q=85&s=0decb83d8dd46f725183242c50c896c3" alt="Table filtered to kube-system" width="1553" height="812" data-path="images/using/using-infrastructure-09-table-filtered-kube-system.png" />

  <Caption>Filtered table showing only kube-system and rubixkube-system resources</Caption>
</Frame>

***

## Resource Types

| Type       | Description                                   | Example            |
| ---------- | --------------------------------------------- | ------------------ |
| Node       | Kubernetes worker/control-plane node          | kind-control-plane |
| Pod        | Smallest deployable unit, containers grouped  | coredns-66bc...    |
| Deployment | Declarative set of Pods with rollout strategy | rubixkube-observer |
| ReplicaSet | Maintains a stable set of replica Pods        | ...-59f488b9df     |
| Service    | Stable virtual IP exposing a set of Pods      | kube-dns           |

***

## Common Workflows

### Investigate a service outage

1. Go to Graph view and select the Service.
2. Inspect connected Pods for degraded or failing status.
3. Switch to Table view and filter by the service's namespace to see related Deployments, ReplicaSets, and Pods.

### Validate a deployment

1. After a rollout, click Refresh.
2. In Table view, sort by Type and verify Deployment, ReplicaSet, and new Pods.
3. In Graph view, confirm edges from Service to the new Pods.

### Namespace health review

1. Filter by the target namespace.
2. Check Summary metrics and Table status column.
3. Use Graph settings to enable labels and health for quick scanning.

***

## Tips

* Prefer Hierarchical layout for large clusters; switch to Force for cluster adjacency insights.
* Hide labels for very dense graphs to improve render performance, then toggle them on when zoomed in.
* Use Clear all to quickly reset complex filter states.

***

## Next

* Continue to [Using Agents](/using/agents)

***

## Related Guides

* [Dashboard](/using/dashboard)
* [Insights](/using/insights)
* [Clusters](/using/clusters)
* [Workspace](/using/workspace)
* [Settings](/using/settings)
* [Integrations](/using/integrations)

***

## Need Help?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset">
    Email: <a href="mailto:connect@rubixkube.ai">[connect@rubixkube.ai](mailto:connect@rubixkube.ai)</a>

    <br />

    Please include your Tenant ID (Settings → Organization), timestamp, and screenshots.
  </Card>

  <Card title="Troubleshooting Guide" icon="life-ring" href="/support/troubleshooting">
    Step-by-step fixes for common issues across Dashboard, Insights, Agents, and more.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/support/faq">
    Answers to common questions about setup, RCA, agents, and docs.
  </Card>

  <Card title="Docs Navigation" icon="book" href="/getting-started/overview">
    Browse all guides to learn workflows and best practices.
  </Card>
</CardGroup>