Telescope:653⭐的新兴 Web 日志查看器,支持 ClickHouse 和 Kubernetes
简介
Telescope 是一个新兴的开源日志查看工具,专注于为开发者和运维人员提供简洁高效的日志浏览体验。与臃肿的企业级日志平台不同,Telescope 的设计理念是轻量、快速、易部署——它采用 Python + Vue.js 技术栈,以单页应用的形式提供流畅的日志检索和过滤功能。
项目概览
| 属性 | 内容 |
|---|---|
| GitHub | iamtelescope/telescope |
| Stars | 653 |
| 语言 | Python (后端) + Vue.js (前端) |
| 许可证 | MIT |
| 主要场景 | 日志查看、可观测性、故障排查 |
| 最后更新 | 2 天前 |
解决的问题
在日志管理领域,开发者常常面临两难选择:
- SaaS 方案太贵 —— Datadog、Splunk 等功能强大但价格不菲,小团队难以承受
- 开源方案太重 —— ELK 栈、Grafana Loki 等虽然免费,但部署和运维成本高
- 自建脚本太简陋 —— 用 grep/awk 处理日志效率低,且无法多人协作
Telescope 试图填补这个空白:提供一个足够简单、可以快速部署的日志查看器,同时保持现代 Web 应用的交互体验。
核心特性
多源支持
Telescope 目前支持三种日志数据源:
- ClickHouse —— 高性能列式数据库,适合存储海量结构化日志
- Kubernetes —— 直接读取 Pod 日志,无需额外配置
- Docker —— 实时查看容器日志流
技术亮点
| 特性 | 说明 |
|---|---|
| 自托管 | 完全开源,数据不落第三方 |
| 轻量级 | 单进程运行,资源占用极低 |
| 实时流 | 支持实时日志推送,类似 tail -f |
| 过滤检索 | 支持字段过滤、全文搜索 |
| 时间范围 | 快速选择预设时间范围或自定义区间 |
项目架构
┌─────────────────┐
│ Vue.js SPA │ ← 前端界面
│ (用户交互层) │
└────────┬────────┘
│ API 请求
┌────────▼────────┐
│ Django API │ ← 后端服务
│ (Python 3.11+) │
└────────┬────────┘
│ 查询
┌────────┴────────┐
│ ClickHouse / │
│ K8s API / │ ← 数据源
│ Docker Daemon │
└─────────────────┘
适用场景
Telescope 特别适合以下场景:
- 中小团队 —— 需要一个简单可用的日志查看方案,不想投入大量运维成本
- 开发调试 —— 本地或测试环境快速查看应用日志
- ClickHouse 用户 —— 已有日志存入 ClickHouse,需要一个轻量级查询界面
- 边缘部署 —— 资源受限环境,无法运行完整的 ELK 栈
使用体验
部署 Telescope 非常简单,官方提供 Docker Compose 一键启动:
git clone https://github.com/iamtelescope/telescope.git
cd telescope
docker-compose up -d
前端界面采用现代化的深色主题,布局清晰:左侧是数据源切换和过滤器,右侧是日志内容区。日志条目支持展开查看完整 JSON,时间戳会自动转换为本地时区。
同类对比
| 工具 | Stars | 定位 | 特点 |
|---|---|---|---|
| Telescope | 653 | 轻量日志查看器 | 简单、自托管、支持 ClickHouse |
| Dozzle | 12k+ | Docker 日志查看 | 专注 Docker,Web 界面 |
| GoAccess | 20k+ | 日志分析器 | 实时 Web 分析报表 |
| hl | 2.9k+ | 命令行日志处理器 | Rust 编写,高性能 |
Telescope 的优势在于其多数据源支持和对现代可观测性栈的适配,尤其是 ClickHouse 的原生集成。
发展前景
作为一个 2024 年底才创建的新项目,Telescope 展现了不错的发展势头:
- 代码更新频繁,维护活跃
- Issue 响应及时,社区氛围友好
- 技术栈选型现代(Python 3.11+、Vue 3、Vite)
未来值得关注的方向包括:更多数据源支持(如 Elasticsearch、Loki)、告警规则配置、以及日志可视化图表等。
总结
Telescope 是一个值得关注的新兴工具,它准确把握了中小团队在日志查看方面的痛点——既不想为 SaaS 付费,又不愿维护复杂的开源方案。如果你正在使用 ClickHouse 存储日志,或者需要一个轻量级的 Kubernetes 日志查看器,Telescope 值得一试。
项目地址:https://github.com/iamtelescope/telescope
官网:https://iamtelescope.net