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

# Health Check

> Check the live status of the database, search index, migrations, and related platform dependencies.

# Health Check

Health Check is a read-only diagnostics panel, not a form you fill in. It reports, in real time, whether the platform's core dependencies are reachable and correctly configured:

* **Infrastructure**: Database, search index, schema migrations
* **Search**: Search reindex status, semantic search embeddings (when enabled)
* **External dependencies**: Authentication keys, ingestion service, log storage (when configured), object storage
* **Collate AI**: AI Platform, NLQ Hybrid Search (reports as disabled when not configured)

Run it first whenever something feels off elsewhere in Collate. A stuck ingestion pipeline or missing search results often trace back to one of these checks failing.

**Purpose and Benefits**

* **Purpose**: Check live status of the platform's core dependencies, such as the database and search index.
* **Benefits**: Gives you one place to look before troubleshooting an issue anywhere else.

## How to Check

To check platform health, follow the steps below:

1. Click the **Profile** icon and navigate to **Settings** > **Preferences** > **Health Check**.

   <img src="https://mintcdn.com/collatedocs/WV0oBDGC-df5gLwn/public/images/ai-2.0/admin-guide/preferences/access-health.png?fit=max&auto=format&n=WV0oBDGC-df5gLwn&q=85&s=8fac54a7edf2a7632f5d502a68b7e783" alt="Health Check panel" width="3014" height="1594" data-path="public/images/ai-2.0/admin-guide/preferences/access-health.png" />

2. Review the status of each check:

   **Infrastructure**

   * **Database**: Connectivity to the metadata database. If this fails, nothing in Collate can read or write metadata.
   * **Search Instance**: Connectivity to the search/index cluster. If this fails, search, discovery, and lineage graphs stop returning results.
   * **Migrations**: That all expected schema migrations have run. An incomplete migration can cause unpredictable errors elsewhere until it's resolved.

   **Search**

   * **Search Reindex Status**: That every deployed search index was built from the current index mapping, so no reindex is pending. A pending reindex means some assets may not appear in search until it completes.
   * **Semantic Search**: That the embeddings used for semantic search are working, shown only when semantic search is enabled. If this fails, natural-language search falls back to keyword matching.

   **External dependencies**

   * **Pipeline Service Client**: Connectivity to the ingestion pipeline service. If this fails, no ingestion or profiler workflow can be triggered.
   * **JWKs**: That the configured JWKS (JSON Web Key Set) validates correctly. If this fails, token-based authentication can break for some or all users.
   * **Log Storage**: Connectivity to S3 log storage, shown only when S3 storage is configured. If this fails, ingestion runner logs aren't retrievable from the UI.
   * **Object Storage**: Connectivity to object storage used for uploaded file content, for example Context Center Drive. If this fails, uploaded files become unreachable.

   **Collate AI**

   * **AI Platform**: That the AI Platform powering Collate AI and AI Agents is reachable. If this fails, Collate AI features and AI Agents stop working.
   * **NLQ Hybrid Search**: That natural language search's LLM-backed filter extraction is configured and initialized. Always shown, and reports as failed with an "NLQ Hybrid Search is not enabled" message when the feature is off.

   <img src="https://mintcdn.com/collatedocs/WV0oBDGC-df5gLwn/public/images/ai-2.0/admin-guide/preferences/review-health.png?fit=max&auto=format&n=WV0oBDGC-df5gLwn&q=85&s=4dabcd48e42ec43823912c87d07e3c74" alt="Health Check results" width="2852" height="1556" data-path="public/images/ai-2.0/admin-guide/preferences/review-health.png" />

3. Click **Refresh** to re-run all checks after fixing a reported issue.
