Skip to main content

​
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)
Run it first whenever something feels off elsewhere in OpenMetadata — a stuck ingestion pipeline or missing search results often trace back to one of these checks failing. To check platform health, follow the steps below:
  1. Navigate to Settings > Preferences > Health Check. Health Check panel
  2. Review the status of each check: Infrastructure
    • Database: Connectivity to the metadata database.
    • Search Instance: Connectivity to the search/index cluster.
    • Migrations: That all expected schema migrations have run.
    Search
    • Search Reindex Status: That every deployed search index was built from the current index mapping, so no reindex is pending.
    • Semantic Search: That the embeddings used for semantic search are working, shown only when semantic search is enabled.
    External dependencies
    • Pipeline Service Client: Connectivity to the ingestion pipeline service.
    • JWKs: That the configured JWKS (JSON Web Key Set) validates correctly.
    • Log Storage: Connectivity to S3 log storage, shown only when S3 storage is configured.
    Health Check status for each dependency
  3. Click Refresh to re-run all checks after fixing a reported issue.