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

# Storage

> Monitoring telemetry storage usage across tiers.

The Storage page shows how much telemetry data your deployment is storing, broken down by tier. This page requires the **view audit** permission; editing lifecycle policies requires the **manage storage** permission.

***

## Summary

The top of the page shows three hero metrics:

* **Used storage** — total storage consumed across all tiers.
* **Capacity used / Hot tier used** — how much of the fast-access layer is in use.
* **Daily growth** — the average daily increase in storage consumption.

Below the hero metrics, a secondary **tier strip** shows the hot/cold storage split at a glance.

***

## Time range

A time range selector lets you view storage trends over different windows: **24h**, **7d**, or **30d**.

***

## Storage by tier

A snapshot bar chart titled **Storage by tier** showing the current footprint across four tiers:

* **Hot** — data in the fast-access layer (ClickHouse), used for real-time queries and dashboards.
* **Cold** — data archived to object storage (S3) for long-term retention at lower cost.
* **Postgres** — data stored in PostgreSQL (user accounts, teams, configuration, audit log).
* **Cloud (managed)** — data held in managed cloud storage services within your account.

***

## Usage by tier

A collapsible per-table breakdown of storage consumption. Each dataset entry shows:

* **Size** — the amount of storage the dataset occupies.
* **Retention** — the configured retention period for that dataset.
* **Compression** — the compression ratio or algorithm in use.

Expand a dataset to view or edit its lifecycle policy.

### Lifecycle policy

Lifecycle policies are edited via an **inline accordion** — expand the dataset row and adjust retention, compression, or tier-migration settings in place. There is no separate side drawer.

* **Viewing** a lifecycle policy requires the **`view_audit`** permission.
* **Editing** a lifecycle policy requires the **`manage_storage`** permission.
* Users with read-only access can view policies but cannot change them.

***

## Insights

Automated recommendations based on your storage patterns — for example, datasets with low query frequency that could benefit from shorter hot-tier retention, or unusually high growth rates worth investigating.

This section also includes **Hot → cold transfers** as a time-series view, showing how data moves from the hot tier to cold storage over time.

***

## Connectivity

A live indicator shows whether the storage health endpoint is reachable. If the connection drops or data becomes stale, a banner appears with a retry option.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.