架构

The ClickStack architecture is built around three core components: ClickHouse, HyperDX, and a OpenTelemetry (OTel) collector. A MongoDB instance provides storage for the application state. Together, they provide a high-performance, open-source observability stack optimized for logs, metrics, and traces.

Architecture Overview

ClickHouse: The database engine

在 ClickStack 的核心是 ClickHouse，一个专为实时分析而设计的列式数据库。它支持观察数据的摄取和查询，使得：

• 在数 TB 事件中进行亚秒级搜索
• 每天摄取数十亿高基数记录
• 在观察数据上实现至少 10 倍的高压缩率
• 原生支持半结构化 JSON 数据，允许动态模式演变
• 拥有数百个内置分析函数的强大 SQL 引擎

ClickHouse 将观察数据处理为宽事件，允许在单一统一结构中深入关联日志、指标和追踪。

OpenTelemetry collector: data ingestion

ClickStack 包含一个预配置的 OpenTelemetry (OTel) 收集器，以开放且标准化的方式摄取遥测数据。用户可以通过以下方式使用 OTLP 协议发送数据：

• gRPC（端口 4317）
• HTTP（端口 4318）

收集器以高效批量方式将遥测数据导出到 ClickHouse。它支持每个数据源的优化表模式，确保所有信号类型的可伸缩性能。

HyperDX: The interface

HyperDX 是 ClickStack 的用户界面。它提供：

• 自然语言和 Lucene 风格的搜索
• 实时调试的实时尾部跟踪
• 日志、指标和追踪的统一视图
• 前端可观察性的会话重放
• 仪表板创建和警报配置
• 用于高级分析的 SQL 查询接口

HyperDX 专为 ClickHouse 设计，将强大的搜索与直观的工作流程结合在一起，使用户能够快速发现异常、调查问题及获得洞察。

MongoDB: application state

ClickStack 使用 MongoDB 存储应用级状态，包括：

• 仪表板
• 警报
• 用户配置文件
• 已保存的可视化

这种将状态与事件数据分开的设计确保了性能和可扩展性，同时简化了备份和配置。

这种模块化架构使 ClickStack 能够提供一个开箱即用的可观察性平台，快速、灵活且开源。