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

# Dashboard

> Your fleet at a glance - a world map of every cluster, health rollups, and cost summaries on a single screen.

The Dashboard is the landing page for an organisation. It rolls up every cluster you manage into a single view: a geographic world map, a health summary of the issues that need attention, and a cost overview across your providers.

<Note>
  The Dashboard is organisation-scoped. It only shows clusters in the organisation you currently have selected - switch organisations from the top-left selector (or with the [CLI `--org` flag](/integrations/ankra-cli)) to see a different fleet.
</Note>

***

## Fleet world map

The world map plots each cluster at its real geographic location, so you can see where your workloads run across regions and providers at a glance.

Ankra locates a cluster from one of two sources, in priority order:

<CardGroup cols={2}>
  <Card title="Cloud region" icon="cloud">
    For clusters on a known provider, the region is read from the node labels
    (`topology.kubernetes.io/region`) and mapped to coordinates. This is the
    most precise source and is used whenever available.
  </Card>

  <Card title="GeoIP" icon="location-dot">
    When no region label is present, Ankra falls back to the cluster's public
    egress IP - reported by the agent - and resolves it to an approximate
    city/country. Locations from this source are marked as approximate.
  </Card>
</CardGroup>

### Clusters that don't appear on the map

A cluster is listed as *unlocated* (shown in a separate list rather than on the map) when neither source resolves:

| Reason            | Meaning                                                                      | How to fix                                                                                           |
| ----------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `no_region_label` | The cluster's nodes carry no region label and no GeoIP location is available | Enable public IP reporting on the agent (see below), or wait for node sync to populate region labels |
| `unknown_region`  | The node has a region label, but Ankra has no coordinates mapped for it      | The cluster still works normally; only the map pin is missing                                        |

<Tip>
  To place imported clusters that run in private networks (no recognisable cloud region) on the map, enable public IP reporting on the agent with the Helm value `--set public_ip.reporting_enabled=true`. See [Cluster Agent](/concepts/cluster-agent#fleet-world-map-public-ip-reporting) for the full configuration.
</Tip>

Draft clusters are never shown on the map - only fully imported, non-deleted clusters appear.

***

## Health summary

The Dashboard surfaces the most pressing issues across the fleet so you can triage from one place: offline clusters, failed reconciles, and unhealthy add-ons bubble to the top. Open a cluster from the summary to jump straight into its detail view, or ask the [AI Assistant](/platform/ai-assistant) to investigate.

For a deeper look at how Ankra classifies cluster status, see [Cluster States](/concepts/cluster-states).

***

## Cost overview

The Dashboard includes a fleet-wide cost rollup - estimated monthly spend, month-to-date, and a projected month-end total, broken down by provider and by top-spending cluster. This is the same data covered in detail on the [Cloud Cost](/platform/cloud-cost) page.

***

## API

The Dashboard is backed by read-only organisation endpoints:

| Method | Path                             | Purpose                                                   |
| ------ | -------------------------------- | --------------------------------------------------------- |
| `GET`  | `/org/dashboard/fleet-locations` | Located + unlocated clusters for the world map            |
| `GET`  | `/org/dashboard/health`          | Health summary (use `?max_issues=` to cap the list, 1-50) |
| `GET`  | `/org/cloud-cost/summary`        | Fleet cost rollup                                         |

See the [API Reference](/api-reference/introduction) for request and response schemas.