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

# Observability

> Landing page for the Observability use case guide

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.                                                                      |