> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Observability

> Landing page for the Observability use case guide

export const CloudNotSupportedBadge = () => {
  return <a href="https://clickhouse.com/docs/products/cloud/guides/cloud-compatibility#list-of-unsupported-features" className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            Not supported in ClickHouse Cloud
        </a>;
};

ClickHouse offers unmatched speed, scale, and cost-efficiency for observability. This guide provides two paths depending on your needs:

<h2 id="clickstack">
  ClickStack - the ClickHouse observability stack
</h2>

The ClickHouse Observability Stack is our **recommended approach** for most users.

**ClickStack** is a production-grade observability platform built on ClickHouse and OpenTelemetry (OTel), unifying logs, traces, metrics and session in a single high-performance scalable solution that works from single-node deployments to **multi-petabyte** scale.

| Section                                                | Description                                     |
| ------------------------------------------------------ | ----------------------------------------------- |
| [Overview](/clickstack/overview)                       | Introduction to ClickStack and its key features |
| [Getting Started](/clickstack/getting-started/index)   | Quick start guide and basic setup instructions  |
| [Example Datasets](/clickstack/example-datasets/index) | Sample datasets and use cases                   |
| [Architecture](/clickstack/architecture)               | System architecture and components overview     |
| [Deployment](/clickstack/deployment/overview)          | Deployment guides and options                   |
| [Configuration](/clickstack/managing/config)           | Detailed configuration options and settings     |
| [Ingesting Data](/clickstack/ingesting-data/index)     | Guidelines for ingesting data to ClickStack     |
| [Search](/clickstack/features/search)                  | How to search and query your observability data |
| [Production](/clickstack/managing/production)          | Best practices for production deployment        |

<h2 id="build-your-own-stack">
  Build-your-own stack
</h2>

For users with **custom requirements** — such as highly specialized ingestion pipelines, schema designs, or extreme scaling needs — we provide guidance to build a custom observability stack with ClickHouse as the core database.

| Page                                                                                                  | Description                                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Introduction](/guides/use-cases/observability/build-your-own/introduction)                           | This guide is designed for if you're looking to build your own observability solution using ClickHouse, focusing on logs and traces.                                |
| [Schema design](/guides/use-cases/observability/build-your-own/schema-design)                         | Learn why users are recommended to create their own schema for logs and traces, along with some best practices for doing so.                                        |
| [Managing data](/guides/use-cases/observability/build-your-own/managing-data)                         | Deployments of ClickHouse for observability invariably involve large datasets, which need to be managed. ClickHouse offers features to assist with data management. |
| [Integrating OpenTelemetry](/guides/use-cases/observability/build-your-own/integrating-opentelemetry) | Collecting and exporting logs and traces using OpenTelemetry with ClickHouse.                                                                                       |
| [Using Visualization Tools](/guides/use-cases/observability/build-your-own/grafana)                   | Learn how to use observability visualization tools for ClickHouse, including HyperDX and Grafana.                                                                   |
| [Demo Application](/guides/use-cases/observability/build-your-own/demo-application)                   | Explore the OpenTelemetry demo application forked to work with ClickHouse for logs and traces.                                                                      |

<h2 id="prometheus-metrics">
  Prometheus metrics
</h2>

<CloudNotSupportedBadge />

ClickHouse can store Prometheus metrics in a [`TimeSeries`](/reference/engines/table-engines/integrations/time-series) table and evaluate PromQL queries. See [Prometheus protocols and PromQL](/concepts/features/interfaces/prometheus) for ingestion, query, and visualization configuration.