Skip to main content

Tenant Overview

The Tenant Overview page consolidates Tenant health, fleet capacity, and Tenant-namespace resources into a single read-only view for Tenant admins. Use it to confirm a Tenant is ready, review how compute is distributed across Projects, navigate to Tenant-scoped resources, and reach common Tenant tasks from one place. The page refreshes every 30 seconds, so cards, fleet metrics, resource lists, and status conditions update in place without a manual reload.

For details on how Tenants relate to Projects, refer to Tenants and Projects. To edit any value displayed on this page, refer to Create and Manage Tenant Settings.

Prerequisites​

  • At least one Project exists in the Tenant, and your OpenID Connect (OIDC) group is listed in that Project's role mapping. Tenant visibility in the PaletteAI UI is derived from Project access. For details, refer to Tenant Visibility.

  • To use the Create Project and resource-list create actions, you must have the matching Project or AI workload create permission. Buttons that require a permission you do not have are hidden. For details, refer to Tenant Role Permissions.

General Details Card​

The General details card summarizes the Tenant identity in two columns. All values are read-only on this page.

FieldWhat it shows
Tenant nameThe Tenant display name, or the Tenant resource name if no display name is set.
StatusTenant readiness, displayed as a badge. Ready means the Tenant is provisioned and available. Not Ready means one or more status conditions have not yet succeeded. Deleting means a delete request has been issued for the Tenant and removal is in progress.
DescriptionThe Tenant description, or - if none is set.
Created AtThe date and time the Tenant was created, formatted in the en-US locale.
ProjectsThe number of Projects in the Tenant. Select [View all] to open the Projects list.
Settings RefThe name of the integration referenced at the Tenant level, or - if none is set. Select the link to open the Settings Ref tab on the Tenant Settings page.

If the Tenant has labels, they appear as key:value chips below the two columns. Annotations are not surfaced on this card; use Create and Manage Tenant Settings to view or edit them.

Quick Actions Card​

The Quick Actions card is a launcher for four common Tenant tasks. Create Project is hidden when you lack the Project create permission or the Tenant is in the Deleting state; the other three actions always appear.

  • Create Project opens the Project creation flow.

  • View All Projects opens the Projects list for the Tenant.

  • View Tenant Settings opens the Tenant Settings page. Refer to Create and Manage Tenant Settings for the available tabs.

  • Create and Manage Tenants opens the Tenant selection page. Tenants are created from the command line; refer to Create and Manage Tenants for the procedure.

Metrics Dashboard Card​

The Metrics Dashboard card appears only when an administrator has set the global.metrics.grafanaUrl Helm value. When the URL is set, select Open Grafana Dashboard to open the Grafana instance in a new tab.

To configure the Grafana URL, refer to Prometheus Agent Setup.

Fleet Overview​

The Fleet Overview section aggregates compute capacity across the Tenant and presents it as five metric cards: Total Nodes, Total CPUs, Total GPUs, Total Memory, and Total GPU Memory. Each card breaks the total into In use, Unavailable, and Free segments.

Scope Selector​

The Scope selector at the top of the section controls which compute the metric cards aggregate. The selector groups options by type:

  • All scopes combines compute from the Tenant namespace and from every Project in the Tenant. Nodes that appear in more than one scope are counted once, by host ID.

  • Tenant restricts the view to compute that lives in the Tenant namespace.

  • Projects lists each Project in the Tenant. Selecting a Project shows that Project's compute only; the Unavailable segment then represents compute used by the Tenant or by other Projects.

The selector defaults to All scopes.

Details Drawer​

The View Details button opens the Fleet Overview drawer. The drawer breaks down the selected scope by Compute Pool and shows per-host capacity.

Tenant Resource Lists​

Three side-by-side sections summarize Tenant-namespace resources: Tenant Compute Pools, Tenant App deployments, and Tenant Model deployments. The sections list resources that live in the Tenant namespace only. Resources owned by Projects appear in their respective Project Overview pages instead.

Each section shows up to five rows. Every row lists the resource name, a status badge, and the creation date. The section header includes a count badge and a View All link. Until Tenant-scoped deployment views are available, all three View All links open the Projects list for the Tenant; from there, open a Project to display its resources.

When a section has no resources to display, select Create an app deployment or Create a model deployment. Until Tenant-scoped deployments are supported, both links open the Projects list for the Tenant so you can choose a Project to create the resource in. The Compute Pools section does not expose a create action on this page; create Compute Pools from a Project's Compute Pools list instead.

Status Conditions​

Expand the Status section at the bottom of the page to display a table with one row per condition.

ColumnSource
TypeThe condition type.
MessageThe condition message. Hover the message to display the full text when truncated.
Last UpdatedTimestamp of last update.
StatusCan be either Active or Inactive.

The PaletteAI controllers report standard condition types such as the following:

  • SettingsConfigured — The Tenant's integration is configured and ready. Shows Inactive when the integration is missing or not yet ready.

  • TenantNamespaceCreated — The Tenant namespace was created successfully. Shows Inactive when namespace creation fails, for example because of admission webhooks, conflicting ownership, or Pod Security Admission policy.

  • TenantNotOversubscribed — Tenant GPU usage is within the limits set on the Tenant Settings. Shows Inactive in two cases:

    • Tenant-wide usage exceeds the configured GPU limit, which blocks new Project workloads.

    • Tenant-namespace usage exceeds the Tenant reservation, which is informational and does not block Projects.

  • ChildProjectCount — Reports the number of Projects in the Tenant, for example Tenant has 1 child projects. Shows Inactive when the controller cannot enumerate Projects.

  • DefaultComputeReady — The default Compute resource is provisioned and ready. Shows Inactive when the Compute resource is not yet ready or its creation failed.

Next Steps​