MapleTechLabs/maple

这是什么？

核心功能

• 01通过标准 OTLP 接收 Traces、日志和指标，无需厂商 Agent。
• 02Trace 瀑布图和服务拓扑图展示每个 Span 和依赖边的请求、错误与延迟。
• 03日志支持分面搜索，并可直接跳转到产生该日志的 Trace。
• 04错误问题可分配、解决，并可设置告警。
• 05告警规则可通知 PagerDuty、Discord、Telegram、邮件或 Webhook。
• 06浏览器会话回放，用于排查慢请求或前端错误。
• 07托管 MCP 服务，供编程 Agent 查询遥测数据。

适用场景

• 在一个工具里串联 Traces、日志和指标，排查慢请求或异常服务。
• 在自有基础设施上用 ClickHouse 自托管可观测性平台。
• 让 Claude Code、Cursor 等编程 Agent 在调试时读取线上遥测数据。
• 部署前用单个二进制文件在本地验证 OpenTelemetry 埋点。

快速上手

1. 1

   用 Homebrew 安装 maple 命令行工具

   brew install Makisuo/tap/maple
2. 2

   在本机启动 Maple（OTLP 接收端口 4318，内置 ClickHouse 和控制面板）

   maple start

使用前须知

• !README 未明确说明开源许可证，检测结果为 NOASSERTION。
• !完整自托管较复杂，依赖 Cloudflare、Clerk、Infisical 和 Postgres 的配置。
• !从源码开发需要 Bun 1.3 或更高版本，并需配置多个环境变量。

收录于专题

标签

常见问题

maple 是什么？

基于 OpenTelemetry 和 ClickHouse 的开源可观测性平台，统一处理 Traces、日志和指标。 Maple 是一个可观测性平台，通过 OpenTelemetry 协议（OTLP）接收 Traces、日志和指标，并存储在 ClickHouse 中。任何 OTLP 导出器或 Collector 都能直接把数据发送过来，无需专有 Agent 或厂商 SDK。Trace 瀑布图、日志搜索、指标浏览和仪表盘共享同一套过滤条件和时间范围。

maple 可以免费使用吗？用的什么许可证？

maple 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

maple 还在维护吗？

活跃维护中。maple 最近一次提交是在 2026年11月6日。

maple 适合用来做什么？

在一个工具里串联 Traces、日志和指标，排查慢请求或异常服务。 在自有基础设施上用 ClickHouse 自托管可观测性平台。 让 Claude Code、Cursor 等编程 Agent 在调试时读取线上遥测数据。 部署前用单个二进制文件在本地验证 OpenTelemetry 埋点。

maple 怎么安装和运行？

用 Homebrew 安装 maple 命令行工具: brew install Makisuo/tap/maple 在本机启动 Maple（OTLP 接收端口 4318，内置 ClickHouse 和控制面板）: maple start

在哪里获取 maple？

源代码和安装说明在 GitHub 上：https://github.com/MapleTechLabs/maple